Аддоны

Версия 2.1.0. Аддоны — расширения базовой методологии Deep Work Plan. Четыре из пяти опциональны и никогда не требуются для соответствия — репозиторий без опциональных аддонов полностью AI-first и соответствует DWP. Каждый опциональный аддон предлагается при онбординге, явно принимается или отклоняется и — при принятии — согласуется с существующей настройкой вместо перезаписи. Один компонент — заявленное исключение: начиная со стандарта 2.3.0 локальный обзор AI Diff Reviewer входит в обязательный базовый уровень — онбординг его устанавливает, и каждый Final Review его запускает, — тогда как его CI-поверхность остаётся опциональной.

Контракт аддона

Каждый поставляемый аддон включает четыре обязательных компонента:

Обнаружение: поток onboard перечисляет skills/deepworkplan/addons/ и представляет каждый аддон как опциональный шаг в фазе 7b после базового каркаса.

Поставляемые аддоны (пять)

Сегодня поставляются пять аддонов — четыре опциональных плюс обязательный локальный обзор. У каждого есть страница каталога kit с пользовательскими деталями и нормативная спецификация внутри навыка Deep Work Plan.

Devcontainer (первый аддон)

Настройка .devcontainer/ + docker/ на основе compose, выведенная из обнаруженного стека.

• Страница kit: Devcontainer
• Что добавляет: персистентные тома аутентификации AI-CLI (Claude, Codex, Cursor, gh, Dailybot), dailybot-project-network, DOCKER_DEV_ENV=vscode, алиасы валидации (codecheck, check, fix, test), гигиена секретов для публичного OSS
• Поведение: ~85% стабильный скелет; ~15% выводится по стеку. Существующие devcontainer согласуются, никогда не перезаписываются
• Когда предлагается: большинство репозиториев с Docker или сервисами, которым полезен изолированный dev-контейнер

Dailybot (второй аддон)

Опциональное подключение к команде Dailybot разработчика для видимости прогресса агента.

• Страница kit: Dailybot — полная справка по возможностям
• Что подключает аддон DWP: четыре отчёта жизненного цикла плана (kickoff, significant task, blocked, completion) через поднавык dailybot report; опциональное детерминированное принудительное применение хуков (dailybot hook, CLI >= 3.7.0)
• Парный навык: установка DailybotHQ/agent-skill (сейчас 3.10.3) раскрывает 14 возможностей — чат в Slack/Teams/Discord/Google Chat, чек-ины, создание форм, Ask AI, kudos, API-ключи на репозиторий (.dailybot/env.json), email и др. Аддон DWP подключает только report; остальные возможности вызываются через навык Dailybot напрямую
• Аутентификация: полностью отложена до навыка Dailybot (dailybot login или DAILYBOT_API_KEY); этот аддон никогда не хранит учётные данные
• Ограничение нейтральности по вендору: базовый DWP имеет нулевую зависимость от Dailybot; никогда не устанавливать автоматически для всех
• Когда предлагается: разработчик или команда уже используют Dailybot или явно просят отчётность для команды

Dependency upgrade (третий аддон)

Обновления зависимостей, независимые от менеджера пакетов, пакетные, проверенные, обратимые.

• Страница kit: Dependency upgrade
• Что добавляет: обнаруживает реальный менеджер репозитория (npm/pnpm/yarn + ncu, pip/poetry/uv, cargo, go mod, bundler, composer, …), обновляет пакетами, классифицированными по semver, запускает валидационный gate репозитория после каждого пакета, откатывает неудачи, суммирует без автокоммита
• Команда: устанавливает /lib-upgrade в .agents/commands/ только при принятии
• Когда предлагается: предлагается для каждого репозитория с объявленными зависимостями; неактивный делегатор /lib-upgrade устанавливается под согласием онбординга, если явно не отклонено — установка не запускает никакого обновления

Design system (четвёртый аддон)

DESIGN.md, ограниченный интерфейсной поверхностью, который читает любой coding-агент для согласованного UI, CLI или разговорного вывода.

• Страница kit: Design system
• Что добавляет: docs/DESIGN.md (со ссылкой из AGENTS.md) с до трёх профилей, сложенных в один файл: visual-ui (токены и компоненты отрисованного UI), cli-output (семантические стили терминала, деградация TTY/NO_COLOR), conversational (голос, анатомия сообщений, рендеринг по платформам с plain-text fallback)
• Сила профилей: обнаружение делает предложение обязательным; установка защищена явным согласием как в режиме guide, так и в режиме trust — visual-ui настоятельно рекомендуется при обнаружении; cli-output и conversational рекомендуются при обнаружении, всегда спрашиваются, никогда не применяются автоматически
• Когда предлагается: только при обнаружении пользовательской интерфейсной поверхности — не для чистых библиотек, headless-сервисов или репозиториев только с инфраструктурой

AI Diff Reviewer (пятый аддон — обязательный локальный обзор, опциональная CI-поверхность)

