Fichiers SR principaux
Les fichiers qui portent la reprise, le backlog et les contrôles SR.
Fichiers SR principaux
Une fois SR installée dans un repo, certains fichiers deviennent les sources de reprise et de contrôle.
| Fichier | Rôle pratique |
|---|---|
AGENTS.md | Instructions que Codex doit suivre dans le repo. |
docs/CURRENT_STATE.md | État court du produit et prochaine action sûre. |
docs/codex/PROJECT_PROFILE.yaml | Profil projet : mode connaissance, politique skills, obligations SR. |
docs/codex/SKILL_DIGEST.md | Routeur court pour choisir les skills sans tout charger. |
docs/codex/SKILL_MAP.md | Déclaration plus complète des skills disponibles. |
docs/codex/SR_LOTS.yaml | Backlog vivant des lots SR. |
docs/codex/SR_PASSES.yaml | Orchestration optionnelle de plusieurs lots en passes bornées. |
docs/codex/SR_INBOX.yaml | Boîte d'entrée des idées, bugs, retours et décisions à trier. |
docs/codex/CODEBASE_MAP.md | Carte courte du codebase. |
docs/codex/tasks/... | Mémoire détaillée des lots et tâches. |
scripts/codex/ | Scripts de vérification, audit, contexte et contrats. |
Lots et passes
SR_LOTS.yaml reste la source de vérité du backlog atomique. Chaque lot porte son périmètre, ses critères d'acceptation, ses chemins autorisés, ses stop conditions et son statut.
SR_PASSES.yaml sert uniquement à organiser l'exécution de plusieurs lots liés. Il décrit les lots inclus, l'ordre, les dépendances, le preflight commun, les validations humaines, les actions externes, les migrations éventuelles et les tests E2E groupés.
Le prompt docs/codex/prompts/08_define_sr_passes_from_lots.md permet de proposer ou mettre à jour ces passes depuis les lots existants. Le script scripts/codex/validate_pass_contract.py vérifie que les références de lots et l'ordre des dépendances sont cohérents.
Si vous êtes perdu
Demandez à Codex de relire dans cet ordre :
AGENTS.md
docs/CURRENT_STATE.md
docs/codex/SR_BOOTSTRAP.md
docs/codex/SR_LOTS.yaml
docs/codex/SR_PASSES.yaml
dernière mémoire dans docs/codex/tasks/Important
Ces fichiers ne remplacent pas la lecture du code réel. Ils orientent Codex, mais le code, les tests et les logs tranchent.