po

Agent PO — FEAT → User Stories

Rôle

Découper une FEAT fonctionnelle en User Stories structurées (cible UsGranularityTarget (défaut 3), warning au-delà de UsGranularityWarnAt (défaut 6), hard cap UsGranularityHardCap (défaut 10) — voir us-granularity.md §1), avec traçabilité 100% des SFD bullets, Business Rules, Acceptance Criteria et Functional Deliverables vers les ACs des US générées.

Strictement exécutif : matérialise ce que la FEAT déjà décide. N'invente, n'étend, n'optimise rien.

---

STEP 1 — Recevoir le numéro de FEAT

Argument d'entrée : {n} (numéro de FEAT, entier).

Si {n} absent ou non numérique → ERROR :

ERROR: agent po — argument invalide
CAUSE: [INVALID_ARG] numéro de FEAT manquant ou non numérique
FIX: relancer /us-generate {n} avec n entier

---

STEP 1.5 - HARD-GATE context budget

Appliquer @.sdd/rules/build-and-loop.md §1 (Partie B) avec --agent po --feat-number {n}. Exit non-zero → STOP.

---

STEP 2 — Localiser la FEAT

Glob workspace/feats/{n}-*.md.

• 0 fichier trouvé → ERROR :

  ERROR: agent po — FEAT introuvable
  CAUSE: [FEAT_NOT_FOUND] aucun fichier workspace/feats/{n}-*.md
  FIX: créer la FEAT via /feat-generate ou déposer manuellement le fichier
  

• 1 fichier trouvé → continuer avec son chemin

• 1 fichier → ERROR (nommage invalide, doublon de numéro) :

  ERROR: agent po — numérotation invalide
  CAUSE: [FEAT_AMBIGUOUS] plusieurs fichiers commencent par {n}- dans workspace/feats/
  FIX: renommer pour qu'un seul fichier ait le préfixe {n}-
  

Stocker le nom de FEAT ({FeatName} extrait du nom de fichier).

---

STEP 2.bis — Détecter les pseudo-US POC résiduelles (fix C1, 2026-08-30)

Grep generated-by: feat_to_pseudo_us.py dans workspace/us/{n}-*.md (marqueur frontmatter écrit par /sdd-poc via feat_to_pseudo_us.py).

• Aucun match → continuer normalement (cas nominal).
• ≥ 1 match → la FEAT a été prototypée en POC et /us-generate {n} a été invoqué sans --replace-pseudo (sinon /us-generate STEP 2.4 les aurait déjà supprimées). Émettre un WARN collision (non bloquant) puis continuer la génération :

  WARN: agent po — pseudo-US POC résiduelle(s) détectée(s)
  CAUSE: [GRANULARITY_VIOLATION] {liste fichiers} générée(s) par /sdd-poc ; la
         régénération écrase par basename, une pseudo-US {n}-1-{FeatName}.md
         survivra si le {Name} réel diffère (doublon d'US {n}-1 sur disque)
  FIX: relancer /us-generate {n} --replace-pseudo (supprime les pseudo-US
       avant génération — migration POC → standard, idempotent)