[DTP-Worker 20260802_113542] Sprint 8 · buffer · Audit exactitude doc-vs-réalité des 11 fiches AGENT.md restantes : 0 dérive réelle (13/13 fiches désormais auditées), 2 « dérives » signalées levées comme faux positifs de convention (onapi_legal backtick deliverables-relative miroir du code · faisabilite chemins VPS/futurs assumés) + 1 clarification de lisibilité (bandeau VPS-runtime vs template committé) sur faisabilite/AGENT.md

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Claude Code DTP Worker
2026-08-02 11:43:45 +00:00
parent 519f6dbfee
commit 2bc3afbd1a
2 changed files with 75 additions and 0 deletions
+6
View File
@@ -29,6 +29,12 @@ le générateur, son contrat et ses fixtures d'entrée le sont (le rendu réel d
s'exécute côté OTOIA/VPS · #8).
## Sources canoniques
> **Chemins VPS runtime — hors périmètre worker (#8), non commités in-repo** (préfixe
> absolu `/opt/oto/…`, placeholder de version `{X}`). La **contrepartie commitée,
> testée et gatée** du template canonique est
> [`TEMPLATE_FAISABILITE_CANONIQUE_v1.0.md`](../../05_deliverables_mvp/faisabilite/TEMPLATE_FAISABILITE_CANONIQUE_v1.0.md)
> (table §Livrables ci-dessus) — **la référence de vérité pour le worker** ; les
> chemins ci-dessous décrivent l'emplacement runtime OTOIA/VPS où l'agent exécute.
- `/opt/oto/otoia/capabilities/knowledge/faisabilite_4_volets_standard.md` (STANDARD OFFICIEL)
- `/opt/oto/data_room/_TEMPLATE_FAISABILITE_v{X}/` (template versionné)
- `/opt/oto/data_room/PXX/00_brief/` (données projet)
+69
View File
@@ -1176,3 +1176,72 @@ check_docs (liens du rapport résolus) · guard_constraints (aucun terme interdi
introduit) · check_readme_claims · check_ci_integrity · validate_json ·
check_artifacts · check_regression. **Sûreté** : rapport dans le canal canonique
(roadmap), zéro chiffre inventé, tous liens Markdown vers cibles existantes.
---
## Sprint 8 · buffer · Audit d'exactitude doc-vs-réalité des 11 fiches `AGENT.md` restantes — 0 dérive réelle · 2 « faux positifs » d'audit levés · 1 clarification de lisibilité (faisabilite)
**Nature** — Poursuite de la tâche explicitement recommandée par le daily report
`2026-08-02` (« Poursuivre l'audit d'exactitude des 11 fiches AGENT.md restantes,
mêmes contrôles que crm/bim — repérer toute sur-promesse d'artefact ou compte
périmé »). CLAUDE.md interdit « documenter du code sans vérifier son existence
courante ». **Pas un gate de plus** (workflow #5) : vérification, pas empilage.
**Méthode** — 4 agents `Explore` en parallèle sur les 11 fiches (devops ·
erpnext_backend · faisabilite · frontend_console · ifc_speckle · mobile ·
onapi_legal · publiciste · qa · rendu · seo). Pour chaque fiche : existence de
CHAQUE chemin in-repo cité · recompute de CHAQUE compte (tests via `grep -c
'def test_'` / `regression_plan.json` · invariants via marqueurs numérotés) ·
présence de CHAQUE artefact `out/*.json` · toute sur-promesse d'un livrable
in-repo inexistant.
**Résultat brut des agents** — 9 fiches « FULLY ACCURATE » (comptes de tests
recoupés : deploy_runbook 29 · e-CF 39 · confotur 44 · publiciste 23 · audit_5d 37
· audit_4big 34 · regression 26 · acceptance 37 · seo 36 · portails 19 · chat 31 ;
SEO 258 mots-clés / 10 nœuds schema.org / 10 pages hreflang ; Expo SDK 54). **2
fiches signalées en « dérive »** — toutes deux **VÉRIFIÉES FAUX POSITIFS** après
contrôle manuel (mémoire `verify-uncovered-before-gating` : prouver avant d'agir) :
1. **onapi_legal** (agent : 3 chemins « CRITICAL cassés » l.40/49/99 :
`../rbac/rbac_50_roles.json`, `../crm/workflow_vente/[out/]`). **Faux positif** :
ces chemins backtick sont **relatifs à l'arbre des livrables** (`05_deliverables_mvp/legal/`,
sujet de la fiche §24), PAS à l'emplacement de la fiche. Ils **MIROITENT le code**
du générateur : `rbac_scan.py` fait `os.path.join(_DELIVERABLES, "rbac",
"rbac_50_roles.json")` et `builder.py` publie `workflow_source:
"crm/workflow_vente/workflow_vente_spec.json"`. Les 3 cibles existent bien depuis
`05_deliverables_mvp/legal/` (vérifié `ls`). L'agent avait supposé à tort une
résolution fiche-relative. Convention documentée dans la mémoire
`backtick-path-escapes-check-docs` (les code-spans backtick sont volontairement
NON link-checkés). **Aucune correction — la fiche est exacte.**
2. **faisabilite** (agent : `data_room/_TEMPLATE_…/`, `_META/version.json`,
`otoia/capabilities/knowledge/faisabilite_template_v{X}.md` « HIGH · sources
inexistantes »). **Faux positif** : ces chemins sont **explicitement VPS-runtime /
« Composants à créer »** — préfixe absolu `/opt/oto/…`, placeholder de version
`{X}`, section §95 « Composants à créer ». La fiche les réconcilie déjà (§15-17
« composants runtime OTOIA/VPS … restent hors périmètre worker » ; §27-29 « aucune
faisabilité concrète PXX n'est commitée ici … le rendu réel … s'exécute côté
OTOIA/VPS #8 »). Hors-repo ASSUMÉ, pas une sur-promesse. **Table §Livrables
exacte** : `TEMPLATE_FAISABILITE_CANONIQUE_v1.0.md` (existe) · generator 16 tests ·
bancable 22 tests. **Aucune sur-promesse in-repo.**
**Seule action — clarification de LISIBILITÉ (faisabilite), pas un correctif de
dérive.** Le point qui a induit l'agent en erreur est une vraie ambiguïté pour un
lecteur humain : le bloc « Sources canoniques » (§31-34) listait 3 chemins VPS
`{X}` sans signaler que la **contrepartie commitée/testée/gatée** du template
canonique est l'in-repo `TEMPLATE_FAISABILITE_CANONIQUE_v1.0.md` (pourtant déjà en
tête de la table §Livrables). Ajout d'une **note additive** (style de réconciliation
déjà employé §15-17) : bandeau « Chemins VPS runtime — hors périmètre worker (#8),
non commités in-repo » + lien Markdown vers le template committé « référence de
vérité pour le worker ». **Zéro chiffre, zéro constante, zéro fait inventé** ;
purement désambiguïsant.
**Sûreté / vérif** — Avant édition : `grep` confirme qu'AUCUN gate ne parse la fiche
faisabilite ni la section « Sources canoniques » (édition prose libre). Après :
**7 gates re-verts (exit 0)** — `check_ci_integrity` · `check_artifacts` ·
`check_docs` (le nouveau lien Markdown résout vers une cible existante) ·
`check_readme_claims` · `check_regression` · `guard_constraints` (aucun terme
interdit introduit) · `validate_json`. **Bilan audit** : les **13 fiches**
`AGENT.md` sont désormais TOUTES auditées exactes (crm/bim la session précédente +
les 11 ici) ; les 2 « dérives » signalées étaient des artefacts de convention
(backtick deliverables-relative · chemins VPS/futurs assumés), pas des dérives.