teach

Solid

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.

AI & Automation 38 stars 3 forks Updated today Apache-2.0

Install

View on GitHub

Quality Score: 83/100

Stars 20%
53
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# 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...

Details

Author
mifunedev
Repository
mifunedev/openharness
Created
5 months ago
Last Updated
today
Language
TypeScript
License
Apache-2.0

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

teach

Teach repository-backed code and engineering work through a progressive, evidence-grounded conversation. Manual invocation only; use when the user explicitly invokes teach to understand a change, subsystem, architecture, runtime behavior, or evidenced rationale. Read-only; do not modify files.

1 Updated today
drafael
AI & Automation Solid

teach-me

Teach the learner to deeply understand a body of work — the current session's changes, a PR, an ADR, or any topic they name — the problem and why it existed, the solution and why it was built that way, and why it matters, incrementally and confirming mastery at each stage before advancing. Use when the user wants to understand what was just built or changed, asks to be taught or walked through a change, or wants to learn the why behind the work — e.g. "teach me what we did", "teach me this PR", "explain this ADR".

73 Updated 3 days ago
doodledood
AI & Automation Listed

teach

Teach the user a topic, concept, or skill so they actually understand it and can do it themselves — not just hand over information. Use when the user asks to be taught, wants to learn or understand something, says they don't get a concept, asks you to explain so it sticks, or wants to be walked through how something works. Examples — "teach me X", "explain X so I get it", "help me learn Y", "I don't understand Z", "walk me through how W works", "I have no idea about V". Do not use for quick factual lookups where the user just wants the answer and moves on.

1 Updated today
Vironnimo