ADR-0001: Separate Versioned Playbook

Дата: 2026-07-16 Статус: accepted

Context

Digitable развивает несколько продуктов с общими требованиями к SDD, premium UI, security, QA и агентской работе. Если правила живут только в чатах или копируются между проектами, они расходятся и быстро устаревают.

Одновременно product-specific SDD и architecture должны оставаться рядом с реализацией, иначе агент не получает автономный локальный контекст.

Decision

Использовать три уровня:

1. отдельный versioned digitable-playbook для общих правил и templates;
2. components monorepo для исполняемой design system;
3. project-local memory bank, SDD, backlog и decisions.

Проект фиксирует принятую версию playbook и обновляет её через reviewable task.

Consequences

• Общие правила получают единую историю и SemVer.
• Проект остаётся самодостаточным и не зависит от сети во время работы агента.
• Изменения playbook не применяются к проектам автоматически.
• Дублирование сокращается, но локальные routing summaries сохраняются.