[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:
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user