애드온

버전 2.0. 애드온은 핵심 Deep Work Plan 방법론에 대한 선택적 확장입니다. 적합성에 절대 필요하지 않습니다 — 애드온이 없는 저장소도 완전히 AI-first이며 DWP 적합합니다. 각 애드온은 온보딩 중 제안되며 명시적으로 수락 또는 거부되고, — 수락 시 — 기존 설정을 덮어쓰지 않고 조정합니다.

애드온 계약

출시되는 모든 애드온은 네 가지 필수 구성 요소를 제공합니다:

발견: onboard 흐름은 skills/deepworkplan/addons/를 열거하고 핵심 스캐폴딩 후 7b 단계에서 각 애드온을 옵트인 단계로 제시합니다.

출시 애드온(다섯 가지)

현재 다섯 가지 애드온이 출시됩니다. 각각 키트 카탈로그 페이지(사용자 대상 세부)와 Deep Work Plan 스킬 내 규범 스펙이 있습니다.

Devcontainer(첫 번째 애드온)

감지된 스택에서 추론한 compose 기반 .devcontainer/ + docker/ 설정.

• 키트 페이지: Devcontainer
• 추가 내용: 영구 AI-CLI 인증 볼륨(Claude, Codex, Cursor, gh, Dailybot), dailybot-project-network, DOCKER_DEV_ENV=vscode, 검증 별칭(codecheck, check, fix, test), 공개 OSS 시크릿 위생
• 동작: 약 85% 안정 스켈레톤; 약 15% 스택별 추론. 기존 devcontainer는 조정되며 절대 덮어쓰지 않음
• 제안 시점: Docker 또는 격리 개발 컨테이너가 유익한 서비스가 있는 대부분의 저장소

Dailybot(두 번째 애드온)

에이전트 진행 가시성을 위한 개발자 Dailybot 팀에 대한 옵트인 연결.

• 키트 페이지: Dailybot — 전체 기능 참조
• DWP 애드온이 연결하는 것: dailybot report 서브스킬을 통한 네 가지 플랜 라이프사이클 보고(kickoff, significant task, blocked, completion); 선택적 결정론적 훅 강제(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), 이메일 등. DWP 애드온은 report만 연결; 다른 기능은 Dailybot 스킬을 직접 호출
• 인증: Dailybot 스킬에 완전 위임(dailybot login 또는 DAILYBOT_API_KEY); 이 애드온은 자격 증명을 저장하지 않음
• 벤더 중립 가드레일: 핵심 DWP는 Dailybot 의존성 제로; 모든 사람에게 자동 설치하지 않음
• 제안 시점: 개발자나 팀이 이미 Dailybot을 사용하거나 팀 보고를 명시적으로 요청

Dependency upgrade(세 번째 애드온)

패키지 관리자 무관, 배치화, 검증, 되돌릴 수 있는 의존성 업그레이드.

• 키트 페이지: Dependency upgrade
• 추가 내용: 저장소의 실제 관리자 감지(npm/pnpm/yarn + ncu, pip/poetry/uv, cargo, go mod, bundler, composer…), semver 분류 배치로 업그레이드, 각 배치 후 저장소 검증 게이트 실행, 실패 배치 되돌리기, 자동 커밋 없이 요약
• 명령: 수락 시에만 .agents/commands/에 /lib-upgrade 설치
• 제안 시점: lockfile 존재 및 의존성이 많은 스택; 관련 있을 때만 권장

Design system(네 번째 애드온)

인터페이스 표면 범위의 DESIGN.md. 모든 코딩 에이전트가 일관된 UI, CLI 또는 대화 출력을 위해 읽음.

