orc-learn

Run /orc-learn and pick one feature, either from the wiki's feature areas or by pointing at a directory with a focus hint. The skill dispatches a writer agent that maps the feature's functions, traces one real call flow, and writes learning.md and knowledge.md under learning-docs/<feature>/.

Run /orc-learn refresh to list every generated feature with a computed FRESH, AGING, or STALE flag based on git distance and drift since the recorded source_commit. You multi-select which features to regenerate; unselected features are left byte-untouched.

Yes. Without a wiki, or with a stale one, the skill asks you to point at the feature via a directory or focus hint and the writer performs a targeted scan of only those files, never a repo-wide scan.

No. The learning-docs directory is local and git-ignored; each developer regenerates their own copy. The skill offers to append a learning-docs/ line to .gitignore only after explicit confirmation.

learning.md is the pedagogical half: mental model, guided walkthrough, change recipes, gotchas, and a minimum five-question FAQ. knowledge.md is the reference half: file:line-anchored functions and flow, contracts, extension points, verify commands, and the fingerprint header used for freshness checks.