0055 format de presentation des verdicts du comite d experts
ADR-55 — Format de présentation des verdicts du comité d'experts¶
Statut : Décidé (2026-04-10)
Contexte : Les verdicts du comité d'experts sont utilisés comme base de décisions d'architecture. Sans format standardisé, les présentations omettent des informations critiques pour l'audit et la reproductibilité : la question posée, les artefacts soumis, le coût du comité. L'absence de ces données rend les décisions non-traçables.
Décision : Tout verdict de comité présenté dans une issue, un ADR, ou une communication doit suivre un format standardisé incluant le contexte complet, les coûts et les liens vers les artefacts.
Invariants :
- Question : le verdict DOIT toujours reprendre la question exacte posée au comité (verbatim, pas résumée)
- Artefact : le verdict DOIT inclure un lien ou chemin vers l'artefact fourni au comité (artifact_path du JSON session)
- FinOps : le verdict DOIT préciser le coût du comité et la consommation de tokens :
- Tokens totaux (prompt + completion)
- Coût estimé ($)
- Nombre d'appels LLM
- Modèles utilisés
- Issue ref : le verdict DOIT porter l'issue_ref (ADR-52)
- Session ID : pour retrouver le JSON complet dans committee/sessions/
Format standard :
### Comité d'experts — [titre court]
**Question** : [question verbatim]
**Artefact** : [chemin ou lien]
**Issue** : #NNN
**Session** : {session_id}
**FinOps** : {total_tokens} tokens, ${cost} ({n_calls} appels, {models})
**Verdict** : {status} | {code}
**Consensus** : {consensus_strength}
**Reason** : [one-liner]
| Expert | Score | Consensus | G/M |
|--------|-------|-----------|-----|
| ... | ... | ... | ... |
Fichiers concernés : scripts/expert_committee.py, committee/AUDIT_LOG.md, documentation/ADR.md