retro-learn

Retro Learn Workflow

Goal: Turn defects, missed expectations, and delivery friction into durable standards improvements.

Steps

1. Gather evidence:
   • Review findings
   • Bugs found during verification
   • Security findings
   • User corrections
   • Failed or slow checks
   • Token or context pain
   • session-report artifacts
2. Classify:
   • Skill rule gap
   • Eval coverage gap
   • Workflow gap
   • Documentation gap
   • Tooling gap
   • Specialist gap
   • Environment-only issue
3. Decide action:
   • Existing skill should prevent it: update SKILL.md and evals/evals.json.
   • No skill covers it: propose a new skill.
   • Workflow caused drift: update .agents/workflows.
   • Specialist caused drift: add budget, fallback, or output-format rule.
   • Tooling can catch it: add or update an audit script.
4. Verify learning:
   • Run changed skill validation.
   • Run eval alignment.
   • Record remaining follow-ups.

Runtime Contract

• Use after delivery findings, corrections, or friction need converting into durable standards improvements.
• Required inputs: review findings, verification results, or session-report artifacts to classify.
• Return BLOCKED only when no evidence exists to classify.

Handoff Payload

• slug, root causes, skill/eval updates, follow-ups, next workflow.

Blocking Questions

• Ask max 3 at a time with a recommended default and 2-3 options.

Output Template

# Retro: [Name]

## Evidence

## Root Causes

| Finding | Category | Action |
| --- | --- | --- |
| [finding] | [category] | [action] |

## Skill Or Eval Updates

## Outcome Report
feature_status: implemented
requirement_trace: BRD-OBJ-* -> REQ-* -> AC-* -> SRS-* -> evidence
completed_evidence: []; missing_evidence: []; decision_needed: []; recommended_next_workflow: none

## Next Workflow

## Follow-Ups

## Cost Report
Call `get_session_cost(workflow="retro-learn")` before final handoff.