ckb/.agents/skills/ckb-teach-me/references/edge-cases.md
Michał Kopeć 7863115b74 Template 1.10.0: slim skills, review fixes, docs/, tests, retrieval script
- 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>
2026-09-24 20:45:09 +02:00

1.8 KiB

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 at the repository root, or http://www.apache.org/licenses/LICENSE-2.0.