Инструкция: Написать материал для школы

Trigger: человек говорит «добавь в школу», «запиши это», «сохрани правило», «сделай инсайт из этого»

Зачем

Школу читают агенты, а не люди. Агент пришёл за конкретным знанием чтобы лучше выполнить задачу — у него нет времени читать всё подряд. Материал должен помочь ему понять за две секунды: это про мою ситуацию или нет.

Шаги

1. Определи тип материала

Сигнал Тип Папка
Агент повторно ошибся в одной ситуации Правило поведения behaviors/
Человек объяснил задачу второй раз с нуля Инструкция instructions/
Концепция всплыла в разговоре и её нет в школе Инсайт insights/
Новый внешний инструмент или интеграция Инструкция instructions/

2. Напиши файл

Имя файла: snake_case.md. Без frontmatter.

Первые два предложения — самое важное. По ним агент решает читать ли дальше. Начинай с ситуации, не с определения:

Плохо: Любую абстракцию можно объяснить примером.
Хорошо: Когда объясняешь возможности агента или даёшь рекомендацию — абстракция без примера не работает.

Маркеры применимости — обязательны:

  • **Trigger:** — конкретная фраза, событие или условие (для behaviors/ и instructions/)
  • **Когда НЕ применять:** — если есть похожие ситуации где правило не работает
  • Для insights/ — ключевые слова ситуации в первом абзаце, агент найдёт через поиск

Обоснование для человека: если правило неочевидно — добавь раздел «Зачем» или «Почему так». Объясни какую ошибку это предотвращает. Один абзац, не больше.

В конце файла:

Связано: [[папка/файл]]
**Источник:** [[sources/название]]

Шаблоны файлов — в instructions/create_instruction.

3. Обнови _index.md нужной папки

Добавь одну строку в список:

- [[папка/файл|Заголовок]] — короткое описание → _читай когда: конкретная ситуация_

Стрелка → с курсивом — это триггер для агента. Он смотрит на него и понимает нужно ли переходить по ссылке. Без триггера агент либо читает всё подряд, либо пропускает нужное.

4. Обнови кодекс

Если в новом материале есть чёткое правило поведения — добавь одну строку в codex.md:

N. [Императив] → [[папка/файл]]

5. Обнови смежные файлы

  • Новый источник → создай sources/название.md, добавь строку в sources/_index.md
  • Новая инструкция → добавь в behaviors/capabilities.md
  • Новый инсайт связан с существующим → добавь Связано: в оба файла

5. Залогируй

Залогируй в daily: [[instructions/write_school_content]] выполнена, создан [[папка/файл]].

Проверка результата

  • Первые два предложения нового файла отвечают на вопрос «когда это применимо»?
  • В _index.md есть триггер после →?
  • Есть хотя бы одна ссылка Связано:?
  • _index.md нужной папки обновлён?

Когда остановиться

Если материал уже есть в школе — не дублировать. Сначала поищи через MCP my-trip2g-instance.

Типичные ошибки

  • Создать файл и не обновить _index.md — агент не найдёт материал
  • Написать описание без триггера в _index.md — агент не поймёт нужно ли ему это
  • Начать файл с определения вместо ситуации — агент не узнает свой контекст