From b6e0e776e881ebebf082a63f7914ac31d3c172fc Mon Sep 17 00:00:00 2001 From: vitya Date: Sat, 29 Aug 2026 11:06:19 +0300 Subject: [PATCH] =?UTF-8?q?docs(agents):=20AGENTS.md=20=E2=86=92=20=D1=83?= =?UTF-8?q?=D0=BA=D0=B0=D0=B7=D0=B0=D1=82=D0=B5=D0=BB=D1=8C=20=D0=BD=D0=B0?= =?UTF-8?q?=20wiki:2608=20(=D0=BA=D0=B0=D0=BD=D0=BE=D0=BD=20=D0=B2=20mappa?= =?UTF-8?q?,=20opt-in=20session-sync)=20=E2=80=94=20task:1506?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 31 +++++++------------------------ 1 file changed, 7 insertions(+), 24 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 93d4106..f5bb4c7 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,4 +1,7 @@ -# AGENTS.md (canon) +# 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 @@ -12,29 +15,9 @@ 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 .wiki/concepts/, scripts in .tmp/ or scripts/ +admin artifacts: project skills in .agents/skills/, runbooks in mappa wiki, scripts in .tmp/ or scripts/ we're on Windows -# Secrets rule +# Session live-ingest -Все креды (SSH, БД, panel, BA) лежат в `pass` (password-store). **Перед поиском доступов — `pass ls` / `pass show `, а не grep по вики или `~/.ssh/config`.** -Серверы СТО Стайер: `stostayer/client` (`new.stostayer.ru:20435` — машина клиента, файлы 1С в `/var/from_1c/`), `stostayer/rusonyx`, `stostayer/client-wireguard`. - -# VDS ops rule - -Все docker-compose stacks на VDS управляются через Portainer (`https://portainer.vds.kzntsv.site`). -`ssh + docker compose up -d` на VDS — anti-pattern. См. [`portainer-stack-management-vds`](.wiki/concepts/portainer-stack-management-vds.md) для migration script + gotchas. -Исключения: `traefik` + `portainer` (management plane, ad-hoc compose). - -# Runbooks rule - -**Перед любой прод-операцией (деплой/рестарт/ротация/миграция/инцидент) — сначала индекс ранбуков:** -[`runbooks-index`](.wiki/concepts/runbooks-index.md) — единственный источник «какой ранбук для чего». -Нет ранбука на проект → создать до/вместе с операцией (скил `admin-runbooks` §WRITE). -Деплой по ранбуку = таска + письмо админу. Секреты в ранбуках — только плейсхолдеры из `pass`. - -# Artifact placement rule (зона .admin) - -- **Скилы зоны админа** → `.admin/.agents/skills//SKILL.md` (проектные, pi грузит из cwd). **НЕ** в `~/.agents/skills/` (глобальная установка — перезапишется update-skills) и **НЕ** в общий skills-репо (`~/projects/skills/`). -- **Ранбуки/индексы** → `.admin/.wiki/concepts/`. **Скрипты/тулзы** → `.admin/.tmp/` или `.admin/scripts/`. -- **Перед созданием артефакта в неочевидном месте:** посмотри, как лежит в соседнем проекте (живой пример: `books/.agents/skills/`), проверь docs, не клади по видимой аналогии. При сомнении о месте/каноне — спросить до мутации. +session sync: write to mappa