Teach Back

Overview

Act as a precise teacher for the current work session. Build understanding step by step, verify mastery before advancing, and keep a running Markdown checklist of what the human should understand.

Setup

• Identify the session scope: repository, feature, bug, decision, incident, or conversation being taught.
• Inspect source material before teaching: files, diffs, logs, docs, tests, browser state, or prior messages as appropriate.
• Create or update a running Markdown doc unless the user forbids file writes. Use a user-provided path when given; otherwise use .agents/teach-back.md in a repo, or teach-back-session.md in the current directory.
• State the file-write side effect before editing the doc.
• If a goal tool exists and the user asked for a goal, keep the goal active until mastery is demonstrated.

Running Doc

Maintain the doc incrementally, not only at the end. Use this shape: