Files
admin/AGENTS.md
vitya ca265bfe2f fix(agents): вернуть opt-in session-sync в AGENTS.md — live-ingest .admin был выключен
Строка `session sync: write to mappa` выпала из файла в e3fb3111 (18.09, task:3017,
переработка канон-блока); канон wiki:2608 её сохранил, повторный прогон блока
(7939ce36) не вернул. Без строки pi-расширение (mappa.ts isOptedIn) не поднимает
live-ingest → сессии .admin не пишутся в mappa (проверено: 01a0b97e и текущая 404,
контроль session:1913 200; у books/sched/tg-digest строка есть — их сессии в mappa есть).

Восстановлено verbatim из канона.
2026-09-19 16:36:44 +03:00

4.2 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 — opt-in для pi session-sync / CC-хука (w:2604): live-ingest сессий в mappa. Без opt-in сессии не пишутся в mappa (диагноз 2026-08-29: opt-in неполный → мусор mappa.ts:404 + live-ingest не поднят).

Mappa canon

Gates (canon/gates — shared): краткая суть; полный текст — wiki_get(slug='canon/gates', full=true)

  • Г1. Знание и артефакты → mappa, не файлы — durable-знание и артефакты проекта живут в mappa; файловые каналы (.brainstorm/, .tasks/, .wiki/) и «сохранить рядом с проектом» закрыты.
  • Г2. Контракт каналов — письмо (inbox) — носитель вердиктов/указаний/находок, полным телом; комментарии на тасках — короткий след. Адресация about/to/thread (XOR); lifecycle ack/resolve/cancel.
  • Г3. Поиск до угадывания — не угадывать slug/роут: сначала search/wiki_search; wiki_get без project = shared; общая память — search(mode='recall').
  • Г4. Адресация и слаги — рефы полными именами ([[task:N]]/[[wiki:slug]]); слаги kebab-case, латиница; номера task:N выдаёт сервер.
  • Г5. .mappa-гейт — папка участвует в mappa-операциях только с маркером .mappa; нет маркера → сказать человеку, мутации — отказ.
  • Г6. Секреты — в mappa не пишутся (422); только secret:<path>-рефы, значения мимо.
  • Г7. Degraded-режим — mappa недоступна: читать кэш .mappa/ (canon/methodology/runbooks), мутации → .mappa/pending/; нет кэша → стоп, не импровизировать.
  • Г8. Перед работой с вики/каноном — первым действием прочитать канон-блок AGENTS.md проекта.
  • Г9. Живое состояние до заявления — статус заявлять только по свежему чтению mappa, не по памяти/кэшу/ответу create. Entity → runbook (runbooks/index — shared): task → runbooks/tasks · wiki → runbooks/wiki · inbox → runbooks/inbox · threadrunbooks/threads · session → runbooks/session · search → runbooks/search · issue → runbooks/issue · intentrunbooks/intent · requirements → runbooks/requirements · plan → runbooks/plan · comment → runbooks/comment · tag → runbooks/tag · attachment → runbooks/attachment · release → runbooks/release · brainstorm → runbooks/brainstorm · agent → runbooks/agent-operator · repo → runbooks/repo-commit · project → runbooks/project · skill → runbooks/skill · entity-слой → runbooks/entity · sched → runbooks/sched-telemetry Methodology: methodology/kzntsv Canon version: 4