rc-lessonslisted

Deterministic loop-lessons machine — records grounded engineering lessons from verification signals (AC gaps, surviving mutants, spec deviations, gate failures) and loads the corroborated ones at plan/design time, so autonomous or repeated loops stop re-making the same mistake. All bookkeeping (IDs, distinct-feature recurrence, candidate→confirmed promotion, quarantine, prune) is owned by scripts/lessons.mjs, not prose. Use to record a lesson after a verify/review failure, or to load confirmed lessons before planning a task or roadmap phase. Do not use for user-correction trigger→action learnings (rc-memory), per-task working notes (rc-workflow-memory), or on-demand reflection on a diff.
rodolfochicone/rc-project · ★ 19 · AI & Automation · score 79

Install: claude install-skill rodolfochicone/rc-project

# Loop Lessons The learning layer that makes RC loops *safe to repeat*. Every time verification catches a defect, the reason it slipped through is captured as a **grounded lesson**; before the next task or roadmap phase is planned, the **corroborated** lessons are loaded as guidance. A one-off is never trusted — a lesson is only promoted after it recurs across **two distinct features**, and is quarantined if it ever fails when applied. **The script owns the bookkeeping.** IDs, recurrence counting, promotion, quarantine, and pruning are mechanical and rot when done by hand, so they live in `scripts/lessons.mjs` (deterministic, dependency-free) — never re-implement them in prose or edit the store by hand. - Canonical store: `.rc/lessons.json` (machine-owned — do **not** hand-edit) - Rendered playbook: `.rc/LESSONS.md` (regenerated on every write) Invoke the script via the plugin root: ```bash node "$CLAUDE_PLUGIN_ROOT/scripts/lessons.mjs" <command> --root <project-root> [flags] ``` `--root` is the directory that contains `.rc/` (default `.`). Run `--selftest` to verify the lifecycle offline. ## When to RECORD a lesson (write) Record **only** at a verification/review boundary, and **only** with real grounding — a lesson with no `file:line` / AC id / mutant id / SPEC_DEVIATION reference is an opinion, and the script refuses it. Record when a `rc-execute-task` / `rc-final-verify` / `rc-code-review` / `rc-review-round` pass catches: | Signal | Use when | | --- | --- | | `a