makelore/.project-docs/60-reflection/reflection-template.md

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?