Project Adoption

Обновлено: 2026-07-16

Новый проект

1. Скопировать ./templates/AGENTS.md в корень.
2. Создать docs/memory-bank/ из ./templates/memory-bank/.
3. Создать первый SDD из ./templates/sdd.md.
4. Указать playbook version и product owner.
5. Добавить project-specific test/build commands.
6. Проверить, что secrets и local credentials исключены из Git.

Существующий проект

1. Не заменять старые docs массовым копированием.
2. Определить существующие sources of truth.
3. Добавить memory bank как routing layer.
4. Сопоставить текущий process с общим DoD.
5. Зафиксировать осознанные исключения локальным ADR.
6. Подключить новые правила небольшими reviewable изменениями.

Precedence

Рекомендуемый порядок:

1. последнее явное решение product owner;
2. local owning SDD/security/architecture contract;
3. local acceptance criteria;
4. зафиксированная версия Digitable Playbook;
5. implementation и старые комментарии.

Локальный контракт может уточнять playbook. Ослабление security/data rule требует ADR с reason, owner, risk и сроком пересмотра.

Upgrade

1. Прочитать CHANGELOG.md между текущей и новой версией.
2. Создать отдельную task/PR на upgrade.
3. Обновить templates и local rules выборочно.
4. Запустить project checks.
5. Обновить playbook version в memory bank.

Не синхронизировать документацию скрытым cron или copy script без review: общее правило может конфликтовать с принятым project-specific contract.

Когда поднимать правило наверх

Предложить правило в общий playbook, если:

• оно доказало пользу минимум в двух проектах;
• его можно сформулировать без project-specific nouns и paths;
• есть evidence или повторяемая проблема;
• понятно, как проверить соблюдение;
• назначен owner решения.