finalize-phase

This skill orchestrates the /finalize phase, the final step after successful deployment to production, direct-prod, or local build.

For Epic Workflows (v5.0+):

• Generate comprehensive walkthrough.md with velocity metrics, sprint results, lessons learned
• Run post-mortem audit with pattern detection (after 2-3 epics)
• Offer workflow healing with improvement recommendations
• Detect patterns for custom skills/commands generation

For Feature Workflows:

• Standard finalization (roadmap, artifacts, docs, branches)

Inputs: Deployed feature/epic, phase artifacts, ship report, state.yaml Outputs: walkthrough.md (epics only), updated roadmap, archived artifacts, updated documentation Expected duration: 10-15 minutes (features), 20-30 minutes (epics with walkthrough)

<quick_start> After deployment completes, finalize the workflow:

Epic Workflows (NEW in v5.0): 0. Generate walkthrough - Comprehensive epic summary with velocity metrics, sprint results, lessons learned, pattern detection

1. Run post-mortem audit - Final effectiveness analysis with improvement recommendations
2. Offer workflow healing - Apply discovered improvements with user approval

All Workflows (features + epics):

1. Update roadmap - Move to "Shipped" with completion date, version, production URL
2. Archive artifacts - Verify all phase artifacts in specs/NNN-slug/ or epics/NNN-slug/
3. Update documentation - README, CHANGELOG, user guides (if applicable)
4. Clean up branches - Delete feature branch locally and remotely
5. Commit finalization - Small commit documenting workflow closure

Key principles:

• Clean closure preserves knowledge and enables learning
• Epic walkthroughs enable self-improving workflow system
• Pattern detection (after 2-3 epics) suggests custom automation </quick_start>

If deployment incomplete, return to /ship phase.

Detect epic vs feature workflow and generate comprehensive walkthrough for epics.

Detection:

if [ -f "epics/*/epic-spec.xml" ]; then
  WORKSPACE_TYPE="epic"
  EPIC_DIR=$(dirname "epics/*/epic-spec.xml")
else
  WORKSPACE_TYPE="feature"
  # Skip to Step 1 (standard finalization)
  continue
fi

If feature workflow: Skip this step entirely, proceed to Step 1

If epic workflow: Generate walkthrough before standard finalization

Walkthrough Generation Pipeline:

1. Gather all epic artifacts:

   • epic-spec.xml (epic specification)
   • research.xml (research phase output)
   • plan.xml (plan phase output with meta-prompting)
   • sprint-plan.xml (task breakdown with dependency graph)
   • state.yaml (state tracking across phases)
   • audit-report.xml (workflow effectiveness analysis)
   • preview-report.xml (manual testing decision)
   • Sprint results from epics/NNN-slug/sprints/*/

2. Calculate velocity metrics:

   • Expected parallelization multiplier (from sprint-plan.xml)
   • Actual parallelization multiplier (from audit-report.xml)
   • Time saved in hours (parallel vs sequential execution)
   • Duration from start to completion

3. Extract key information:

   • Epic goal and success metrics
   • Phases completed with timestamps
   • Sprint execution results (status, tasks, duration, contracts, tests)
   • Validation results (optimization, preview decision)
   • Key files modified
   • Next steps (enhancements, technical debt, monitoring needs)