ckb/.agents/skills/ckb-export-okf/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.3 KiB

ckb-export-okf — edge cases

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

  • Empty wiki/entities/ or wiki/graph/: their index.md is still regenerated, as an H1 with an empty bullet list. An empty index is spec-valid; the directory is never skipped.
  • A future wiki/<newtopic>/ subdirectory: handled automatically — the script discovers directories dynamically, mirrors them, and generates an index for each. No script changes needed.
  • A future wiki/archived/: exported like any other subdirectory. OKF has no notion of archival status; retention/freshness_window_days already ride along as extension fields for any consumer that cares.
  • Non-markdown files in wiki/ (e.g. graph/edges.json): copied verbatim into the same relative position and listed in their directory's index. Dotfiles (.gitadd) are skipped.
  • Re-running with no wiki changes: produces byte-identical output — every directory walk and generated list is sorted. If a run is ever nondeterministic, that's a bug in the script, not expected behavior.

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