admin/AGENTS.md

AGENTS.md (canon)

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 .wiki/concepts/, scripts in .tmp/ or scripts/ we're on Windows

Secrets rule

Все креды (SSH, БД, panel, BA) лежат в pass (password-store). Перед поиском доступов — pass ls / pass show <path>, а не 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 для migration script + gotchas. Исключения: traefik + portainer (management plane, ad-hoc compose).

Runbooks rule

Перед любой прод-операцией (деплой/рестарт/ротация/миграция/инцидент) — сначала индекс ранбуков: runbooks-index — единственный источник «какой ранбук для чего». Нет ранбука на проект → создать до/вместе с операцией (скил 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, не клади по видимой аналогии. При сомнении о месте/каноне — спросить до мутации.