| 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
