record-a-case
Record a case
Treat the case as an evidence ledger. Preserve what happened before extracting a method. Promotion is a separate process.
Canonical write root
Before writing, resolve the canonical Railly/skills checkout through RAILLY_SKILLS_REPO, ~/Programming/railly/skills, or ~/railly-skills. The canonical resolver is scripts/resolve-source-root.mjs. Never write a case, eval, or log into the current repo's .agents/skills, .claude/skills, another installed skill copy, or the target repository. If the source root is unavailable, return the draft and report the blocked write.
1. Bound one case
Name the maintenance unit: one issue, PR, incident, review, disproven claim, or coherent batch with one transferable lesson. Split unrelated outcomes even when they occurred in the same session.
Complete when: every included outcome shares one mechanism and one transferable lesson.
2. Build the ledger
Inventory evidence before prose. Collect durable retrieval handles: