Complementos

Versión 2.0. Los complementos son extensiones opcionales de la metodología central de Deep Work Plan. Nunca son obligatorios para el cumplimiento — un repositorio sin addons es plenamente AI-first y conforme con DWP. Cada addon se ofrece durante la incorporación, se acepta o rechaza explícitamente y — cuando se acepta — reconcilia con la configuración existente en lugar de sobrescribirla.

El contrato de addon

Cada addon activo incluye cuatro componentes obligatorios:

Descubrimiento: el flujo onboard enumera skills/deepworkplan/addons/ y presenta cada addon como un paso opcional en la Fase 7b, tras el andamiaje central.

Addons activos (cinco)

Hoy hay cinco addons activos. Cada uno tiene una página del catálogo del kit con detalle orientado al usuario y una spec normativa dentro de la skill de Deep Work Plan.

Devcontainer (primer addon)

Una configuración .devcontainer/ + docker/ basada en compose, razonada a partir del stack detectado.

• Página del kit: Devcontainer
• Qué añade: volúmenes persistentes de auth de CLI de IA (Claude, Codex, Cursor, gh, Dailybot), dailybot-project-network, DOCKER_DEV_ENV=vscode, alias de validación (codecheck, check, fix, test), higiene de secretos en OSS público
• Comportamiento: ~85 % esqueleto estable; ~15 % razonado por stack. Los devcontainers existentes se reconcilian, nunca se sobrescriben
• Cuándo se ofrece: la mayoría de repos con Docker o servicios que se benefician de un contenedor de desarrollo aislado

Dailybot (segundo addon)

Una conexión opcional al equipo de Dailybot del desarrollador para visibilidad del avance del agente.

• Página del kit: Dailybot — referencia completa de capacidades
• Qué conecta el addon de DWP: cuatro reportes del ciclo de vida del plan (inicio, tarea significativa, bloqueado, finalización) vía la sub-skill report de dailybot; refuerzo determinístico opcional mediante hooks (dailybot hook, CLI >= 3.7.0)
• Skill emparejada: instalar DailybotHQ/agent-skill (actualmente 3.10.3) expone 14 capacidades — chat en Slack/Teams/Discord/Google Chat, check-ins, autoría de formularios, ask AI, kudos, claves API por repo (.dailybot/env.json), correo y más. El addon de DWP solo conecta report; el resto de capacidades se invocan directamente mediante la skill de Dailybot
• Auth: totalmente delegada a la skill de Dailybot (dailybot login o DAILYBOT_API_KEY); este addon nunca almacena credenciales
• Salvaguarda neutral respecto al proveedor: el DWP central tiene cero dependencia de Dailybot; nunca instalar automáticamente para todos
• Cuándo se ofrece: el desarrollador o el equipo ya usan Dailybot, o piden explícitamente reportes al equipo

Dependency upgrade (tercer addon)

Actualizaciones de dependencias por lotes, validadas y reversibles, agnósticas al gestor de paquetes.

• Página del kit: Dependency upgrade
• Qué añade: detecta el gestor real del repo (npm/pnpm/yarn + ncu, pip/poetry/uv, cargo, go mod, bundler, composer, …), actualiza en lotes clasificados por semver, ejecuta la puerta de validación del repo tras cada lote, revierte fallos, resume sin confirmar automáticamente
• Comando: instala /lib-upgrade en .agents/commands/ solo cuando se acepta
• Cuándo se ofrece: lockfile presente y stack con muchas dependencias; recomendar solo cuando sea relevante

Design system (cuarto addon)

Un DESIGN.md con alcance de superficie de interfaz que cualquier agente de codificación lee para una salida coherente de UI, CLI o conversacional.

• Página del kit: Design system
• Qué añade: docs/DESIGN.md (referenciado desde AGENTS.md) con hasta tres perfiles apilados en un solo archivo: visual-ui (tokens y componentes de UI renderizada), cli-output (estilos semánticos de terminal, degradación TTY/NO_COLOR), conversational (voz, anatomía del mensaje, renderizado por plataforma con alternativas en texto plano)
• Fuerza del perfil: visual-ui está activado por defecto cuando se detecta; cli-output y conversational se recomiendan cuando se detectan, siempre se preguntan, nunca se aplican automáticamente
• Cuándo se ofrece: solo cuando se detecta una superficie de interfaz orientada al usuario — no para bibliotecas puras, servicios sin interfaz o repos solo de infraestructura

