From 9683216f7dc4a44c6aa7c25033eb4526e6828ecf Mon Sep 17 00:00:00 2001 From: vitya Date: Wed, 26 Aug 2026 10:18:33 +0300 Subject: [PATCH] =?UTF-8?q?AGENTS.md:=20Artifact=20placement=20rule=20?= =?UTF-8?q?=E2=80=94=20=D1=81=D0=BA=D0=B8=D0=BB=D1=8B=20.admin=20=D0=B2=20?= =?UTF-8?q?.agents/skills/,=20=D0=BD=D0=B5=20~/.agents/skills/=20=D0=B8=20?= =?UTF-8?q?=D0=BD=D0=B5=20=D0=BE=D0=B1=D1=89=D0=B8=D0=B9=20=D0=BA=D0=B0?= =?UTF-8?q?=D1=82=D0=B0=D0=BB=D0=BE=D0=B3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 70f1585..93d4106 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -12,6 +12,7 @@ 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/ we're on Windows # Secrets rule @@ -31,3 +32,9 @@ we're on Windows [`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, не клади по видимой аналогии. При сомнении о месте/каноне — спросить до мутации.