---
name: error-memory
description: >
  Use when: making a mistake, breaking build/tests, realizing wrong approach,
  misunderstanding requirements, using wrong patterns, forgetting conventions,
  receiving correction from user, unexpected behavior, or any error situation
---

# 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`:
   ```markdown
   | MM-DD | type | Short error | Root cause | Rule to follow |
   ```

5. **Create** file if missing with this template:
   ```markdown
   # 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