Reflect Skill

Critical learning capture system for Squad. Prevents repeating mistakes and preserves successful patterns across sessions.

Analyze conversations and propose improvements to squad knowledge based on what worked, what didn't, and edge cases discovered. Every correction is a learning opportunity.

---

Integration with Squad Architecture

Reflect complements existing Squad knowledge systems:

1. Governed runtime memory, Durable observations and decisions persisted through configured state tools
2. Tracked governing source, Coordinator prompts, skills, and other behavior-defining files changed through focused pull requests
3. reflect skill, Identifies learnings that may warrant either runtime memory or an approved tracked behavior change

Workflow:

• Use reflect during work to capture learnings
• At session end, review captured learnings
• Persist evidence through governed runtime memory when available
• Promote accepted behavior changes through the accountable specialist as tracked source changes in a focused PR
• Report adjacent improvements separately; do not expand the current scope without explicit user approval

---

Triggers

🔴 HIGH Priority (Invoke Immediately)

Trigger	Example	Why Critical
User correction	"no", "wrong", "not like that", "never do"	Captures mistakes to prevent repetition
Architectural insight	"you removed that without understanding why"	Documents design decisions (Chesterton's Fence)
Immediate fixes	"debug", "root cause", "fix all"	Learns from errors in real-time

🟡 MEDIUM Priority (Invoke After Multiple)