Self Reflection

---
name: Self Reflection
slug: reflection
version: 1.1.0
homepage: https://clawic.com/skills/reflection
description: Learns when to stop and review. Self-critiques before showing you, fewer revision rounds.
metadata: {"clawdbot":{"emoji":"🪞","requires":{"bins":[]},"os":["linux","darwin","win32"],"configPaths":["~/reflection/"]}}
changelog: Major rewrite. Visual workflow, pattern detection system, proactive lesson injection, and multi-trigger architecture.
---

Agents repeat mistakes. Not because they're incapable — because they forget. This skill changes that. Your agent pauses before delivering, catches its own blind spots, and remembers lessons for next time.

## When to Use

User needs quality assurance beyond "looks good to me." Agent handles pre-delivery evaluation, post-mistake analysis, pattern detection across sessions, and proactive lesson surfacing before repeating errors.

## How It Works

```
         ┌──────────────────────────────────────────────┐
         │              SELF REFLECTION LOOP            │
         └──────────────────────────────────────────────┘
                              │
         ┌────────────────────┼────────────────────┐
         ▼                    ▼                    ▼
    ┌─────────┐         ┌──────────┐         ┌─────────┐
    │  PRE    │         │  POST    │         │PATTERN  │
    │DELIVERY │         │ MISTAKE  │         │DETECTED │
    └────┬────┘         └────┬─────┘         └────┬────┘
         │                   │                    │
         │  "Before I send   │  "User corrected   │  Same mistake
         │   this, let me    │   me. Why?"        │  3 times...
         │   double-check"   │                    │
         │                   │                    │
         └───────────────────┴────────────────────┘
                              │
                              ▼
                    ┌─────────────────┐
                    │ 7-DIMENSION     │
                    │ EVALUATION      │
                    │ (30 seconds)    │
                    └────────┬────────┘
                              │
              ┌───────────────┴───────────────┐
              ▼                               ▼
       ┌─────────────┐                 ┌─────────────┐
       │  ALL CLEAR  │                 │ ISSUE FOUND │
       │  Deliver    │                 │ Fix first   │
       └─────────────┘                 └──────┬──────┘
                                              │
                                              ▼
                                    ┌─────────────────┐
                                    │  LOG LESSON     │
                                    │  Miss → Root    │
                                    │  → Prevention   │
                                    └────────┬────────┘
                                              │
                                              ▼
                                    ┌─────────────────┐
                                    │  INJECT NEXT    │
                                    │  TIME           │
                                    │  "Before we     │
                                    │   proceed..."   │
                                    └─────────────────┘
```

## The Three Triggers

### 1. 🔍 Pre-Delivery
Before sending important work, pause. 30 seconds. Quick scan of 7 dimensions.

**When:** Code, architecture, strategy, any deliverable the user will act on.

### 2. ❌ Post-Mistake  
User corrected you. That's data. Capture it before the session ends.

**When:** User says "actually...", "no, that's wrong", "I meant...", frustration signals.

### 3. 🔄 Pattern Detection
Same category appearing 3+ times? That's not coincidence — it's a blind spot.

**When:** After logging 5 reflections, weekly review, or heartbeat trigger.

## Architecture

Memory lives in `~/reflection/`. See `memory-template.md` for setup.

```
~/reflection/
├── memory.md           # Status + preferences + stats
├── reflections.md      # Log (most recent first)
├── patterns.md         # Detected patterns
└── archive/            # Monthly archives
```

## Quick Reference

| Topic | File |
|-------|------|
| Setup process | `setup.md` |
| Memory template | `memory-template.md` |
| Evaluation dimensions | `dimensions.md` |
| Reflection prompts | `prompts.md` |

## Core Rules

### 1. Check Lessons Before Acting
Before significant work, scan `~/reflection/patterns.md`. Surface relevant lessons:
> "Before we proceed — I have a lesson from past work on [topic]: [summary]."

### 2. Use 7-Dimension Evaluation

| # | Dimension | Question |
|---|-----------|----------|
| 1 | Correctness | Does it solve the stated problem? |
| 2 | Completeness | Edge cases covered? Assumptions stated? |
| 3 | Clarity | Immediately understandable? |
| 4 | Robustness | What could break this? |
| 5 | Efficiency | Unnecessary complexity? |
| 6 | Alignment | What user actually wants? |
| 7 | Pride | Would I sign my name on this? |

If any dimension scores below 7/10 → fix before delivering.

### 3. Log Every Correction
When user corrects you:
1. STOP and acknowledge
2. Analyze root cause
3. Log to `~/reflection/reflections.md`:
```
## YYYY-MM-DD | [category]
**Miss:** What went wrong
**Root:** Why (5 whys)
**Fix:** Prevention rule
```

### 4. Detect Patterns (After 5 Reflections)
- Same category 3+ times → create prevention rule
- Same mistake twice → escalate to pattern
- Improvement trend → document what worked

### 5. Categories for Every Reflection
Default: `technical`, `communication`, `assumptions`, `process`, `scope`

### 6. Archive Monthly
Move processed reflections to `~/reflection/archive/YYYY-MM.md`. Keep `reflections.md` lean.

### 7. Track Streaks
Days since repeated mistake. Resets on pattern recurrence. Celebrate milestones.

## Pattern Lifecycle

```
┌──────────────┐     ┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│   EMERGING   │ ──▶ │    ACTIVE    │ ──▶ │  MONITORING  │ ──▶ │   RESOLVED   │
│  2 similar   │     │  3+ times    │     │  Prevention  │     │  30 days     │
│  reflections │     │  → create    │     │  in place    │     │  clean       │
└──────────────┘     │    rule      │     └──────────────┘     └──────────────┘
                     └──────────────┘
```

Patterns in `~/reflection/patterns.md`:
```markdown
## [Pattern Name]
category: technical
frequency: 4 occurrences
status: active | monitoring | resolved

**Pattern:** What keeps happening
**Root:** Why this pattern exists
**Prevention:** Rule to break it
**Last seen:** YYYY-MM-DD
**Streak:** X days without recurrence
```

## The "Inject Next Time" Superpower

The skill's real value: surfacing lessons BEFORE you repeat mistakes.

**How it works:**
1. Before starting work, identify task domain
2. Check `~/reflection/patterns.md` for active patterns
3. If relevant pattern exists → mention it naturally

**Example:**
> "Before we build this API — I have a lesson about timeout handling from a previous project. Let me make sure to include proper error timeouts this time."

## Setup

On first use, read `setup.md` for integration guidelines. Creates memory files in `~/reflection/` (user is informed where data is stored if they ask).

## Common Traps

| Trap | Consequence |
|------|-------------|
| Reflecting without logging | Lesson lost with session |
| Vague root causes | "Made mistake" doesn't prevent recurrence |
| No prevention rule | Same mistake WILL happen again |
| Ignoring patterns | Individual mistakes are noise; patterns are signal |
| Over-reflecting | 30 seconds pre-delivery, not 5 minutes |

## Related Skills
Install with `clawhub install <slug>` if user confirms:
- `memory` — persistent memory patterns
- `decide` — decision-making autonomy
- `learning` — adaptive learning system

## Feedback

- If useful: `clawhub star reflection`
- Stay updated: `clawhub sync`