| name | workflow-completion |
| description | Use when all workflow stages are completed and verified — generates summary report, archives results, and commits |
Workflow Completion
Overview
Wrap up a completed workflow with a summary report and clean archival.
Core principle: A workflow is not done until it's documented and committed.
Process
Step 1: Verify All Stages Completed
Read workflow-state.json. Every stage must have status: "completed" (or skipped). If any stage is not completed, do NOT proceed — invoke superscientist:executing-workflows instead.
Step 2: Generate Summary Report
Save to docs/superscientist/reports/YYYY-MM-DD-<topic>-report.md:
# [Topic] Workflow Report
**Workflow ID:** [workflow_id]
**Completed:** [timestamp]
**Total sessions:** [count from progress.log]
**Amendments:** [count]
## Objective
[From experiment design doc]
## Results Summary
### Stage N: [Name]
- **Status:** completed
- **Key result:** [1-2 sentence summary of output]
- **Output files:** [paths]
## Issues Encountered
[Any failed stages, retries, amendments — summarized from progress.log]
## Key Outputs
[List of final deliverables with paths]
Step 3: Update workflow-state.json
Add top-level field: "workflow_status": "completed" and update "updated" timestamp.
Step 4: Final Log Entry
Append to progress.log via Bash tool:
echo "[$(date -Iseconds)] Workflow completed. All N stages verified. Report: docs/superscientist/reports/..." >> progress.log
Step 5: Commit
git add workflow-state.json progress.log docs/superscientist/reports/
git commit -m "feat: complete workflow <workflow_id>"
Step 6: Announce
Tell the user: workflow is complete, where to find the report, and list the key output files.
