ADRADR-0018 · Le Playbook maître docx est supersédé

ADR-0018 — Le Playbook maître docx est remplacé par des pages de référence gardées

Le 2026-09-15, le propriétaire a fourni BoostEcom_Playbook_Maitre_Produit_Codebase_Growth_2026.docx (~64k caractères, 18 sections : doctrine, codebase, growth, prompt agent).

Statut

Accepté · 2026-09-15

Piliers : growth-web, ai-platform, platform-ops

Contexte

Le 2026-09-15, le propriétaire a fourni BoostEcom_Playbook_Maitre_Produit_Codebase_Growth_2026.docx (~64k caractères, 18 sections : doctrine, codebase, growth, prompt agent).

Le dépôt avait déjà : CLAUDE.md / AGENTS.md, fleet (docs/team/), Prisma + schema guard, skill boostecom-content (ICP, voice, plan, Postiz, long-form), architecture Growth / Radar / Creative Media OS, et un distillat messaging (acquisition-messaging.md depuis un autre docx).

Garder le monolithe Desktop comme « source de vérité » aurait créé une deuxième bible non gardée, en conflit partiel avec ADR 0009 (DB), le runtime workflows (stub), et la machine contenu réelle.

Décision

  1. Le .docx n'est plus une source. Après distillation il est supprimé du bureau (Desktop) du propriétaire.
  2. La substance utile vit dans :
    • .claude/skills/boostecom-content/references/product-doctrine.md
    • …/gtm-operating-system.md
    • …/operator-contract.md
    • …/playbook-maitre-map.md (carte KEEP/MERGE/DROP/BACKLOG)
  3. Hiérarchie des vérités figée dans product-doctrine.md §0 (owner → code/prod → contrats → doctrine → roadmap).
  4. Pas de second system prompt (§16 du docx = DROP).
  5. Objets aspirés du docx (CapabilityManifest, ActionRecord, OutcomeRecord) et north star WOS non instrumentée → backlog (ai-platform/2699, growth-web/2700), pas de prose « live ».

Conséquences

  • Un agent lit la map puis les distillats, jamais un Word hors repo.
  • Toute nouvelle doctrine owner arrive en PR dans ces pages de référence (ou en ADR), pas en pièce jointe Desktop.
  • Les conflits code ↔ doctrine se résolvent en corrigeant la doctrine dans la même PR que le code, ou en ouvrant un item backlog.

Alternatives écartées

  • Committer le .docx dans docs/ : binaire non diffable, non gardé.
  • Réécrire CLAUDE.md avec les 60 pages : doublon + dérive garantie.
  • Coller §16 dans AGENTS.md : guerre de prompts avec Cursor / fleet.
Was this page helpful?