- Skills: descriptions cut to routing-hint length (1925w -> 840w), Trigger
phrases removed, Purpose collapsed, Edge cases moved to references/.
- Rule B names the decisions-log exception; "Sync the wiki" trigger dropped;
reserved sections "Four" -> "Three"; directory contract adds ckb.yaml,
docs/, tests/.
- MANUAL/CHANGELOG/OPENSPEC (EN+PL) moved to docs/; template ADRs D-0001 and
D-0002 restored from 0c06cb6 into docs/decisions/; referrers repointed.
- ckb-retrieve: rank fusion moved into scripts/retrieve_candidates.py;
Purpose states the one write it owns (query-gaps).
- tests/: fixture KB, golden JSON, smoke.sh.
- Scaffold: overview.md describes content not schema; graph/index.md names
base skills only; query-gaps.md loses its self-rotting freshness window.
- README/MANUAL/OPENSPEC/CHANGELOG ghost-writer pass in both languages.
- VERSION 1.9.0 -> 1.10.0.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
33 lines
1.8 KiB
Markdown
33 lines
1.8 KiB
Markdown
# ckb-teach-me — edge cases
|
|
|
|
Reference material for the `ckb-teach-me` skill. Read when a
|
|
run hits an unusual situation the main steps don't cover.
|
|
|
|
- **No wiki content in scope.** Tell the user the topic isn't covered
|
|
yet, same as the `quiz` skill would — suggest a narrower topic or an
|
|
Ingest first. Don't fabricate a curriculum from nothing.
|
|
- **Topic scope changes between Plan and Teach calls** (user asks to
|
|
teach something broader/narrower than the saved plan). Treat this as a
|
|
new topic — create a new `outputs/teaching/<new-slug>/` rather than
|
|
overwriting the existing plan, since the old one may still be in
|
|
progress.
|
|
- **User wants to abandon or restart a course.** Ask for confirmation,
|
|
then either delete the folder (only with explicit confirmation — this
|
|
is a destructive action) or archive `progress.md` with a note and start
|
|
a fresh `plan.md` if they want to redo the scoping.
|
|
- **Plan and progress disagree** (e.g. plan.md was hand-edited, or a
|
|
session number in progress.md doesn't exist in plan.md). Point it out
|
|
to the user and ask how to reconcile rather than silently guessing.
|
|
- **Course fully completed and user asks to "teach me" again on the same
|
|
topic.** Don't silently restart — tell them the course is complete and
|
|
ask whether they want a fresh, deeper course, a review/quiz pass, or a
|
|
different topic.
|
|
- **Very long-running series** (many sessions already logged) — no need
|
|
to re-read every past `progress.md` entry in full each time; the `Next
|
|
up` line and the most recent 1-2 session entries are enough context to
|
|
continue. Older entries are history, not required reading.
|
|
|
|
---
|
|
|
|
*Licensed under the Apache License, Version 2.0 — see [LICENSE](../../../LICENSE)
|
|
at the repository root, or <http://www.apache.org/licenses/LICENSE-2.0>.*
|