# Reflect

Learning capture system that extracts HIGH/MED/LOW confidence patterns from...

- Repository: https://github.com/microsoft/waza (1496 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-10-31
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add microsoft/waza --skill reflect -g -a claude-code -y`
Codex: `npx skills add microsoft/waza --skill reflect -g -a codex -y`
Cursor: `npx skills add microsoft/waza --skill reflect -g -a cursor -y`
Gemini CLI: `npx skills add microsoft/waza --skill reflect -g -a gemini-cli -y`

## Description

Learning capture system that extracts HIGH/MED/LOW confidence patterns from conversations to prevent repeating mistakes. Use after user corrections ("no", "wrong"), praise ("perfect", "exactly"), or when discovering edge cases. Complements .squad/agents/{agent}/history.md and .squad/decisions.md.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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)

The rest: https://github.com/microsoft/waza/blob/HEAD/.github/skills/reflect/SKILL.md