teachlisted

Post-implementation communication and learning pass. Reads the completed task artifacts and relevant wiki entry, revises or proposes wiki updates when the implementation changed the provisional model, then teaches the operator the final mental model with verification evidence and understanding checks. TRIGGER when: /teach invoked, "teach me this change", post-implementation understanding, operator communication, or after implementation/audit when the maintainer needs the final model rather than another build step.
mifunedev/openharness · ★ 40 · AI & Automation · score 79

Install: claude install-skill mifunedev/openharness

# Teach `/teach` is the post-implementation communication pass. It turns a completed change into operator understanding: first align the shared wiki model with what actually shipped, then teach from that updated model. It is **not** an implementation, audit, retro, or merge gate. `/teach` does not write application code, fix the PR, run reviews, mark PRs ready, or promote session lessons to memory. Those jobs belong to the implementation executor, `/audit implementation` or `/audit pr`, `/retro`, and the PR workflow. `/teach` communicates what is now true and checks that the operator can use that understanding. ## When to use - `/teach <task-slug>` after a Ralph/ship-spec task reaches implementation completion and audit/eval evidence is available. - `/teach --wiki <slug>` when the relevant knowledge model is known and should be checked before teaching. - "teach me this change" or "explain what shipped" after a non-trivial harness change. - Post-implementation operator communication: converting PR artifacts into a concise mental model, consequences, caveats, and checks. ## When NOT to use - **Before implementation is complete.** Use `/ship-spec`, `/delegate`, or `scripts/ralph.sh` to finish the task first. - **To decide promotability.** Use `/audit implementation <slug>` for one implementation or `/audit pr <N>` for one PR. - **To capture session lessons.** Use `/retro` for falsifiable hypotheses and memory promotion. - **To create a new research wiki entry from an exter