AGENTS.md: Artifact placement rule — скилы .admin в .agents/skills/, не ~/.agents/skills/ и не общий каталог

This commit is contained in:
2026-08-26 10:18:33 +03:00
parent 1f03251a9d
commit 9683216f7d

View File

@@ -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/<name>/SKILL.md` (проектные, pi грузит из cwd). **НЕ** в `~/.agents/skills/` (глобальная установка — перезапишется update-skills) и **НЕ** в общий skills-репо (`~/projects/skills/`).
- **Ранбуки/индексы** → `.admin/.wiki/concepts/`. **Скрипты/тулзы**`.admin/.tmp/` или `.admin/scripts/`.
- **Перед созданием артефакта в неочевидном месте:** посмотри, как лежит в соседнем проекте (живой пример: `books/.agents/skills/`), проверь docs, не клади по видимой аналогии. При сомнении о месте/каноне — спросить до мутации.