Last validated: 2026-06-12 by @claude. Next review: 2026-09-10. Status: Active
Експлуатаційний шар: як деплоїти, як стежити, як діяти в інцидент. Жанр —
informational. Межа deploy / runbooks / playbooks: deploy/ — довідник
по платформах, runbooks/ — аварійні процедури для людини, а покрокові
агент-рецепти живуть у 00-start/playbooks/.
| Розділ | Що тут |
|---|---|
deploy/ |
Deploy-walkthrough-и (Railway, Vercel, monorepo-фільтрація). |
observability/ |
Алерти, SLO, логи, інженерні метрики, дашборди. |
ops/ |
Recurring ops-runbook-и (Renovate maintainer workflow, dependency hygiene). |
postmortems/ |
Розбори інцидентів і follow-up-памʼять. |
runbooks/ |
DR-grade процедури (DB backup/restore, ротація ключів шифрування, …). |
Три споріднені жанри — різний тригер, різна аудиторія:
| Жанр | Де живе | Тригер (коли читати) | Аудиторія | Куди додавати нове |
|---|---|---|---|---|
| Deploy-doc | docs/03-operations/deploy/ |
Налаштовуєш платформу або вперше деплоїш поверхню | Інженер, що конфігурує Railway / Vercel | Новий файл у deploy/, рядок у deploy/README.md |
| Runbook | docs/03-operations/runbooks/ |
Інцидент або DR-вправа — потрібна точна команда для нашого infra | On-call-інженер під тиском | Новий файл <surface>-<operation>.md, рядок у runbooks/README.md |
| Playbook | docs/00-start/playbooks/ |
Виконуєш повторювану задачу — хочеш канонічний порядок кроків | Розробник або агент, що стартує типовий сценарій | Новий файл у playbooks/, рядок у playbook-catalog.md |
Ключова різниця: playbook каже що і коли (агностик до infra), runbook каже як саме виконати на нашому стеку (Railway Postgres, pgBouncer, key-ring), deploy-doc — довідник по платформах і їхніх налаштуваннях.
Детальніший опис розмежування runbook / playbook — у runbooks/README.md § Runbook vs playbook. Канонічний каталог playbooks — 00-start/playbooks/README.md.
Назад до кореня: docs/README.md.