Skip to content

CVN-N014-EC-S18 — epic-close wrap-up skill · hub Story

Hub documentaire de la Story S18 de l'Epic CVN-N014-EC — agentic dev-workflow skills — livrer epic-close, l'assistant de clôture d'Epic gate-checkée, sœur de story-advance et create-story. État live = OpenProject (wp#256, GH #1132).

En une phrase

epic-close clôt un Epic / version OpenProject une fois sa dernière Story Closed, après avoir vérifié tout le wrap-up (7 gates read-only), refuse au premier gate manquant en le nommant, puis — sur approbation — écrit une note de clôture navigable (câblée dans la nav + pointeur OP) ; la fermeture de version reste un geste UI vérifié post-hoc. Elle complète le cycle create-story (ouverture) → story-advance (progression) → epic-close (clôture).

Les 7 gates (refuse + STOP au premier FAIL)

  1. Toutes Stories Closed (OP + GH) · 2. Docs en place (check_story_docs --blocking/Story) · 3. Nav OK (mkdocs --strict + hubs câblés + URL 200) · 4. Trail comité en OP Meetings (ADR-82) · 5. Rétro existe + qualité (input obligatoire, pas généré) · 6. Acceptance Epic avec preuve structurée · 7. Pas de reliquat (PR/branches/[gate-failure]).

Décisions de design (validées plan_review 529e0651, PASSED · OK · 0 blocker)

  • Version-close v1 = geste UI vérifié post-hoc (op_version_close.py différé v2).
  • Rétro = input pré-existant, jamais créée par la clôture (anti-circularité).
  • Divergence des sources = STOP par défaut, waiver seulement avec justification + owner + expiry, tracé dans la note.
  • Dogfood durci : CVN-N014-ED (réel/dry-run) + 2ᵉ Epic indépendant en dry-run obligatoire.

Les documents

Document Quoi
Plan dossier le quoi & pourquoi — exec summary + glossaire, chapitres ADR-0101, design (Phases A–D, 7 gates), risques, follow-ups v2. plan_review PASSED (529e0651, 0 blocker).
Skill .claude/skills/epic-close/SKILL.md (+ scripts/emit_skill_event.py) — le rituel exécutable.
architecture N/A — skill docs/tooling, pas de design système ; le modèle de référence est story-advance (S11).
runbook N/A — l'usage est la skill elle-même (/epic-close <EPIC>).
test_strategy dogfood (CVN-N014-ED réel/dry-run + 2ᵉ Epic dry-run) + gates négatifs (Epic incomplet → STOP nommé).

État & gates

In progress (OpenProject) — dossier 5★ + plan_review PASSED ; impl SKILL.md + scripts en cours.

  • In specification ✅ · Specified ✅ (plan_review PASSED 529e0651 / Meeting #263) · In progress ✅.
  • → Developed : skill livrée + doc-set conforme + nav OK + PR verte + docs live.
  • → Closed (DoD) : dogfood validé (CVN-N014-ED + 2ᵉ Epic dry-run) → bookend de clôture du cycle de vie en place.