ml-retain

Meta-Loop: Learning Retention

Capture session learnings in documentation before clearing context.

Modes: Plan Mode → Agent Mode

Prerequisites

This skill implements Step 4 of the Meta-Loop process defined in skills/meta-loop-methodology/SKILL.md.

Use this after a successful implementation pass (/ml-impl review passed).

---

Phase 1: Plan (Plan Mode)

Enter plan mode and create a plan for documentation updates.

1.1 Review Session Changes

Analyze what happened in this session:

1. Check git status and diff:

   • What files were created?
   • What files were modified?
   • What's the scope of changes?

2. Read the feature's notes.md (if this session followed the Meta-Loop):

   • Located in the spec directory (e.g., specs/views/{name}/notes.md)
   • Contains decisions from wireframe, spec, and implementation phases
   • Review for learnings that should be promoted to CLAUDE.md or doc/

3. Identify learnings:

   • What patterns emerged?
   • What decisions were made?
   • What documentation gaps were discovered?
   • What issues required workarounds?

4. Check current documentation state:

   • Read TODO.md for task tracking
   • Read CLAUDE.md for current context
   • Note any outdated information

1.2 Create Documentation Plan

Plan updates to these files:

TODO.md Updates:

• Tasks completed this session
• New tasks discovered
• Phase/milestone status changes

CLAUDE.md Updates (keep concise!):

• New patterns that should be quick-reference
• Updated file references if structure changed
• Removed outdated content
• ⚠️ Keep under 40k characters total

New doc/ Files (if detailed knowledge needed):

• Complex patterns that need explanation
• Architectural decisions with rationale
• Anti-patterns with examples
• Guides that would bloat CLAUDE.md

1.3 Present Plan to Developer

## Learning Retention Plan

### Session Summary
[1-2 sentence summary of what was accomplished]

### TODO.md Updates
**Move to Completed:**
- [ ] [Task that was completed]

**Add to Next Up:**
- [ ] [New task discovered]

**Milestone Update:**
- [Any phase/milestone status change]

### CLAUDE.md Updates
**Add:**
- [New section or entry]

**Update:**
- [Section to modify]

**Remove:**
- [Outdated content to delete]

### New Documentation Files
| File | Purpose |
|------|---------|
| `doc/[name].md` | [What it documents] |

### Git Commit
**Suggested message:**
> [Descriptive commit message]

Ready to proceed?