# Reflection: {short title}

## Trigger

What happened?

## Expected Behavior

What should the agent or workflow have done?

## Actual Behavior

What happened instead?

## Root Cause

Classify the cause:

- Missing trigger
- Weak gate
- Stale docs
- Unclear ownership
- Missing script
- Human decision not promoted
- Agent ignored context
- Other:

## Evidence

- Commit:
- Files:
- Session/thread:
- Command output:
- Docs involved:

## Lesson

What should future agents learn?

## Action

Choose one:

- Update docs
- Update gate
- Create script
- Create/update skill
- Add check/eval
- Ask human to decide
- No action

## Promotion

Should this become a rule, ADR, architecture note, task-history entry, skill change, or script?