AGENTS.md — 50-processes
Назначение уровня
Этот уровень описывает процессы работы с проектом: документация, contributing, ADR, тестирование, delivery и организационные runbook’и.
Содержание
50-processes/
├── AGENTS.md # ← вы здесь
├── documentation-standard.md # формальные требования к документации
├── contributing.md # правила внесения изменений и DoD
├── adr-process.md # как заводить и сопровождать ADR
├── gitlab-cicd.md # структура GitLab pipeline и delivery-поток
├── testing-strategy.md # пирамида тестирования и правила по mockery/contract tests
├── release-management.md # SemVer, changelog, tagging, release notes
├── adding-new-supplier.md # process/runbook подключения нового поставщика
└── governance.md # governance по чувствительным изменениям модели
Ключевые концепции уровня
- Docs-as-code — документация обновляется вместе с кодом и схемами.
- Definition of Done — критерии готовности изменения к merge.
- ADR — способ зафиксировать архитектурное решение и контекст.
Когда смотреть сюда
- Начинаете работать с документацией.
- Вносите первый PR.
- Настраиваете тестирование, CI/CD или релизный поток.
- Подключаете нового поставщика.
Когда НЕ смотреть сюда
- Нужен текущий deployment/runtime слой →
../40-operations/. - Нужна доменная модель →
../10-business/. - Нужны сервисные границы →
../30-services/.
Связано
Соглашения
- Любое существенное изменение кода, схем, процессов или deploy должно обновлять документацию в этом или соседнем уровне.
- Если процессовый документ содержит
TBD, это сигнал на доработку, а не нормальное конечное состояние.