Prompt file imported from Pranav-Shivam/CodingAgents (
.claude/commands/learn.md). Copyright stays with the author.
Capture session learnings to docs/gotchas.md. Only extract what future Claude sessions won't know from reading the code.
Steps:
- Read
docs/gotchas.md— know what's already captured - Scan this session for:
- Non-obvious bugs discovered and why they happened
- Tool/command quirks (flags, platform differences, version issues)
- Agent behavior patterns that surprised you
- Workarounds for specific constraints
- Anything a new Claude session would get wrong without this note
- Filter ruthlessly: skip anything derivable from the code or docs
For each lesson worth saving, write one compact entry:
## <topic>
- <specific, actionable fact> — <why it matters or when it bites you>
Output: proposed additions only. Present them. Ask user to approve before writing.
After approval: prepend entries to docs/gotchas.md under the <!-- New entries added here by /learn --> comment.
Rules:
- No generic best practices — only project/tool-specific observations
- No "remember to X" — only specific facts with concrete consequences
- If nothing new discovered: say "Nothing new to capture."
