| name | workflow-logger |
| description | Structured markdown logging for multi-agent design workflows. Appends formatted events to workflow_log.md with timestamps, phase info, and agent activity. Use when recording workflow progress, phase transitions, Critic verdicts, or final summaries. |
Workflow Logger
When to use
- At workflow start (create log with header)
- At each phase transition
- After each agent completes work
- After each Critic verdict
- At workflow completion (final summary)
How to use
Initialize log
python3 .github/skills/workflow-logger/scripts/workflow-logger.py init --folder generated_docs_[TIMESTAMP] --project "Project Name"
Log phase start
python3 .github/skills/workflow-logger/scripts/workflow-logger.py phase --folder generated_docs_[TIMESTAMP] --phase "Phase 1: Research" --agents "Researcher x3"
Log event
python3 .github/skills/workflow-logger/scripts/workflow-logger.py event --folder generated_docs_[TIMESTAMP] --message "Research complete. 3 files created."
Log Critic verdict
python3 .github/skills/workflow-logger/scripts/workflow-logger.py verdict --folder generated_docs_[TIMESTAMP] --iteration 2 --verdict CONDITIONAL --critical 0 --major 2 --minor 1 --issues '[{"severity":"MAJOR","section":"4","issue":"Specific instance nodes in diagram","action":"Replace with abstract fleet node"},{"severity":"MINOR","section":"5","issue":"Mindmap exceeds 10 elements","action":"Consolidate items"}]'
If issues JSON is not available, fall back to summary:
python3 .github/skills/workflow-logger/scripts/workflow-logger.py verdict --folder generated_docs_[TIMESTAMP] --iteration 2 --verdict CONDITIONAL --critical 0 --major 2 --minor 1 --summary "Diagram issues and missing monitoring details"
Log completion
python3 .github/skills/workflow-logger/scripts/workflow-logger.py complete --folder generated_docs_[TIMESTAMP] --iterations 3
Output format
The script appends formatted markdown to workflow_log.md:
# Workflow Execution Log
Project: Fish TTS Autoscaling
Started: 2026-02-10 17:28:21
Status: In Progress
## Execution Timeline
### [2026-02-10 17:28:21] Phase 1: Research
- Activated: Researcher x3
- Status: In progress
### [2026-02-10 17:30:45] Review - Iteration 2/5
- Verdict: CONDITIONAL
- Critical: 0, Major: 2, Minor: 1
- Key feedback: Diagram issues and missing monitoring details
## Final Summary
- Status: COMPLETED
- Total iterations: 3
- Completion time: 2026-02-10 17:42:15
- Processing time: 13m 54s
- Documents approved: YES
- Next steps: Invoke DevOps agent with 'deploy' command