AI Diff Reviewer (marketplace «AI Diff Reviewer») даёт проверке безопасности обязательного Final Review структурированный локальный обзор и опционально блокирует pull request’ы в CI. Начиная со стандарта 2.3.0 локальный обзор входит в базовый уровень; опциональна только CI-поверхность. Этот аддон обновляется автоматически при каждом релизе, поэтому его текущая версия никогда не закреплена в этом тексте — актуальный установленный тег смотрите в собственном SKILL.md аддона или в его релизах на GitHub.

• Страница kit: AI Diff Reviewer — полный справочник возможностей
• Обязателен при онбординге (Phase 7a): закреплённая по тегу установка вендорённого skill (npx --yes skills add DailybotHQ/[email protected] --skill ai-diff-reviewer -y) плюс адаптированный под репозиторий .review/extension.md (через generate-extension), в рамках согласия онбординга; точечное обновление harness согласует оба элемента, если их нет; отказ фиксируется как заявленное исключение и сообщается verify до тех пор, пока элемент не установлен
• Обязателен в каждом Final Review: проверка безопасности запускает родительский поток по умолчанию вышестоящего skill по накопленному набору изменений и дописывает его вывод в локальный для плана analysis_results/SECURITY_REVIEW.md (внутри собственной папки плана, никогда в корне репозитория); отсутствующий skill или расширение — это зафиксированная находка local reviewer not installed — никогда не тихий пропуск и никогда не внезапная установка; установка принадлежит согласию онбординга или явному вызову адд-она; находки critical из завершённого прохода блокируют завершение до исправления или явного принятия
• Опциональная CI-поверхность (Flow B): pr-review.yml (DailybotHQ/ai-diff-reviewer@v2) через вышестоящий под-skill setup плюс apply-review как компаньон, вызываемый разработчиком — предлагается явно, никогда не устанавливается без запроса, никогда не по умолчанию, никогда не задача плана
• Никогда не блокирует (только вызов): локальный обзор, который смог стартовать, но завершился ошибкой, — это предупредить один раз, зафиксировать и продолжить; он никогда не проваливает задачу
• Паритет (Flow B): общий prompt.md + расширение согласовывает методологию/серьёзность; Iteration-Aware Review в CI может сократить раунды 2+ при полном локальном проходе
• Нейтральная защита от привязки к вендору: ни один поток Deep Work Plan не требует коммерческого сервиса, CI-провайдера или секрета — reviewer это закреплённый по тегу skill под лицензией MIT, запускаемый собственным coding-агентом разработчика
• Соответствие: verify сообщает об отсутствующем локальном reviewer как о провале для репозиториев, объявляющих стандарт 2.3.0 или новее, и как о находке версии harness для устаревших репозиториев

Навыки

Навыки — переиспользуемые процедуры, вызываемые по имени. Навык упаковывает повторяемый workflow (запуск тестов, исправление lint, создание компонента).

Методология поставляет небольшой набор базовых поднавыков. Среди них поднавык author позволяет репозиторию развивать собственный kit: вызывается через /skill-create и /agent-create, рассуждает о существующей раскладке и соглашениях .agents/, затем создаёт новый навык, агента или тонкий делегатор команд, соответствующий им, и синхронизирует каталог. Тот же поднавык обеспечивает проход сверки skills в Final Review.

Запись kit: Skill create, Agent create.

Агенты

Агенты — специализированные работники с определённой ролью (reviewer, executor, architect). Они живут в .agents/agents/ и каталогизируются в .agents/docs/.

Аддоны обслуживания

Аддон dependency-upgrade (выше) — основной аддон обслуживания. Он рассуждает о реальном менеджере пакетов репозитория, а не предполагает npm, классифицирует обновления по semver, обновляет безопасными пакетами, запускает валидацию после каждого пакета и откатывает любой неудачный пакет.

Аддон design-system

См. Design system в разделе поставляемых аддонов. DESIGN.md на уровне репозитория отличается от технического проектного документа по фиче: README плана DWP, критерии приёмки задач и валидационные gates уже покрывают проектирование по фичам. Аддон design-system заполняет долговременный, repo-native контекст интерфейсного дизайна.

Пресеты

Пресеты адаптируют DWP к конкретному технологическому стеку (Django, React, Go, Astro + Svelte и др.). Просмотрите каталог kit.

Адаптеры

Адаптеры сопоставляют команды DWP с системой команд конкретного агента (Claude Code, Cursor, Codex, Gemini, Copilot, OpenClaw и др.). Записи адаптеров находятся в kit под именем каждого агента.

Примеры

Примеры демонстрируют DWP на практике: сравнения до/после, образцовые планы, кейс-стади. См. Examples и Dogfood this site.

Напоминание о соответствии

Репозиторий ДОЛЖЕН быть полностью соответствующим с нулём аддонов. Аддоны — многоуровневые опциональные возможности, никогда не предпосылки. См. Conformance.