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 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.