Finalize the workflow by reflecting on the process, moving ADRs, closing issues, and preparing for merge. Stage 8 of the development workflow.
Execute the reflection and finalization stage. $ARGUMENTS
You are executing Stage 8 (Reflection) of the development workflow. The implementation is reviewed, revised, and compounded. Your job is to finalize: reflect on what happened, move artifacts to their permanent locations, close tracking issues, and prepare the branch for merge.
Before starting, verify:
.workflow/state.json exists and currentStage is "reflection"Review the entire workflow by reading the state file and any persisted summaries. Produce a structured reflection:
WORKFLOW REFLECTION
====================
Workflow: <id> - <title>
Branch: <branch>
Duration: <startedAt> to now
## What Worked
- [specific things that went well, with evidence]
- [approaches that should be repeated]
## What Didn't Work
- [specific things that went poorly, with evidence]
- [approaches to avoid in future]
## Hypothesis Outcomes
- H1 "<text>": VALIDATED / REFUTED / INCONCLUSIVE
- H2 "<text>": ...
## Revision Iterations
- Total: N/3
- Root causes of revision: [what triggered each iteration]
## Unexpected Discoveries
- [things learned that weren't part of the original plan]
- [codebase behaviors that surprised us]
## Process Improvements
- [suggestions for improving the workflow itself]
Ask the user if they want to add their own reflection:
Would you like to add your own reflection notes?
This is optional but valuable for the compound learning record.
If the user provides input, append it to the reflection under a ## Chief Agentic Notes section.
Based on the workflow outcome:
If hypotheses were validated (happy path):
mv .adr/staging/<NNN>-<name>-adr.md .adr/accepted/<NNN>-<name>.md
mv .adr/staging/<NNN>-<name>-summary-*.md .adr/accepted/
specs/specs/ or .adr/accepted/ are now outdated by this work, update themIf hypotheses were refuted:
mv .adr/staging/<NNN>-<name>-adr.md .adr/rejected/<NNN>-<name>.md
If the workflow was abandoned or partially completed:
Ensure all changes are committed:
git status
If there are uncommitted changes (reflection artifacts, ADR moves), commit them:
git add <specific files>
git commit -m "docs: finalize workflow <id> - move ADR, close issues"
Rebase onto main:
git fetch origin
git rebase origin/main
If conflicts arise, resolve them or escalate to user.
Push the branch:
git push -u origin <branch>
Create or update the PR:
Merge decision: Ask the user whether to merge now or leave the PR open for additional review:
Branch is pushed and PR is ready.
Merge now, or leave open for review?
Invoke /capture-learning to extract reusable learnings from this workflow session. Pass it the reflection from Step 1 as context.
Set the final state:
{
"stages": {
"reflection": {
"status": "completed",
"completedAt": "<ISO timestamp>"
}
},
"currentStage": "completed",
"updatedAt": "<ISO timestamp>"
}
Present the completion summary:
WORKFLOW COMPLETE
==================
<title>
Branch: <branch>
ADR: <final location>
Stages:
1. Ideation [x] <notes excerpt>
2. Dev-Docs [x] spec: <path>, adr: <path>
3. Planning [x] plan: <path>
4. Implementation [x] commits: N, summaries: N
5. Review [x] findings: N (all resolved)
6. Revision [x] iterations: N/3
7. Compound [x] learning captured
8. Reflection [x] ADR accepted/rejected
PR: <url or "merged">