workflow-retro
Use when a multi-step agent session or orchestration run ends (design, specify, build, review, longer debugging) and its friction ledgers should turn into workflow improvements, or when asked for a retro, "what slowed us down", "too many rules", or to converge, clean up or shrink skills, CLAUDE.md or the project profile.
Target: Design & content creation. Automatically collected · unverified.
Excerpt from the author’s documentation
Extracted from a fixed version of SKILL.md in its original language. This is the author’s documentation; installation, compatibility and runtime results have not been verified by this site.
Read the original English text
Topics in the source
- Workflow retro
- 1. Collect
- 2. Find causes
- 3. Decide with the running log
- 4. Converge
- 5. Apply and record
- Running log format
Turn what agents logged while working (ledger.sh, global CLAUDE.md) into fewer round trips, fewer errors and checks sized to the change, without growing the instructions. The session owner runs it; workers only hand over their ledger. A retro whose only output is deleting or merging rules is a good retro; zero edits is a fine outcome. Ledgers: the run's dir (bash /ledger.sh dir ), or this session's file (ledger.sh path), plus your own. Metrics: per stage wall time (orchestrated: orca orchestration task-list --run --json --full (the concise view has no timestamps), createdat → completedat), fix rounds, review findings by severity, every [check] line, and the profile's "Retro" metric sources (e.g. hook logs). The running log (path in the profile's "Retro") and the last context-size row. 1. Group entries by root cause, not symptom. The same cause in two workers' ledgers is the strongest signal of the run. 2. Attribute each to the stage or file that could have prevented it. A Build spec-gap is a Specify or spec-template fix; a review finding is an escaped against the check that should have caught it. 3. Scope against checks, per PR: diff size and area against what ran ([check] lines, g
This is an excerpt. Refer to the complete source and its current requirements.
- Source repository
- jaylouiz/agent-workflow
- Source file
- skills/workflow-retro/SKILL.md
- Fixed revision
- 04c8435b22abb20188928fda324b191865c928e9
Sources and evidence
This record was collected automatically. Its documentation, suitability and runtime behavior have not been manually verified.
Author: jaylouiz/agent-workflow · original repository metadata. Documentation review: Not reviewed. Last source check: 2026-11-11T23:00:25.897Z.
Categories are inferred from names, descriptions and paths. They do not establish compatibility.
License and attribution
MIT. Third-party content and copyright remain with their authors. Refer to the original license and terms.
Original license ↗Synchronization, copying and user-reported success do not mark a resource as runtime-tested.
Limitations and notes
- Collecting metadata does not mean this site has installed, adapted, runtime-tested or security-reviewed the resource.