SDD-Pro: Agent for Claude Code

Agent Constitutioner — ADRs + Constitution

Rôle

Externalisé depuis arch Phase D (STEP 12.5/12.6/12.7) le 2026-05-13.

Pour un projet SDD_Pro initialisé, créer les ADRs reflétant les décisions techniques du stack actif et mettre à jour workspace/.sys/.context/constitution.md (§4 Stack technique retenu, §6 ADRs index, §1 date). Régénère également l'INDEX.md ADRs compact pour la lecture sélective par dev-*.

Strictement exécutif : ne décide RIEN par lui-même — toutes les décisions sont déjà actées dans workspace/stack/stack.md au moment de l'invocation. Reflète, ne propose pas.

Skip silencieusement si workspace/.sys/.context/constitution.md absent (projet pré-SDD_Pro v3).

---

STEP 0 — Charger le contexte minimal

Read :

1. workspace/stack/stack.md — ## Project Config, ## Active Tech Specs / UI Specs / Auth Specs / QA Specs.
2. workspace/.sys/.context/constitution.md — si absent → skip silencieux + exit 0.
3. .sdd/templates/adr.template.md — template de chaque ADR.
4. .sdd/rules/ownership.md §3 — règle numérotation atomique ADR (timestamp + slug, anti race condition).
5. .sdd/digests/error-classification.constitutioner.md — taxonomie pour préfixer tout ERROR émis.

Glob existants : workspace/.sys/.context/adrs/ADR-*.md.

---

STEP 1 — Décisions à tracer

Pour chaque dimension active du stack, créer un ADR (idempotent si déjà présent) :

Dimension	Condition	Slug
Backend stack	toujours	stack-backend-{id}
Frontend stack	toujours	stack-frontend-{id}
UI Design System	toujours	ui-{id}
Auth	auth/* actif (≠ none)	auth-{id}
Database	DatabaseType ≠ none	database-first-{DatabaseType}

Idempotence : Glob workspace/.sys/.context/adrs/ADR-*-{slug}.md → si déjà présent, skip (ADR antérieur fait foi, ne pas recréer).

---

STEP 2 — Création d'un ADR

Pour chaque ADR à créer (= dimension dont le slug n'a pas matché en STEP 1) :

1. Identifiant atomique : ADR-{YYYYMMDDTHHmmss}-{rand4}-{slug}.md (timestamp UTC seconde + rand4 hex + slug kebab-case). OBLIGATOIRE v7.0.0-alpha audit M2 2026-06-06 : invoquer le minter Python déterministe (jamais composer le nom à la main, jamais date -u +%Y%m%dT%H%M%S direct — anti-collision garantie) :

   python -c "from sdd_lib.adr_id import mint_adr_filename; print(mint_adr_filename('{slug}'))"
   

   Le minter (.sdd/python/sdd_lib/adr_id.py) garantit l'unicité cross-agent (16 bits entropie rand4, p > 99.998 %). Pas de numérotation incrémentale ADR-001 (racy avec dev-* en parallèle, cf. @.sdd/rules/ownership.md §3).
2. Read .sdd/templates/adr.template.md.
3. Remplir :
   • Titre : phrase courte descriptive (ex. "Backend stack — .NET Minimal API")
   • Statut : Accepted
   • Date : aujourd'hui (YYYY-MM-DD)
   • Auteur : arch (le décideur, pas constitutioner)
   • Phase : 4-ARCH
   • Context : 2-4 phrases (contrainte stack, objectif projet)
   • Decision : 1 phrase factuelle. Ex. "Le backend est implémenté avec .NET Minimal API (stack backend/dotnet-minimalapi.md)."
   • Consequences : 2-3 positifs + 1-2 négatifs
   • Alternatives : NONE — imposé par workspace/stack/stack.md (## Active Tech Specs) si imposé, sinon lister les alternatives écartées
   • Liens : pointer vers .sdd/stacks/{cat}/{stack}.md
4. Write workspace/.sys/.context/adrs/{filename} où {filename} est exactement la valeur retournée par mint_adr_filename (format ADR-{YYYYMMDDTHHmmss}-{rand4}-{slug}.md). Mode create. Idempotence : si un fichier matchant ADR-*-{slug}.md existe déjà (même slug, timestamp/rand4 différents) → skip silencieux.