Додатки

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

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

Кожен shipping-аддон постачає чотири обов’язкові компоненти:

Виявлення: потік onboard перераховує skills/deepworkplan/addons/ і представляє кожен аддон як опційний крок у Phase 7b, після основного scaffolding.

Shipping-аддони (п’ять)

Сьогодні доступні п’ять аддонів. Кожен має сторінку каталогу kit з деталями для користувача та нормативну spec у скілі Deep Work Plan.

Devcontainer (перший аддон)

Compose-налаштування .devcontainer/ + docker/, виведене з виявленого stack.

• Сторінка kit: Devcontainer
• Що додає: персистентні томи auth AI-CLI (Claude, Codex, Cursor, gh, Dailybot), dailybot-project-network, DOCKER_DEV_ENV=vscode, аліаси валідації (codecheck, check, fix, test), гігієна секретів public-OSS
• Поведінка: ~85% стабільного каркасу; ~15% виведено per stack. Наявні devcontainers узгоджуються, ніколи не затираються
• Коли пропонувати: більшість репозиторіїв з Docker або сервісами, що виграють від ізольованого dev-контейнера

Dailybot (другий аддон)

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

• Сторінка kit: Dailybot — повна довідка можливостей
• Що підключає DWP-аддон: чотири звіти життєвого циклу плану (kickoff, significant task, blocked, completion) через sub-skill dailybot report; опційне детерміноване примусове виконання хуків (dailybot hook, CLI >= 3.7.0)
• Парний скіл: встановлення DailybotHQ/agent-skill (зараз 3.10.3) відкриває 14 можливостей — чат у Slack/Teams/Discord/Google Chat, check-in, авторство форм, ask AI, kudos, per-repo API keys (.dailybot/env.json), email тощо. DWP-аддон підключає лише report; інші можливості викликаються безпосередньо через скіл Dailybot
• Auth: повністю делеговано скілу Dailybot (dailybot login або DAILYBOT_API_KEY); цей аддон ніколи не зберігає облікові дані
• Vendor-neutral guardrail: основний DWP має нульову залежність від Dailybot; ніколи не встановлюйте автоматично для всіх
• Коли пропонувати: розробник або команда вже використовує Dailybot або явно просить командне звітування

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

Оновлення залежностей незалежно від менеджера пакетів, пакетами, з валідацією та можливістю відкату.

• Сторінка kit: Dependency upgrade
• Що додає: виявляє реальний менеджер репозиторію (npm/pnpm/yarn + ncu, pip/poetry/uv, cargo, go mod, bundler, composer, …), оновлює пакетами за semver, запускає validation gate репозиторію після кожного пакета, відкочує збої, підсумовує без auto-commit
• Команда: встановлює /lib-upgrade у .agents/commands/ лише після прийняття
• Коли пропонувати: наявний lockfile і stack з багатьма залежностями; рекомендуйте лише коли доречно

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

DESIGN.md з областю поверхні інтерфейсу, який читає будь-який coding agent для узгодженого UI, CLI або conversational output.

• Сторінка kit: Design system
• Що додає: docs/DESIGN.md (посилання з AGENTS.md) з до трьох профілів в одному файлі: visual-ui (токени та компоненти rendered UI), cli-output (семантичні стилі терміналу, деградація TTY/NO_COLOR), conversational (голос, анатомія повідомлення, рендеринг per platform з plain-text fallbacks)
• Сила профілю: visual-ui увімкнено за замовчуванням при виявленні; cli-output і conversational рекомендовані при виявленні, завжди питаються, ніколи не auto-applied
• Коли пропонувати: лише коли виявлено user-facing поверхню інтерфейсу — не для чистих бібліотек, headless-сервісів чи infra-only репозиторіїв

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). Аддон ПОВИНЕН запитувати про потік; ніколи не вибирати типовий
• М’який збій проти шлюзу: відсутні помилки skill/розширення/виклику ніколи не блокують; знахідки critical із завершеного локального проходу все ще дотримуються контракту Огляду безпеки
• Паритет (Flow B): спільний prompt.md + розширення вирівнює методологію/серйозність; CI Iteration-Aware Review може скоротити раунди 2+ поки локальний прохід залишається повним
• Нейтральний захист щодо постачальника: ядро DWP має нульову залежність від AI Diff Reviewer; ніколи не встановлювати автоматично для всіх
• Коли пропонувати: розробник або команда хоче структурований локальний огляд та/або CI PR merge gate

Скіли

Скіли — багаторазові процедури, що викликаються за іменем. Скіл пакує повторюваний workflow (запуск тестів, виправлення lint, створення компонента).

Методика постачає невеликий набір основних sub-skill. Серед них sub-skill author дозволяє репозиторію розвивати власний kit: викликається через /skill-create і /agent-create, міркує про наявний layout .agents/ і конвенції, потім створює новий скіл, агента або тонкий command delegator, що їм відповідає, і тримає каталог синхронізованим. Той самий sub-skill виконує обов’язкове завдання Skills & Agents Discovery.

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

Агенти

Агенти — спеціалізовані працівники з визначеною роллю (reviewer, executor, architect). Вони живуть у .agents/agents/ і каталогізуються в .agents/docs/.

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

Аддон dependency-upgrade (вище) — основний maintenance-аддон. Він міркує про реальний package manager репозиторію замість припущення npm, класифікує оновлення за semver, оновлює безпечними пакетами, запускає валідацію після кожного пакета й відкочує невдалі пакети.

Аддон design-system

Див. Design system у shipping-аддонах. DESIGN.md на рівні репозиторію відрізняється від технічного design doc per feature: README плану DWP, acceptance criteria завдань і validation gates уже покривають design per feature. Аддон design-system заповнює довговічний, repo-native контекст інтерфейсного дизайну.

Пресети

Пресети адаптують DWP до конкретного tech stack (Django, React, Go, Astro + Svelte тощо). Перегляньте каталог kit.

Адаптери

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

Приклади

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

Нагадування про відповідність

Репозиторій ПОВИНЕН бути повністю відповідним із нулем аддонів. Аддони — шарові опційні можливості, ніколи передумови. Див. Conformance.