Complementos

Versão 2.1.0. Os complementos são extensões da metodologia central do Deep Work Plan. Quatro dos cinco são opcionais e nunca obrigatórios para conformidade — um repositório sem addons opcionais é totalmente AI-first e conforme com o DWP. Cada addon opcional é oferecido durante a integração, aceite ou recusado explicitamente e — quando aceite — reconcilia com a configuração existente em vez de a sobrescrever. Um componente é a exceção declarada: desde o padrão 2.3.0 a revisão local do AI Diff Reviewer faz parte da linha de base obrigatória — o onboarding instala-a e cada Final Review executa-a — enquanto a sua superfície de CI continua opcional.

O contrato de addon

Cada addon ativo inclui quatro componentes obrigatórios:

Descoberta: o fluxo onboard enumera skills/deepworkplan/addons/ e apresenta cada addon como um passo opcional na Fase 7b, após o scaffolding central.

Addons ativos (cinco)

Cinco addons são distribuídos hoje — quatro opcionais mais a revisão local obrigatória. Cada um tem uma página do catálogo do kit com detalhe orientado ao utilizador e uma spec normativa dentro da skill Deep Work Plan.

Devcontainer (primeiro addon)

Uma configuração .devcontainer/ + docker/ baseada em compose, raciocinada a partir do stack detetado.

• Página do kit: Devcontainer
• O que adiciona: volumes persistentes de auth de CLI de IA (Claude, Codex, Cursor, gh, Dailybot), dailybot-project-network, DOCKER_DEV_ENV=vscode, aliases de validação (codecheck, check, fix, test), higiene de segredos em OSS público
• Comportamento: ~85 % esqueleto estável; ~15 % raciocinado por stack. Devcontainers existentes são reconciliados, nunca sobrescritos
• Quando oferecido: a maioria dos repositórios com Docker ou serviços que beneficiam de um contentor de desenvolvimento isolado

Dailybot (segundo addon)

Uma ligação opcional à equipa Dailybot do programador para visibilidade do progresso do agente.

• Página do kit: Dailybot — referência completa de capacidades
• O que o addon DWP liga: quatro relatórios do ciclo de vida do plano (kickoff, tarefa significativa, bloqueado, conclusão) via sub-skill report do dailybot; reforço determinístico opcional por hooks (dailybot hook, CLI >= 3.7.0)
• Skill emparelhada: instalar DailybotHQ/agent-skill (atualmente 3.10.3) expõe 14 capacidades — chat no Slack/Teams/Discord/Google Chat, check-ins, autoría de formulários, ask AI, kudos, chaves API por repositório (.dailybot/env.json), email e mais. O addon DWP liga apenas report; outras capacidades são invocadas diretamente pela skill Dailybot
• Auth: totalmente adiada para a skill Dailybot (dailybot login ou DAILYBOT_API_KEY); este addon nunca armazena credenciais
• Salvaguarda neutra em relação ao fornecedor: o DWP central tem zero dependência do Dailybot; nunca instalar automaticamente para todos
• Quando oferecido: programador ou equipa já usa Dailybot, ou pede explicitamente relatórios à equipa

Dependency upgrade (terceiro addon)

Atualizações de dependências em lotes, validadas e reversíveis, agnósticas ao gestor de pacotes.

• Página do kit: Dependency upgrade
• O que adiciona: deteta o gestor real do repositório (npm/pnpm/yarn + ncu, pip/poetry/uv, cargo, go mod, bundler, composer, …), atualiza em lotes classificados por semver, executa a porta de validação do repositório após cada lote, reverte falhas, resume sem confirmar automaticamente
• Comando: instala /lib-upgrade em .agents/commands/ apenas quando aceite
• Quando oferecido: oferecido para todo repositório com dependências declaradas; o delegador inerte /lib-upgrade instala sob o consentimento do onboarding salvo recusa explícita — uma instalação não executa nenhuma atualização

Design system (quarto addon)

Um DESIGN.md com âmbito de superfície de interface que qualquer agente de codificação lê para saída coerente de UI, CLI ou conversacional.

• Página do kit: Design system
• O que adiciona: docs/DESIGN.md (referenciado a partir de AGENTS.md) com até três perfis empilhados num único ficheiro: visual-ui (tokens e componentes de UI renderizada), cli-output (estilos semânticos de terminal, degradação TTY/NO_COLOR), conversational (voz, anatomia da mensagem, renderização por plataforma com alternativas em texto simples)
• Força do perfil: a deteção torna a oferta obrigatória; a instalação fica protegida por aceitação tanto em modo guiado como em modo de confiança — visual-ui é recomendado com força quando detectado; cli-output e conversational são recomendados quando detetados, sempre perguntados, nunca aplicados automaticamente
• Quando oferecido: apenas quando uma superfície de interface orientada ao utilizador é detetada — não para bibliotecas puras, serviços sem interface ou repositórios só de infraestrutura

AI Diff Reviewer (quinto addon — revisão local obrigatória, superfície de CI opcional)

