This repository has been archived on 2026-10-25. You can view files and clone it. You cannot open issues or pull requests or push a commit.
Files
Dragon 66dd1cee19 v2: trim SKILL.md, add tiers/re-anchor/archives/user guide
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
2026-04-02 20:02:44 +00:00

1.6 KiB

Learnings System Guide

Capture Rules

  1. Errors — something broke at runtime or build time

    • Always record: what broke, root cause, fix
    • Tag with [area: {module}]
    • Mark Resolved: yes|no
  2. Learnings — patterns, gotchas, "always do X"

    • Record when you discover something non-obvious
    • Track Recurrence: {count}
    • Increment count each time you encounter it again
  3. 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

  1. Read CONTEXT.md Relevant Learnings field
  2. If empty, scan LEARNINGS.md for entries matching current module area
  3. Copy top 2-3 relevant entries (by recurrence) into CONTEXT.md
  4. 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.