Learn from Mistakes

You made a mistake. Good – this is an opportunity to prevent it from happening again.

Process

1. Analyze the Mistake

Identify:

• What went wrong: The specific action or omission
• Why it happened: The reasoning or assumption that led to the mistake
• Correct behavior: What should have been done instead

2. Formulate the Lesson

Create a concise entry for AGENTS.md:

• Common Mistake: Brief description of the anti-pattern (what NOT to do)
• Correct Behavior: Clear instruction of what TO do instead

The lesson should be:

• Actionable (tells you exactly what to do)
• Specific (not vague platitudes)
• Generalizable (applies beyond this one instance)

3. Find the Right Section

Read AGENTS.md and identify which section the lesson belongs in:

• General: Cross-cutting concerns, workflow issues, process mistakes
• TypeScript: Language-specific patterns
• Database: Migration and schema issues
• Orchestration Model: Agent/skill workflow issues
• Or create a new section if none fits

4. Update AGENTS.md

Add a new row to the appropriate table:

| <Common Mistake> | <Correct Behavior> |

5. Confirm the Update

Read back the updated section to verify the entry is clear and correctly formatted.

Example

If the mistake was “Ignored reviewer feedback about missing integration test”:

| Ignoring review findings marked "Should fix" or "NEEDS USER DECISION" | Address ALL review findings before proceeding. If flagged as "NEEDS USER DECISION", ask the user. Never skip items marked "Should fix (Important)" |

Arguments

$ARGUMENTS