AI Diff Reviewer (quinto addon)

Una conexión opcional al AI Diff Reviewer (marketplace «AI Diff Reviewer», versión actual v2.0.0) que amplía la Revisión de Seguridad obligatoria con una revisión local estructurada y, opcionalmente, bloquea los pull requests en CI.

• Página del kit: AI Diff Reviewer — referencia completa de capacidades
• Qué conecta el addon de DWP: ampliación local de la Revisión de Seguridad vía el flujo padre por defecto de la skill upstream; .review/extension.md requerido (la skill sola es incompleta); el Flujo B instala opcionalmente pr-review.yml (DailybotHQ/ai-diff-reviewer@v2) y expone apply-review como compañero invocable por el desarrollador — nunca como tarea del plan
• Flujos: A — solo local (skill + extensión) o B — doble superficie (skill + extensión + CI Action). El addon DEBE preguntar qué flujo elegir; nunca elegir por defecto
• Fallo suave vs compuerta: errores de skill/extensión/invocación ausentes nunca bloquean; los hallazgos critical de un pase local completado siguen el contrato de Revisión de Seguridad
• Paridad (Flujo B): el prompt.md compartido + extensión alinean metodología/severidad; la Revisión Consciente de Iteraciones de CI puede acortar la ronda 2+ mientras el pase local permanece completo
• Salvaguarda neutral respecto al proveedor: el DWP central tiene cero dependencia de AI Diff Reviewer; nunca instalar automáticamente para todos
• Cuándo se ofrece: el desarrollador o el equipo quiere revisión local estructurada y/o una compuerta de PR en CI

Habilidades

Las habilidades son procedimientos reutilizables que se invocan por nombre. Una habilidad empaqueta un flujo de trabajo repetible (ejecutar pruebas, corregir el linter, crear un componente).

La metodología incluye un pequeño conjunto de subhabilidades centrales. Entre ellas, la subhabilidad author permite que un repositorio cree su propio kit: invocada mediante /skill-create y /agent-create, razona sobre el esquema .agents/ existente y sus convenciones, y luego crea una nueva habilidad, agente o comando delegador ligero que encaja con ellas, manteniendo el catálogo sincronizado. Esta misma subhabilidad ejecuta la tarea obligatoria de Descubrimiento de Habilidades y Agentes.

Entrada del kit: Skill create, Agent create.

Agentes

Los agentes son trabajadores especializados con un rol definido (revisor, ejecutor, arquitecto). Viven bajo .agents/agents/ y se catalogan en .agents/docs/.

Complementos de mantenimiento

El complemento dependency-upgrade (arriba) es el complemento de mantenimiento principal. Razona sobre el gestor de paquetes real del repositorio en lugar de asumir npm, clasifica actualizaciones por semver, actualiza en lotes seguros, ejecuta validación tras cada lote y revierte cualquier lote que falle.

Complemento de sistema de diseño

Ver Design system en addons activos. El DESIGN.md a nivel de repo es distinto de un documento de diseño técnico por función: el README del plan de DWP, los criterios de aceptación de tareas y las puertas de validación ya cubren el diseño por función. El addon design-system aporta contexto de diseño de interfaz duradero y nativo del repo.

Presets

Los presets adaptan DWP a un stack tecnológico concreto (Django, React, Go, Astro + Svelte y más). Explora el catálogo del kit.

Adaptadores

Los adaptadores mapean los comandos de DWP al sistema de comandos de un agente concreto (Claude Code, Cursor, Codex, Gemini, Copilot, OpenClaw y otros). Las entradas de adaptador viven en el kit bajo el nombre de cada agente.

Ejemplos

Los ejemplos demuestran DWP en la práctica: comparaciones antes/después, planes de muestra, casos de estudio. Ver Examples y Dogfood this site.

Recordatorio de conformidad

Un repositorio DEBE ser plenamente conforme con cero addons. Los addons son capacidades opcionales en capas — nunca precondiciones. Ver Conformance.