agents

Личный русскоязычный набор AI-инструкций для разработки: минимальные изменения, безопасная работа с Git, содержательное code review и отдельные правила для используемых runtime.

Репозиторий предназначен для открытого чтения и адаптации, но отражает мои рабочие предпочтения, а не претендует на универсальный стандарт.

Последнее ревью: 2026-07-26

Структура

agents/
├── AGENTS.md                 — общие принципы и router
├── LICENSE                   — лицензия MIT
├── project_docs.md           — рекомендации по документации
├── workflows/
│   ├── git.md                — ветки, commit, push и PR
│   ├── review.md             — правила code review
│   └── ux-documentation.md   — journeys, surfaces и copy
├── domains/
│   └── gas.md                — базовые правила Google Apps Script
├── ci_cd/
│   ├── gas.md                — Google Apps Script и clasp
│   ├── server.md             — server-side deploy
│   └── docker.md             — Docker и GHCR
├── agents_gas.md             — расширенный режим GAS
└── agents_github_cicd.md     — router по GitHub CI/CD

Конкретные адреса, машины, credentials и приватные runbooks следует хранить отдельно от публичного набора.

Подключение к проекту

В корне проекта нужен короткий AGENTS.md, который первым делом направляет агента к общим инструкциям и релевантным доменам.

Порядок чтения:

1. Корневой AGENTS.md проекта.
2. agents/AGENTS.md.
3. Нужный файл из domains/ или ci_cd/.
4. Проектные openspec/ и docs/.

Локальный общий checkout

Для личной рабочей среды удобно один раз клонировать репозиторий:

git clone https://github.com/zinovevvv/agents.git /path/to/agents

В проектах можно создать локальную ссылку agents на этот checkout. Ссылка зависит от структуры каталогов, поэтому её не следует считать переносимой или автоматически добавлять в Git.

Пример для macOS:

ln -s /path/to/agents agents

Пример для Windows:

New-Item -ItemType Junction -Path .\agents -Target D:\path\to\agents

Локальную ссылку нужно исключить через .git/info/exclude или проектный .gitignore.

Git submodule

Если подключение должно воспроизводиться после клонирования проекта, использовать submodule:

git submodule add https://github.com/zinovevvv/agents.git agents
git submodule update --init --recursive

В одном checkout использовать только один вариант: локальную ссылку или submodule.

Основные принципы

• минимально достаточное решение;
• сохранение чужих незакоммиченных изменений;
• отсутствие автоматических pull, rebase и force-push;
• проверка цели и логики до обсуждения косметики;
• русскоязычные комментарии, commit messages и review;
• проектная документация только при реальной необходимости.

Документы

• Общие инструкции
• Git workflow
• Code review
• UX-документация
• Документирование проекта
• Базовые правила GAS
• Расширенный режим GAS
• GitHub CI/CD
• GAS CI/CD
• Server deploy
• Docker

Лицензия

MIT