diff --git a/skills/ingest/SKILL.md b/skills/ingest/SKILL.md index 449bb2e..1f143d7 100644 --- a/skills/ingest/SKILL.md +++ b/skills/ingest/SKILL.md @@ -39,9 +39,17 @@ which matters on a small local model. 5. On a real contradiction with an existing claim, follow `AGENTS.md` §Conflict: create `wiki/queries/conflict--.md`. Never overwrite the existing page. -Name files in kebab-case and pick stable names. Read `wiki/index.md` (and the specific -pages it points to) to decide create-vs-update and to spot contradictions. Do not scan -whole directories. +**Naming — you are the sole author of these names; nothing renames your files.** Use +minimal kebab-case: lowercase letters, digits and hyphens only — no spaces, no underscores, +no capitals. Pick stable names so the same entity is never created twice (always `acme`, +never also `acme-corp`). The path you write a file to MUST be byte-for-byte the path you +list in the manifest. + +**Deciding create-vs-update and spotting contradictions — mind the context budget.** Use +`wiki/index.md` to locate existing pages, then read **only** the handful that _this source +actually names_ — the entities and concepts in the source's title and opening paragraphs — +not everything the index lists. When in doubt, read fewer: a missed cross-link is far +cheaper than a saturated context. Never scan whole directories. ## Finish: write the manifest, then STOP