Files
admin/AGENTS.md

3.7 KiB
Raw Blame History

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

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:34023410 на 2026-09-02).