Outcome Reports

Every kanban task MUST produce an outcome report in:

docs/kanban-outcomes/<task-id>-outcome.md

Use the template at templates/KANBAN_OUTCOME_REPORT.md.

Minimum Sections

1. Objective - What the task was supposed to accomplish
2. Commands Run - Exact commands executed with their host
3. Files Changed - List of modified/created files
4. Artifacts - Paths to produced artifacts
5. Verification - How results were verified
6. What Passed - Success criteria met
7. What Failed Or Remains Unknown - Blockers, uncertainties, risks
8. Notes For Next Agent - Context for downstream workers
9. Recommended Next Prompt - Suggested next action

Structured Handoff

Use kanban_complete(summary=..., metadata=...) to provide machine-readable handoff:

kanban_complete(
    summary="shipped rate limiter — token bucket, keys on user_id with IP fallback, 14 tests pass",
    metadata={
        "changed_files": ["rate_limiter.py", "tests/test_rate_limiter.py"],
        "tests_run": 14,
        "tests_passed": 14,
        "decisions": ["user_id primary, IP fallback for unauthenticated requests"],
    },
)