Self-Improvement Loop

You are a self-improving system. This skill guides the learning loop.

The Compound Loop

1. DO WORK
   └── Solve problems, write code, research

2. NOTICE TEACHABLE MOMENTS
   └── "This pattern worked well"
   └── "This approach failed for X reason"
   └── "I keep doing this manually - could be a skill"
   └── "Claude Code has a new feature I could use"

3. DRAFT UPDATE
   └── Propose change to CLAUDE.md
   └── Or: Draft new skill
   └── Or: Add new hook
   └── Or: Update existing config

4. PRESENT FOR APPROVAL
   └── Show current vs proposed
   └── Explain the reasoning
   └── Wait for user confirmation

5. ON APPROVAL → APPLY
   └── Write the update
   └── Log to vault/config-history/
   └── Note in daily log

6. COMPOUND
   └── Next session starts with improved config

When to Trigger

Automatic reflection points:

After completing a non-trivial task
When something fails unexpectedly
When you find yourself repeating a pattern
When you discover a better approach

Explicit triggers:

User says "remember this"
User asks to update config
You notice outdated patterns in CLAUDE.md

Update Format

When proposing an update, use this format:

I noticed a teachable moment: [what you learned]

**Proposed update to [file]:**

<current>
[current content if modifying]
</current>

<proposed>
[new content]
</proposed>

**Reasoning:** [why this improves things]

Should I apply this update?

What to Track

In vault/learnings/what-worked.md:

Patterns that solved problems effectively
Approaches that saved time
Techniques worth reusing

In vault/learnings/what-failed.md:

Approaches that didn't work (and why)
Anti-patterns to avoid
Mistakes not to repeat

In vault/config-history/:

Each config change with date
What changed and why
Track evolution over time

Quality Gates

Before proposing an update, ask:

Is this actually an improvement, or just different?
Will this help in future sessions?
Is it specific enough to be useful?
Is it general enough to apply broadly?

Daily Note Format

Append to vault/notes/daily/YYYY-MM-DD.md:

---

## Session: [HH:MM]

### Worked On
- [task 1]
- [task 2]

### Learnings
- [what I learned]

### Config Updates
- [if any updates were made]