• 키트 페이지: Design system
• 추가 내용: docs/DESIGN.md(AGENTS.md에서 참조), 하나의 파일에 최대 세 프로필 적층: visual-ui(렌더링 UI 토큰 및 컴포넌트), cli-output(의미적 터미널 스타일, TTY/NO_COLOR 저하), conversational(목소리, 메시지 구조, 플랫폼별 렌더링 및 일반 텍스트 폴백)
• 프로필 강도: visual-ui는 감지 시 기본 켜짐; cli-output과 conversational은 감지 시 권장, 항상 질문, 자동 적용 안 함
• 제안 시점: 사용자 대상 인터페이스 표면이 감지된 경우에만 — 순수 라이브러리, 헤드리스 서비스 또는 인프라 전용 저장소에는 해당 없음

AI Diff Reviewer(다섯 번째 애드온)

AI Diff Reviewer(marketplace “AI Diff Reviewer”, 현재 버전 v2.0.0)에 대한 선택적 연결로, 필수 보안 검토를 구조화된 로컬 검토로 강화하고 선택적으로 CI에서 pull request를 게이트합니다.

• 키트 페이지: AI Diff Reviewer — 전체 기능 참조
• DWP 애드온이 연결하는 것: upstream 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 Iteration-Aware Review는 로컬 패스가 완전하게 유지되는 동안 2+ 라운드를 줄일 수 있음
• 공급자 중립 보호: 핵심 DWP는 AI Diff Reviewer에 대한 제로 의존성을 가짐; 모든 사람에게 절대 자동 설치하지 않음
• 제안 시점: 개발자 또는 팀이 구조화된 로컬 검토 및/또는 CI PR 병합 게이트를 원할 때

스킬

스킬은 이름으로 호출하는 재사용 가능한 절차. 스킬은 반복 가능한 워크플로(테스트 실행, lint 수정, 컴포넌트 생성)를 패키징합니다.

방법론은 소수의 핵심 서브스킬을 제공합니다. 그중 author 서브스킬은 저장소가 자체 키트를 키우게 합니다: /skill-create 및 /agent-create로 호출되며 기존 .agents/ 레이아웃과 규약에 대해 추론한 뒤 맞는 새 스킬, 에이전트 또는 얇은 명령 위임자를 작성하고 카탈로그를 동기화합니다. 동일 서브스킬이 필수 Skills & Agents Discovery 작업을 실행합니다.

키트 항목: Skill create, Agent create.

에이전트

에이전트는 정의된 역할을 가진 전문 작업자(reviewer, executor, architect). .agents/agents/에 있으며 .agents/docs/에 카탈로그화됩니다.

유지보수 애드온

위의 dependency-upgrade 애드온이 주요 유지보수 애드온입니다. npm을 가정하지 않고 저장소의 실제 패키지 관리자에 대해 추론하며, semver로 업그레이드를 분류하고, 안전한 배치로 업그레이드하며, 각 배치 후 검증을 실행하고 실패한 배치를 되돌립니다.

Design-system 애드온

출시 애드온의 Design system을 참조하세요. 저장소 수준 DESIGN.md는 기능별 기술 설계 문서와 다릅니다: DWP의 플랜 README, 작업 수락 기준 및 검증 게이트가 이미 기능별 설계를 다룹니다. design-system 애드온은 지속적이고 저장소 네이티브인 인터페이스 설계 컨텍스트를 채웁니다.

프리셋

프리셋은 DWP를 특정 기술 스택(Django, React, Go, Astro + Svelte 등)에 맞춥니다. 키트 카탈로그를 탐색하세요.

어댑터

어댑터는 DWP 명령을 특정 에이전트의 명령 시스템(Claude Code, Cursor, Codex, Gemini, Copilot, OpenClaw 등)에 매핑합니다. 어댑터 항목은 각 에이전트 이름 아래 키트에 있습니다.

예제

예제는 DWP 실천을 보여줍니다: 전후 비교, 샘플 플랜, 사례 연구. Examples 및 Dogfood this site를 참조하세요.

적합성 알림

저장소는 애드온 제로로 완전히 적합해야 합니다(MUST). 애드온은 계층적 옵트인 기능 — 전제 조건이 아닙니다. Conformance를 참조하세요.