- 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>
28 lines
1.5 KiB
Markdown
28 lines
1.5 KiB
Markdown
# ckb-reset — edge cases
|
|
|
|
Reference material for the `ckb-reset` skill. Read when a
|
|
run hits an unusual situation the main steps don't cover.
|
|
|
|
- **Already clean** — say so and change nothing. Don't rewrite identical scaffold
|
|
files to look busy.
|
|
- **Run in a KB that is not a template** — this skill can't tell the difference,
|
|
so if the wiki holds substantial content (say, 50+ pages or any decision
|
|
records), name that in the confirmation: "This KB has 12 decision records —
|
|
templates don't usually have those. Are you in the right repository?" Ask once;
|
|
don't refuse if they confirm.
|
|
- **`linked/` symlinks** — never follow them when deleting. `rm -rf linked/foo`
|
|
where `foo` is a symlink to another KB is catastrophic and silent. Remove the
|
|
*link*, never its target, and prefer leaving tier 5 alone.
|
|
- **Partial failure mid-delete** — stop, report exactly what was and wasn't
|
|
deleted, and point at the restore point. Don't continue on the theory that
|
|
finishing is tidier.
|
|
- **User asks to reset "everything including the skills"** — that's not a reset,
|
|
it's deleting the KB. Say so and point at `ckb-init` for a fresh one elsewhere.
|
|
- **Module installed** — module-created page types (`repository`, `component`,
|
|
`spec`) are wiki content and reset with tier 1. The module itself stays
|
|
installed unless tier 6 was chosen.
|
|
|
|
---
|
|
|
|
*Licensed under the Apache License, Version 2.0 — see [LICENSE](../../../LICENSE)
|
|
at the repository root, or <http://www.apache.org/licenses/LICENSE-2.0>.*
|