ckb/.agents/skills/ckb-decide/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.5 KiB

ckb-decide — edge cases

Reference material for the ckb-decide skill. Read when a run hits an unusual situation the main steps don't cover.

  • No wiki/decisions/ directory yet — create it along with index.md and log.md (using the scaffold this template ships), then record the decision as 0001-….
  • The user describes a decision that was already recorded — don't create a duplicate. Point at the existing record and ask whether they want to supersede it, correct it, or leave it.
  • A decision with no clear decider ("we just kind of settled on it") — record decided_by: unknown rather than guessing or attributing it to whoever is in the room. Unattributed is a fact; misattributed is a defect.
  • A decision that was never actually made ("we should probably...") — record it as status: proposed with no decided_on, or don't record it at all. Ask which; a proposal filed as accepted is the most damaging failure mode this skill has.
  • A decision that reverses a reversal — normal chaining. Each link points one step back; the chain is the history.
  • Bulk import of historical decisions (a meeting-notes backlog) — that's ckb-ingest's job for the extraction, then this skill's format for the pages. Record them in chronological order so the numbers run in the same order as the decisions.

Licensed under the Apache License, Version 2.0 — see LICENSE at the repository root, or http://www.apache.org/licenses/LICENSE-2.0.