Reflect

Success Criteria

• Every mistake/friction point cites the specific moment and its impact
• Improvements are actionable, prioritized, and <= 10 items
• Each skill audit proposes measurable changes (not vague suggestions)
• User is asked which items to persist to memory

Process

1. Session Review

Scan the full conversation. For each finding, cite the specific exchange (quote or paraphrase) and its impact.

Category	Signal
Mistakes	Wrong outputs, incorrect assumptions, hallucinated facts
Friction	Repeated clarifications, verbose responses, misread intent
Wasted effort	Work discarded, wrong approaches tried first
Wins	Approaches worth repeating, smooth interactions

Skip one-time typos, external tool failures, and issues outside agent control.

2. Improvements

Numbered list of concrete improvements, ranked by impact. Each item: one sentence, imperative, actionable. Cap at 10.

Ask: "Which of these should I remember for future chats?"

Save approved items to memory files via the auto memory system.

3. Skill Audit (if skills were used)

For each skill invoked during the session:

A. Self-check gate — If the skill lacks success criteria + verification loop:

• Add ## Success Criteria at top (3-5 measurable checks)
• Add ## Self-Check at bottom: "Verify all success criteria are met before presenting output. If not, iterate (max 5 times)."

B. Token efficiency — Flag: redundant phrasing, mergeable sections, oversized examples, "Claude already knows this" content, inert frontmatter metadata.

C. Other — Missing edge cases, vague directives (rewrite as measurable criteria or remove), naked negations (add "do Y instead" or remove).

Present proposed changes as diffs. Ask: "Apply these? (all / pick / skip)"

4. Pattern Detection

If 2+ similar tasks appear that no existing skill covers, suggest a new skill (1-2 sentence description). Create only after confirmation.

Proactive Trigger

When the user corrects you, clarifies the same thing twice, or shows frustration — append:

Tip: Type /reflect when you're ready — I'll review what we can improve.

Self-Check

Before presenting output, verify all success criteria are met. If any fail, revise (max 5 iterations).