After task completion, capture reusable lessons learned into docs/learnings/ for future reference.
Use this skill after task completion to capture reusable insights that might benefit future work. This captures knowledge, not debt — debt and deferred work belong in /follow-up-triage.
tasks/current.md, focusing on:
## Review Findings## Understanding Remediation## Override / Audit Note## Notesdocs/learnings/ for existing related lessons:
docs/learnings/ using the filename format
YYYY-MM-DD-short-description.md with:
date, task (story ID), category, tags (list)## Problem / Context## Discovery## Solution / Pattern## Why It Works## When To Apply## Related (links to other learnings, decisions, or docs)## Recommended Workflow Update section at the end of the
lesson file. Do not auto-edit skills or rules — surface the recommendation
for the user to act on.CLAUDE.md or AGENTS.md reference docs/learnings/.
If not, note it but do not add references automatically./follow-up-triage captures. If it is debt, it goes
to the backlog or issues. If it is knowledge, it goes here.