O AI Diff Reviewer (marketplace “AI Diff Reviewer”) dá ao passe de segurança do Final Review obrigatório uma revisão local estruturada e, opcionalmente, controla os pull requests em CI. Desde o padrão 2.3.0 a revisão local faz parte da linha de base; apenas a superfície de CI é opcional. Este addon é atualizado automaticamente a cada lançamento, pelo que a sua versão atual nunca é fixada neste texto — consulte o SKILL.md próprio do addon ou os seus lançamentos no GitHub para saber qual a tag realmente distribuída.

• Página do kit: AI Diff Reviewer — referência completa de capacidades
• Obrigatório no onboarding (Fase 7a): instalação fixada por tag da skill vendorizada (npx --yes skills add DailybotHQ/[email protected] --skill ai-diff-reviewer -y) mais um .review/extension.md à medida do repositório (via generate-extension), sob o consentimento do onboarding; uma atualização dirigida do harness reconcilia ambos quando faltam; uma recusa é registada como exceção declarada e o verify reporta-a até que seja instalado
• Obrigatório em cada Final Review: o passe de segurança executa o fluxo pai predefinido da skill upstream sobre o conjunto acumulado de mudanças e acrescenta a sua saída ao analysis_results/SECURITY_REVIEW.md local do plano (dentro da pasta própria do plano, nunca na raiz do repositório); uma skill ou extensão ausente é um achado registado local reviewer not installed — nunca uma omissão silenciosa, e nunca um arranque surpresa: a instalação pertence ao consentimento do onboarding ou a uma invocação explícita do addon; achados critical de uma passagem concluída bloqueiam a conclusão até que sejam corrigidos ou explicitamente aceites
• Superfície de CI opcional (Fluxo B): pr-review.yml (DailybotHQ/ai-diff-reviewer@v2) via a sub-skill setup da skill upstream, mais apply-review como companheiro invocável pelo programador — oferecido explicitamente, nunca instalado sem pedido, nunca o predefinido, nunca uma tarefa do plano
• Nunca bloqueia (apenas invocação): uma revisão local que pôde começar mas termina com erro é avisar-uma-vez-registrar-e-continuar; nunca falha a tarefa por isso
• Paridade (Fluxo B): prompt.md partilhado + extensão alinham metodologia/severidade; a Revisão com Consciência de Iteração de CI pode encurtar a ronda 2+ enquanto a passagem local permanece completa
• Salvaguarda neutra em relação ao fornecedor: nenhum fluxo do Deep Work Plan exige um serviço comercial, fornecedor de CI ou segredo — o revisor é uma skill MIT fixada por tag executada pelo próprio agente de codificação do programador
• Conformidade: o verify reporta um revisor local ausente como falha para repositórios que declaram o padrão 2.3.0 ou posterior, e como achado de versão do harness para repositórios legados

Skills

As skills são procedimentos reutilizáveis invocados por nome. Uma skill empacota um fluxo de trabalho repetível (executar testes, corrigir lint, criar um componente).

A metodologia inclui um pequeno conjunto de sub-skills centrais. Entre elas, a sub-skill author permite que um repositório cresça o seu próprio kit: invocada através de /skill-create e /agent-create, raciocina sobre o layout .agents/ existente e convenções, depois cria uma nova skill, agente ou comando delegador fino que corresponde a eles, mantendo o catálogo sincronizado. A mesma sub-skill respalda o passe de reconciliação de skills do Final Review.

Entrada do kit: Skill create, Agent create.

Agentes

Os agentes são trabalhadores especializados com um papel definido (revisor, executor, arquiteto). Vivem em .agents/agents/ e são catalogados em .agents/docs/.

Complementos de manutenção

O complemento dependency-upgrade (acima) é o complemento de manutenção principal. Raciocina sobre o gestor de pacotes real do repositório em vez de assumir npm, classifica atualizações por semver, atualiza em lotes seguros, executa validação após cada lote e reverte qualquer lote que falhe.

Complemento de sistema de design

Ver Design system em addons ativos. O DESIGN.md ao nível do repositório é distinto de um documento de design técnico por funcionalidade: o README do plano DWP, critérios de aceitação de tarefas e portas de validação já cobrem design por funcionalidade. O addon design-system preenche contexto de design de interface durável e nativo do repositório.

Presets

Os presets adaptam o DWP a um stack tecnológico específico (Django, React, Go, Astro + Svelte e mais). Explore o catálogo do kit.

Adaptadores

Os adaptadores mapeiam comandos DWP para o sistema de comandos de um agente específico (Claude Code, Cursor, Codex, Gemini, Copilot, OpenClaw e outros). As entradas de adaptador vivem no kit sob o nome de cada agente.

Exemplos

Os exemplos demonstram o DWP na prática: comparações antes/depois, planos de exemplo, estudos de caso. Ver Examples e Dogfood this site.

Lembrete de conformidade

Um repositório DEVE ser totalmente conforme com zero addons. Os addons são capacidades opcionais em camadas — nunca pré-condições. Ver Conformance.