knowledge-layers
Skill0 starsChanged 2 months agoApache-2.0View on GitHub
Три слоя знания о проекте — канон, рабочие заметки, справка. Как их помечать, почему их нельзя смешивать и что чем опровергается.
Files
Слои знания
Три слоя
Канон. То, что опубликовано в тексте. Не задумано, не решено на совещании
с самим собой — написано в главе, которая лежит в текст/.
Пометка: [канон: гл. 4].
Рабочие заметки. Гипотезы автора: план, варианты развязки, биография,
которая в текст не попала. Могут противоречить друг другу — это нормально,
это черновик мышления.
Пометка: [заметка].
Справка. Факты внешнего мира: как устроен товарный вагон, сколько идёт
письмо, когда темнеет в ноябре на этой широте. Проверяется вне проекта.
Пометка: [справка: источник].
Правила
- Канон опровергается только текстом. Ни заметка, ни справка, ни логика не отменяют написанного. Если справка говорит, что так не бывает, а в главе так есть — это вопрос к автору, а не исправление базы.
- Справка правит заметки, но не канон. Гипотезу, противоречащую реальности, стоит пересобрать до того, как она попадёт в текст.
- Заметка не правит ничего. У неё нет силы источника.
- Слой указывается всегда. Утверждение без пометки слоя в базу не идёт.
- В одном абзаце — один слой. Смешение — главный способ незаметно превратить план в канон.
Частая ошибка
Автор помнит план как текст. В заметках решено, что герой служил на флоте;
в опубликованных главах об этом нет ни строки. Через сто страниц появляется
реплика, опирающаяся на флот, — и читатель не понимает, откуда это.
Проверка простая: если факт не найден в текст/, он не канон, каким бы
твёрдым ни казался.
Что делать при конфликте
- Канон против канона — противоречие внутри текста, выносится автору с цитатами.
- Канон против справки — решает автор: правит текст или принимает как условность.
- Канон против заметки — правится заметка, молча.
- Заметка против заметки — обе остаются, помечаются как варианты.
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- FiredMosquito831/my-writing-companion★ 2same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository24 other files it gives its agents.
- author-devicesSkill
- character-simSkill
- creative-researchSkill
- creative-writing-craftSkill
- creative-writing-modesSkill
- creative-writing-museSkill
- grill-with-docsSkill
- information-hierarchySkill
- intent-modelingSkill
- kb-managementSkill
- llm-writingSkill
- md-validationSkill
- project-setupSkill
- qi-layerSkill
- reader-simSkill
- reflectSkill
- shared-daoSkill
- story-memorySkill
- story-planningSkill
- story-reviewSkill
- structured-artifactSkill
- writing-principlesSkill
- writing-staffingSkill
- zoom-outSkill
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
Reviews can't be read right now.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.