Archived
Changes: - SKILL.md cut to ~1400 tokens (from ~2500+) - Schema examples moved to references/ - Project tiers: Nano/Small/Large - Mid-session re-anchor rule (every 15+ tool calls) - SESSIONS + ERRORS + LEARNINGS archives - Wrong-turn report format with error logging - Collapsed session end to 5 steps + self-reflection - Pending errors check at session start - DEPS.md template for dependency tracking - learnings-guide.md reference doc - GUIDE.md: comprehensive user guide (shared with SmallClaw) - README.md rewritten with comparison table
1.6 KiB
1.6 KiB
Learnings System Guide
Capture Rules
-
Errors — something broke at runtime or build time
- Always record: what broke, root cause, fix
- Tag with
[area: {module}] - Mark
Resolved: yes|no
-
Learnings — patterns, gotchas, "always do X"
- Record when you discover something non-obvious
- Track
Recurrence: {count} - Increment count each time you encounter it again
-
Feature Requests — user asked for something not in PLAN.md
- Record with priority
- Suggest adding to PLAN.md if high priority
Promotion Rules
At session end, scan learnings:
| Condition | Action |
|---|---|
| Recurrence >= 3, project-specific | Promote to ARCH.md Decisions Log |
| Recurrence >= 3, workspace pattern | Suggest to user for SOUL.md/AGENTS.md |
| Error resolved + learning captured | Mark error resolved, keep learning |
| Feature request accepted | Move to PLAN.md, remove from requests |
Never put project-specific learnings in SOUL.md. Never put workspace-wide patterns in ARCH.md.
Session Start Filtering
- Read CONTEXT.md
Relevant Learningsfield - If empty, scan LEARNINGS.md for entries matching current module area
- Copy top 2-3 relevant entries (by recurrence) into CONTEXT.md
- Budget: ~50 tokens
Archive Rules
| File | Max entries | Archive name |
|---|---|---|
| ERRORS.md | 20 | ERRORS-ARCHIVE.md |
| LEARNINGS.md | 20 | LEARNINGS-ARCHIVE.md |
| FEATURE_REQUESTS.md | 20 | (move accepted to PLAN.md) |
Archive criteria:
- Errors: resolved = yes
- Learnings: promoted to ARCH.md
- Feature requests: accepted into PLAN.md or declined
Archives are write-only. Read only during escape hatch step 4.