Аддоны

Версия 2.0. Аддоны — опциональные расширения базовой методологии Deep Work Plan. Они никогда не требуются для соответствия — репозиторий без аддонов полностью AI-first и соответствует DWP. Каждый аддон предлагается при онбординге, явно принимается или отклоняется и — при принятии — согласуется с существующей настройкой вместо перезаписи.

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

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

Обнаружение: поток 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/ только при принятии
• Когда предлагается: lockfile присутствует и стек с большим числом зависимостей; рекомендовать только когда уместно

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)
• Сила профилей: visual-ui включён по умолчанию при обнаружении; cli-output и conversational рекомендуются при обнаружении, всегда спрашиваются, никогда не применяются автоматически
• Когда предлагается: только при обнаружении пользовательской интерфейсной поверхности — не для чистых библиотек, headless-сервисов или репозиториев только с инфраструктурой

AI Diff Reviewer (пятый аддон)

Опциональная связь с AI Diff Reviewer (marketplace «AI Diff Reviewer», текущая версия v2.0.0), дополняющая обязательную Проверку безопасности структурированным локальным анализом и опционально блокирующая pull request’ы в CI.

• Страница kit: AI Diff Reviewer — полный справочник возможностей
• Что подключает аддон DWP: локальное усиление Проверки безопасности через родительский поток по умолчанию вышестоящего skill; обязательный .review/extension.md (skill в одиночку неполна); Flow B опционально устанавливает pr-review.yml (DailybotHQ/ai-diff-reviewer@v2) и открывает apply-review как компаньон, вызываемый разработчиком — никогда не задача плана
• Потоки: A — только локально (skill + расширение) или B — двойная поверхность (skill + расширение + CI Action). Аддон ОБЯЗАН спрашивать о потоке; никогда не использовать значение по умолчанию
• Мягкий сбой vs шлюз: отсутствующие ошибки skill/расширения/вызова никогда не блокируют; находки critical из завершённого локального прохода по-прежнему следуют контракту Проверки безопасности
• Паритет (Flow B): общий prompt.md + расширение согласовывает методологию/серьёзность; итерационно-осознанная проверка CI может сократить раунды 2+ при полном локальном проходе
• Нейтральная защита от привязки к вендору: ядро DWP имеет нулевую зависимость от AI Diff Reviewer; никогда не устанавливать автоматически для всех
• Когда предлагается: разработчик или команда хочет структурированного локального анализа и/или CI PR merge gate

Навыки

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

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

Запись 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.