ckb/.agents/skills/ckb-ingest/references/edge-cases.md
Michał Kopeć 7dd73bb6e4 Sync: local changes as of 2026-10-30T12:12:54Z
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-30 13:12:54 +01:00

1.4 KiB

ckb-ingest — edge cases

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

  • Inbox and raw/ both empty — report that there's nothing to ingest. Don't touch wiki/, and skip the Step 8 report and the Step 9 reminder.
  • Item in inbox doesn't yield a clear entity or page (too vague, pure scratch note with no durable fact) — don't force a page into existence. Still move the item to raw/archive/<YYYY-MM-DD>/ since it's been considered, but note in the ingest report that it produced no wiki change.
  • Conflicting information vs. an existing local wiki page — this is a supersession case handled consistently with ckb-lint, not a silent overwrite: update the existing page if the new source is clearly more current/corroborated, and link supersedes/superseded_by if an older version is worth preserving rather than edited in place.
  • Material duplicates an upstream (linked//libs/) page with nothing new to add — don't create a redundant local page just to have one; the cascade already surfaces the upstream page. Only write locally when overriding, correcting, or adding to what upstream says.

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