AGENTS.md

1---
2id: agents-rules
3type: note
4status: active
5created: 2026-04-30
6updated: 2026-07-13
7aliases:
8  - "Правила агента"
9  - "AGENTS.md"
10tags: [rules, llm, workflow, vault]
11source_path: "AGENTS.md"
12---
13 
14# AGENTS.md — правила агента для файлового хранилища
15 
16## Главный принцип
17 
18Это хранилище работает только тогда, когда до каждого важного документа можно добраться через указатели, ссылки и правила маршрутизации.
19 
20Если агент создаёт или меняет файл, он обязан обновить связанные индексы и кратко зафиксировать решение в нужном журнале.
21 
22## Карта папок
23 
24| Папка | Назначение |
25|---|---|
26| `00_inbox/` | Новые и ещё неразобранные материалы |
27| `01_now/` | Активная работа: проекты, текущие области, личные задачи |
28| `02_domains/` | Постоянные области жизни или бизнеса |
29| `03_knowledge/` | Переиспользуемые знания, методологии, справка |
30| `04_logs/` | Хронология, обзоры, журналы решений |
31| `90_archive/` | Завершённое и устаревшее |
32| `meta/` | Правила, шаблоны, служебные индексы |
33| `skills/` | Скиллы: инструкции для повторяющихся типов задач |
34 
35## Загрузка контекста
36 
37Перед ответом агент определяет тип задачи и читает минимальный нужный контекст:
38 
39| Тип задачи | Что читать |
40|---|---|
41| Активный проект | `01_now/projects/<project>/README.md`, затем `context.md`, при необходимости `plan.md`, `tasks.md`, `log.md` |
42| Постоянная область | `02_domains/README.md`, затем профильный раздел |
43| Справка или методология | `03_knowledge/README.md`, затем нужный файл |
44| Запись или изменение файла | `meta/rules/write-protocol.md` |
45| Маршрутизация задач | `meta/rules/task-routing.md` |
46| Контурный GitHub-репозиторий | `repository-manifest.yml` + `meta/rules/github-contour-repositories.md` |
47| Создание нового проекта | `skills/project-creator/SKILL.md` + `03_knowledge/ai/agent-plan-methodology-research-2026-07.md` |
48| Актуальная память проекта или контура | `meta/rules/vault-memory.md` |
49| Сжатие истории встреч | `skills/context-compression/SKILL.md` |
50| Обработка входящих материалов | `meta/rules/inbox-processing.md` |
51| Проверка и уборка хранилища | `meta/rules/vault-review.md` |
52| Создание временных файлов | `meta/rules/cleanup-by-design.md` |
53| Недосказанный или многовариантный запрос | `03_knowledge/ai/agent-intent-reconstruction-instruction-2026-06.md` |
54 
55Если контур или проект неоднозначен, агент задаёт один короткий вопрос на уточнение и не читает содержательные файлы разных контуров подряд.
56 
57Если в корне рабочей папки есть `repository-manifest.yml`, агент обязан прочитать его сразу после `AGENTS.md`. Для такого режима действует правило [контурных GitHub-репозиториев](./meta/rules/github-contour-repositories.md): "можно без вопроса" означает подготовить ветку и заявку на изменение, а не менять основную ветку напрямую.
58 
59## Недосказанные запросы
60 
61Если запрос можно выполнить несколькими существенно разными способами, агент сначала восстанавливает намерение владельца:
62 
631. Что владелец явно попросил.
642. Какой практический результат ему нужен.
653. Какие ограничения видны из проекта, правил, языка сообщения и указанного пути.
664. Что можно безопасно предположить.
675. Где ошибка предположения испортит результат и нужен один короткий вопрос.
68 
69Безопасное предположение можно делать, если оно опирается на контекст, легко исправляется и не меняет смысл результата, контур, место записи, источник правды или глубину вмешательства.
70 
71Если ошибка в предположении может повредить данным, маршрутизации, приватности или будущей работе, агент задаёт один короткий вопрос и не начинает выполнять задачу наугад.
72 
73Внутренний разбор намерения не нужно показывать владельцу как отдельный отчёт. Он нужен для выбора глубины работы, места чтения и записи, формата результата и границ вмешательства. Полная методология: [инструкция восстановления намерения агента](./03_knowledge/ai/agent-intent-reconstruction-instruction-2026-06.md).
74 
75## Создание проекта
76 
77Новый активный проект создаётся через скилл [project-creator](./skills/project-creator/SKILL.md) в `01_now/projects/<год>-<slug>/`.
78 
79В проекте должны быть:
80 
81- `README.md` — вход, смысл и навигация;
82- `plan.md` — цель, границы, намерение владельца, критерии качества, вехи, блокеры;
83- `tasks.md` — текущая очередь исполнения;
84- `context.md` — устойчивые знания проекта;
85- `log.md` — короткая история решений.
86 
87`plan.md` хранит направление и вехи. `tasks.md` хранит только текущие действия. История не живёт в `tasks.md`; она живёт в `log.md`.
88 
89План и критерии качества пишет агент. Владелец не должен заполнять план, придумывать пункты или проверять его построчно. Если без уточнения нельзя безопасно выбрать цель, границы, источник правды или цену ошибки, агент задаёт один короткий пакет вопросов и предлагает рекомендуемый вариант.
90 
91Методология: [планирование для LLM-агента](./03_knowledge/ai/agent-plan-methodology-research-2026-07.md).
92 
93## Память
94 
95Архив не равен актуальной памяти. `log.md`, старые встречи, входящие материалы и черновики нужны для проверки источников, но не должны автоматически считаться текущим состоянием.
96 
97Актуальная память живёт в:
98 
99- `context.md` — устойчивые инварианты;
100- `plan.md` — цель, границы, вехи, блокеры и защита от дрейфа;
101- отдельной текущей картине, если проект или контур слишком длинный для одного `context.md`;
102- профильных файлах решений, фактов или гипотез, если они объявлены источником правды.
103 
104Перед сложной задачей агент читает актуальные слои до архива. После значимого события обновляет `plan.md`, `context.md`, текущую картину, `log.md` и `tasks.md` в этом порядке, если эти слои затронуты.
105 
106Важные утверждения памяти не становятся истиной только потому, что записаны. Для решений, рисков, ограничений, текущих статусов и гипотез нужно фиксировать тип утверждения, источник, основание, уровень доверия, дату проверки и правило записи. Подробности: [Память vault](./meta/rules/vault-memory.md), [Антипамять](./meta/memory/anti-memory.md), [Журнал изменений памяти](./meta/memory/ledger.md).
107 
108## Контурный GitHub-репозиторий
109 
110Если задача относится к отдельному GitHub-репозиторию контура:
111 
1121. Прочитай `repository-manifest.yml`.
1132. Проверь владельца, класс данных и разрешённые зоны.
1143. Если действие затрагивает закрытые данные, правила доступа, удаление, перенос или другой контур — задай один короткий вопрос.
1154. Готовь изменения через ветку и заявку на изменение, если прямое изменение основной ветки явно не разрешено.
1165. В описании заявки напиши: что изменено, зачем, какие файлы затронуты, есть ли риск закрытых данных, какие проверки прошли и что должен подтвердить человек.
117 
118Подробности: [контурные GitHub-репозитории](./meta/rules/github-contour-repositories.md).
119 
120## После записи файла
121 
122После создания или существенного изменения файла агент проверяет:
123 
1241. Есть ли корректная служебная разметка в начале `.md` файла.
1252. Обновлён ли `README.md` раздела.
1263. Нужно ли обновить `plan.md`, `context.md`, текущую картину, `log.md` или `tasks.md`.
1274. Работают ли относительные ссылки.
1285. Найдёт ли новый агент этот файл через навигацию.
1296. Нужна ли запись в [журнал изменений памяти](./meta/memory/ledger.md).
1307. Есть ли план жизненного цикла для временных файлов.
131 
132## Скиллы
133 
134Скиллы лежат в `skills/<name>/SKILL.md`. Агент читает скилл только тогда, когда задача подходит под его описание.
135 
136Базовые скиллы:
137 
138- `project-creator` — создание нового проекта с автономным планом, стартовыми файлами и обновлением индексов;
139- `meeting-processing` — обработка встреч и расшифровок;
140- `context-compression` — сжатая историческая память встреч и ограниченное окно чтения;
141- `research` — исследование и фиксация результата;
142- `parking` — сохранение точки возврата;
143- `resume` — возврат к сохранённой задаче;
144- `new-dialog-handoff` — безопасный переход в новый чат;
145- `owner-only-dev-orchestrator` — ведение задач разработки с минимальным участием владельца;
146- `test-gates` — проверка изменений;
147- `release-rollback` — выпуск и откат.
148 
149## Язык ответа
150 
151Агент отвечает на языке пользователя. Если использует технический термин, он объясняет его простыми словами при первом упоминании.
152 
153## Запреты
154 
155- Не создавать файлы без понятного места и назначения.
156- Не оставлять важные документы без ссылки из указателей.
157- Не хранить долгоживущие знания внутри временного проекта.
158- Не складывать личные обязательства, делегирования и цели проекта в один список.
159- Не удалять логи и входящие материалы без явной просьбы владельца.
160- Не читать личную почту, мессенджеры или внешние сервисы без прямой просьбы.
161- Не коммитить закрытые данные, секреты, сырые импорты и крупные исходники в обычный контурный репозиторий.
162 
163## Следующий шаг
164 
165Если это первый запуск, агент должен прочитать `START_HERE.md`, этот файл и `meta/rules/write-protocol.md`, затем кратко объяснить владельцу, как устроено хранилище.
166