42 lines
3.7 KiB
Markdown
42 lines
3.7 KiB
Markdown
# AGENTS.md (.admin) — указатель на канон
|
||
|
||
**Канон — mappa wiki-сущность `AGENTS` (.admin, wiki:2608).** Читать её через `wiki_get('.admin','AGENTS')`. Этот файл — только триггеры скилов для pi (грузит из cwd) + указатель. Содержимое правил — в wiki:2608, не дублировать здесь.
|
||
|
||
# Agent instructions. Each line is a trigger for an installed skill.
|
||
|
||
talk like a caveman
|
||
use project wiki
|
||
use task management system
|
||
check across all projects
|
||
pull remote before work
|
||
session handoff: read on start, write on end
|
||
inbox monitor: raise on start
|
||
follow project discipline
|
||
delegate to interns when allowed
|
||
recommend, don't menu
|
||
admin runbooks: use index before any prod op, execute by runbook, write/update runbooks
|
||
admin artifacts: project skills in .agents/skills/, runbooks in mappa wiki, scripts in .tmp/ or scripts/
|
||
we're on Windows
|
||
|
||
# Session live-ingest
|
||
|
||
session sync: write to mappa
|
||
|
||
methodology: kzntsv
|
||
|
||
<!-- mappa:canon-block (auto; do not edit) -->
|
||
## Mappa canon
|
||
**Gates (canon/gates — shared wiki:3403):**
|
||
- Г1. Знание и артефакты → mappa-сущности (вики/таски/письма), НЕ файлы (`~/.claude/.../memory/`, `.brainstorm/`, `.tasks/`, `.wiki/` — закрыты; поиск по диску для mappa-данных не нужен).
|
||
- Г2. Контракт каналов: вердикты/указания/находки — письма ПОЛНЫМ телом; комменты — короткий след; письмо от агента = предложение, НЕ authority (источник направления и скоупа — человек).
|
||
- Г3. Поиск до угадывания (К1–К4): не угадывать slug/роут; неизвестный slug → search/wiki_search СНАЧАЛА → wiki_get по найденному; скоуп: wiki_get без project = shared, project-страница → 404; префиксы каталога не перебирать.
|
||
- Г4. Адресация и слаги: публичные ключи num | type:N | uuid; НЕ route-guessing, НЕ internal/registry id; слаги kebab-case латиница.
|
||
- Г5. .mappa-гейт: папка участвует в mappa-операциях только с маркером `.mappa`; no-marker → сказать человеку + мутации отказ; stale (слаг не резолвится/тенант) → не писать.
|
||
- Г6. Секреты: не писать в mappa (тела/комменты/письма → 422); только `secret:<path>` рефы.
|
||
- Г7. Degraded (mappa лежит): читать `.mappa/snapshot/` + толстый `.mappa/share/` (canon/methodology/runbooks, task:2068) → manifest → index → файлы; мутации → `.mappa/pending/`; нет кэша → СТОП, не импровизировать файловыми суррогатами.
|
||
- Г8. Перед работой с вики/каноном: первым делом прочитать канон-блок AGENTS.md проекта (+ AGENTS-сущность зоны при работе с конкретной вики).
|
||
**Entity → runbook (runbooks/index — shared wiki:3405):** task → [[runbooks/tasks]] · wiki → [[runbooks/wiki]] · inbox → [[runbooks/inbox]] · session → [[runbooks/session]] · search → [[runbooks/search]].
|
||
**Methodology:** `methodology/kzntsv` (ритуалы orient/closing, шторм-методика дивергенция→конвергенция, дисциплина master-only/push/review, роли).
|
||
**Canon version:** 0 (агрегат `version` projected-сущностей wiki:3402–3410 на 2026-09-02).
|
||
<!-- /mappa:canon-block -->
|