error-memory

Error Memory

Document errors to avoid repeating them.

Trigger

Invoke when:

• Build/tests fail after your action
• User corrects you
• You realize a wrong approach
• You forget a project convention
• Unexpected behavior occurs

Process

1. Identify error type

   • tech : build, tests, syntax, runtime
   • ctx : conventions, patterns, project stack
   • comp : misunderstood requirements

2. Analyze root cause (not symptom)

3. Formulate fix as reusable rule

4. Append line to .claude/errors.md:

   | MM-DD | type | Short error | Root cause | Rule to follow |
   

5. Create file if missing with this template:

   # Project Errors
   
   > Past Claude mistakes on this project. Check before acting.
   
   | Date | Type | Error | Cause | Fix |
   |------|------|-------|-------|-----|
   
   ## Legend
   - **tech** : Technical (build, tests, syntax)
   - **ctx** : Context (conventions, patterns)
   - **comp** : Comprehension (misunderstood request)
   

Rules

• One line = one error (no paragraphs)
• Fix = actionable rule, not excuse
• Cause = why, not what
• Keep < 100 lines (archive if needed)
• Check errors.md before acting on any project