[DTP-Worker 20260802_103535] Sprint 8 · buffer · Dérive doc-vs-réalité : 11 fiches AGENT.md citaient un canal handoffs/ inexistant → correction vers le hand-off RÉEL (livrables out/ commités)

Bloc « Communication inter-agents » (boilerplate identique ×11) promettait
`05_deliverables_mvp/handoffs/` : répertoire inexistant (0 fichier, 0 consommateur,
0 gate). Échappé à check_docs.sh car chemin en code-span backtick (neutralisé l.28,
à dessein — gater les backticks = faux positifs massifs, donc NON élargi). Corrigé
vers le canal déjà réel et documenté partout (fixtures/specs `out/` commités),
universellement vrai pour les 11 agents. 7 gates verts.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Claude Code DTP Worker
2026-08-02 10:39:53 +00:00
parent 0752e35988
commit 4841b77099
12 changed files with 55 additions and 11 deletions
+44
View File
@@ -1,5 +1,49 @@
# Activity log · 2026-08-02 · Claude Code DTP Worker
## Sprint 8 · buffer · Dérive doc-vs-réalité : 11 fiches AGENT.md pointaient un canal `handoffs/` INEXISTANT — correction vers le canal de hand-off RÉEL (livrables `out/` commités)
**Nature — dérive réelle, pas un gate de plus (CLAUDE.md #5 · interdit « documenter sans vérifier existence courante »).**
Audit de complétude plutôt qu'empilage : la série récente a saturé les surfaces
driftables numériques ; j'ai cherché une dérive doc-vs-réalité échappant aux gates.
**Constat.** Le bloc boilerplate « ## Communication inter-agents » (identique dans
**11** des 13 fiches `03_agents/*/AGENT.md`) affichait :
`- Handoffs formalisés dans \`05_deliverables_mvp/handoffs/\``. Or ce répertoire
**n'existe pas** — `find -iname '*handoff*'` = 0 fichier, 0 consommateur (code/gate),
0 test. Fausse promesse de canal. Les 2 autres lignes du bloc sont, elles, vraies
(`daily_reports/` existe · WhatsApp conforme CLAUDE.md).
**Pourquoi les gates l'ont manqué (angle mort documenté, pas à re-gater).**
`check_docs.sh` §1 valide les cibles de liens `[texte](cible)` mais **neutralise
délibérément les code-spans backtick** (l.28 `sed 's/\`[^\`]*\`//g'`) : un chemin
entre backticks est traité comme *exemple de syntaxe* (ex. `gen.py build|validate`
n'est pas un chemin réel). `\`…/handoffs/\`` étant un code-span, il échappe. **Gater
tous les backticks créerait des faux positifs massifs** (les fiches en regorgent :
entrées CLI, extensions) → j'ai **choisi de NE PAS élargir le gate** (anti-sur-gating,
mémoire `verify-uncovered-before-gating`). Le correctif est un correctif de vérité,
pas un nouveau gate.
**2 solutions (workflow #4) — la bonne = corriger la doc, pas créer le dossier.**
- ❌ Créer `handoffs/` + README index : inventerait du contenu (#6) et **dupliquerait**
le mécanisme de hand-off déjà réel (les `out/` commités), violant #5.
- ✅ **Corriger les 11 lignes** vers le canal qui existe déjà, décrit richement dans
chaque fiche (« Chaque générateur transforme un spec en fixtures `out/` commitées —
le hand-off direct »). Nouvelle ligne, universellement vraie pour les 11 agents
(chacun produit au moins un doc/spec/fixture commité, y compris bim/ifc_speckle/
rendu/erpnext_backend qui n'ont pas de `out/` mais ont une fiche/SPEC) :
`- Hand-off inter-agents = livrables déterministes commités in-repo (fixtures/specs \`out/\`, SPEC, README), consommés directement par l'agent destinataire`.
**Exécution.** Remplacement littéral exact (script Python, assertion `count==11`,
1 occurrence/fichier) sur les 11 fiches : bim · crm · devops · erpnext_backend ·
frontend_console · ifc_speckle · mobile · onapi_legal · qa · rendu · seo.
**Vérif.** (1) `grep -rn handoffs` sur `03_agents/ 05_deliverables_mvp/ ci/ README.md`
→ **0 résidu**. (2) Nouvelle ligne présente (échantillon crm l.68, bim l.74). (3)
**7 gates verts** : check_ci_integrity · check_artifacts · check_docs ·
check_readme_claims · check_regression · guard_constraints · validate_json (tous exit 0).
---
## Sprint 8 · buffer · Démo/scenarios — ancrage des MINIMA D'ORCHESTRATION (« ≥ 2 modules distincts · ≥ 3 beats ») sur la garde `check_invariants` (CODE-autorité)
**Contexte** — Série anti-dérive Sprint 8 (CLAUDE.md #6 « zéro invention de