From 6bcf0d81dbf8efd3d4d72d135018d1f44447c116 Mon Sep 17 00:00:00 2001 From: chtnnh <59027776+chtnnh@users.noreply.github.com> Date: Mon, 24 Aug 2026 17:12:44 +0400 Subject: [PATCH] fix(docs): update order for know-code taught seal in agent and human docs Know-Code-Verified: ea53884420ab9b9d3935dee90c39602824b352fe040d7847c373487252689c86 --- skills/know-code-teach/SKILL.md | 4 ++-- skills/know-code-teach/references/explain-playbook.md | 2 +- website/docs/skills.md | 4 ++-- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/skills/know-code-teach/SKILL.md b/skills/know-code-teach/SKILL.md index cebc729..87556e6 100644 --- a/skills/know-code-teach/SKILL.md +++ b/skills/know-code-teach/SKILL.md @@ -49,11 +49,11 @@ While coding, keep explanations **incremental**: after meaningful chunks, narrat | `know-code-teach` | Build understanding **before/during** work | | `know-code` | Verify understanding before commit/push/PR | -**Required order:** `range begin` → teach → human seals `know-code taught` → edit → (teach deltas) → `questions` → quiz → ask → agent `grade-proposal.json` → human `grade --review` → `pass` → `know-code commit` → `range seal` / push. +**Required order:** `range begin` → teach → implement and stage the final diff → human seals `know-code taught` → `questions` → quiz → ask → agent `grade-proposal.json` → human `grade --review` → `pass` → `know-code commit` → `range seal` / push. Re-seal **`know-code taught`** when the diff hash changes (`know-code hash`). -After teaching (or an explicit human skip), the **human** seals the artifact (passphrase; agents cannot forge): +After teaching, implementation, and staging (or an explicit human skip), the **human** seals the final artifact (passphrase; agents cannot forge): ```bash know-code taught diff --git a/skills/know-code-teach/references/explain-playbook.md b/skills/know-code-teach/references/explain-playbook.md index 09246e8..7f47adb 100644 --- a/skills/know-code-teach/references/explain-playbook.md +++ b/skills/know-code-teach/references/explain-playbook.md @@ -32,7 +32,7 @@ Ask for a decision only when it matters. Examples: ## After the first teach beat -Ask the human to seal understanding for the current quiz hash (`know-code hash`): +After the final intended diff is staged, ask the human to seal understanding for the current quiz hash (`know-code hash`): ```bash know-code taught diff --git a/website/docs/skills.md b/website/docs/skills.md index 153f6fe..39c4d14 100644 --- a/website/docs/skills.md +++ b/website/docs/skills.md @@ -28,8 +28,8 @@ Skip only if you explicitly say so ("skip teach", "just do it") — then you sti | Step | Who | Action | |------|-----|--------| | 1 | **You** | `know-code range begin` (multi-commit batches) | -| 2 | **Agent** | Teach (or you skipped) | -| 3 | **You** | `know-code taught` | +| 2 | **Agent** | Teach, implement, and explain the final staged diff (or you skipped) | +| 3 | **You** | `know-code taught` for that final staged hash | | 4 | **Agent** | `questions` → write `quiz.json` → `quiz validate` | | 5 | **Agent** | `know-code ask` → **you** answer in browser | | 6 | **Agent** | Write `grade-proposal.json` |