docs(agents): AGENTS.md → указатель на wiki:2608 (канон в mappa, opt-in session-sync) — task:1506
This commit is contained in:
31
AGENTS.md
31
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 <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`](.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/<name>/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
|
||||
|
||||
Reference in New Issue
Block a user