Skip to content
Deep Work Plan ya está en Product Hunt Vótalo

Superficie para agentes y desarrolladores

Deep Work Plan para desarrolladores y agentes de IA

deepworkplan.com publica una superficie legible por máquina junto a sus páginas: una API para agentes descrita con OpenAPI, un servidor MCP sin estado, espejos nativos en Markdown de cada página en 17 idiomas y la skill DWP instalable. Todo lo que hay en esta página está activo, es público y gratuito — no hay nada que registrar.

Sin autenticación por diseño

No hay claves de API que generar, ningún baile de OAuth y ningún sandbox separado de producción — la propia superficie de producción es el sandbox. Es una propiedad deliberada de la metodología: los agentes no pueden rellenar formularios de "contactar con ventas", así que el sitio nunca pide uno.

Solo lectura

Cada operación es un GET seguro y almacenable en caché — excepto el endpoint MCP, que es POST. No hay operaciones de escritura, subidas ni cambios de estado en ninguna parte.

Sin claves de API

Sin registro, sin tokens, sin niveles de límite de peticiones. El acceso anónimo es el contrato documentado, declarado en /auth.md y en los stubs de descubrimiento de OAuth.

Gratis y de código abierto

El contenido del sitio y la skill DWP tienen licencia MIT. Úsalos en trabajo comercial y no comercial sin pedir permiso.

Pensado para las máquinas

Errores JSON estructurados en las rutas /api, cuerpos de recuperación 404 en Markdown, catálogo de API RFC 9727 y un manifiesto de capacidades ARD — construido para el consumo de agentes.

Planifica y ejecuta con la skill

La API de arriba permite a un agente leer este sitio. La skill DWP es lo que permite a un agente ejecutar la metodología — instálala una vez en un repositorio y proporciona un enrutador más nueve sub-skills, invocadas como comandos de barra (o por su nombre, para agentes que interceptan la barra — la mayoría usa # en su lugar, por ejemplo #dwp-execute).

Dos decisiones independientes: el formato y cuánta revisión quieres

Cada plan elige un valor de cada eje. Son independientes — un plan Lite puede ejecutarse en trust, un plan Full puede ejecutarse en guided, y cualquiera puede cambiar de modo más tarde sin cambiar de formato.

Lite

Los registros de tareas viven en línea en el README del plan, tras anclas estables #task-N — sin archivos de tarea separados. Pensado para trabajo pequeño y acotado: un solo asunto, aproximadamente una sesión. Aun así, un plan completo: ids de tarea estables, una Touched Surface, criterios de aceptación, una puerta de validación y un Final Review — nunca un boceto reducido.

Full

Un archivo por tarea bajo N.task_<slug>.md, para trabajo de largo horizonte que se extiende por horas o días, o cuando un plan tiene dependencias reales entre tareas. Un plan Lite se promueve a Full más tarde con /dwp-refine promote cuando los registros compactos dejan de ser suficientes — la promoción nunca reejecuta el trabajo terminado.

Guided (por defecto)

dwp-create analiza el objetivo, lo descompone y materializa un plan revisable — ya el plan real y ejecutable, nunca un boceto desechable — y luego pregunta: conservarlo, promover Lite a Full, editarlo o detenerse. Una persona permanece en el bucle antes de que empiece cualquier trabajo de producto. Recomendado las primeras veces, o para cualquier cosa de mayor riesgo.

Trust (o auto)

Añade trust (o auto) como última palabra — por ejemplo /dwp-create <goal> trust — y el agente se salta la ronda de revisión, materializa un plan preaprobado y devuelve directamente el comando de ejecución. El atajo para usuarios avanzados una vez que confías en el flujo; sigue registrando cada decisión y puerta, simplemente no se detiene a preguntar.

Las nueve sub-skills

Cada sub-skill se invoca como un comando de barra dentro del repositorio que instaló la skill — no contra este sitio web. La referencia completa de cada una vive en el catálogo del kit.

Las nueve sub-skills
/dwp-create <goal> Convierte un objetivo en un plan — Lite por defecto, Full para trabajo más grande, cualquiera de los modos según la tabla de arriba.
/dwp-execute Ejecuta un plan existente tarea por tarea: lo lee por completo, ejecuta cada tarea en orden, valida su puerta, actualiza el progreso.
/dwp-refine Añade, elimina o reordena tareas en un plan existente preservando el trabajo completado y su evidencia registrada.
/dwp-resume Reconstruye el estado a partir de los propios archivos del plan y continúa un plan interrumpido desde su primera tarea incompleta.
/dwp-status Informa del progreso de un plan — tareas completadas, en curso, pendientes — sin hacer ningún cambio.
/dwp-verify Comprueba, mecánicamente, si el repositorio es AI-first y si sus planes están bien formados. No cambia nada; informa de aprobado o no aprobado.
/deepworkplan-onboard Hace que un repositorio sea AI-first: razona sobre su stack y luego genera un AGENTS.md adaptado, docs/, .agents/ y un .dwp/ ignorado por git.
/skill-create, /agent-create La sub-skill autora: hace crecer el kit propio del repositorio — una skill reutilizable para un procedimiento repetible, o un agente para un rol recurrente con su propio modelo y herramientas.
/dwp-upgrade Comprueba si hay una versión más reciente de la skill publicada y, solo tras aprobación explícita, la instala y vuelve a ejecutar la incorporación como un pase nuevo — cada plan en curso bajo .dwp/ queda intacto.

Dos formas de ejecutarla

La misma skill, los mismos nueve comandos — el formato y el modo de revisión cambian con el tamaño y el riesgo del trabajo, no con la herramienta.

Una corrección pequeña y acotada — Lite, trust

Un solo asunto, aproximadamente una sesión, bajo riesgo: saltarse la ronda de revisión y dejar que el agente materialice y ejecute un plan Lite directamente.

Terminal — comandos de barra 
# A small, bounded fix: skip the review round, run it directly.
/dwp-create fix the flaky checkout test trust
/dwp-execute

Trabajo de largo horizonte — Full, guided

Dependencias reales entre tareas, o mayor riesgo: revisar el plan propuesto antes de que empiece cualquier trabajo de producto, promoverlo a Full si el objetivo resulta necesitarlo, luego ejecutar y reanudar entre sesiones según se necesite.

Terminal — comandos de barra 
# Long-horizon work with real stakes: review before anything runs.
/dwp-create migrate the billing service to the new payments API
# ...review the proposed plan, then:
/dwp-execute
# ...interrupted? pick up again, even in a fresh session:
/dwp-resume

La salida de cada plan — manifiesto, registro de progreso, registros de tareas, evidencia de puertas — vive en un directorio .dwp/ ignorado por git en el propio repositorio. Nada se envía a ni se almacena por deepworkplan.com; la skill no realiza ninguna llamada de red.

Endpoints

Los endpoints centrales de la API para agentes. La especificación completa y tipada — cada operación, parámetro y esquema de respuesta — vive en el documento OpenAPI.

Endpoints
GET /openapi.json Especificación OpenAPI 3.1 de toda la API para agentes.
GET /llms.txt Índice curado de guía para LLM — el punto de entrada recomendado para agentes.
GET /init.md El prompt canónico de adopción de DWP (hace que cualquier repositorio sea AI-first).
GET /{page}.md Cualquier página como Markdown fuente nativo — en los 17 idiomas (p. ej. /es/developers.md).
GET /api/health.json Marcador de estado estático con enlaces a la especificación y a este portal.
GET /api/v1/index.json Catálogo versionado de la familia v1: rutas de endpoints, versión del sitio y enlaces a la especificación.
GET /api/v1/sections.json El mapa del sitio como JSON tipado — nombre, ruta y descripción por sección.
GET /api/v1/pages.json Cada endpoint de Markdown en cada idioma, agrupados por código de idioma.
GET /api/v1/health.json Marcador de estado versionado — el espejo v1 de /api/health.json.
POST /api/mcp Servidor MCP (Streamable HTTP, sin estado): initialize, ping, tools/list, tools/call.
GET /.well-known/ai-catalog.json Manifiesto de capacidades ARD — el agentmap declarado en robots.txt.

Las rutas /api/* desconocidas devuelven un error JSON estructurado con una pista de resolución, nunca una página de error HTML.

Versionado y deprecación

La familia JSON versionada vive bajo /api/v1/ — index, sections, pages y health — y las rutas canónicas sin versión (/llms.txt, /{page}.md, /api/mcp) pertenecen al mismo contrato v1. Los cambios rompedores se publican solo en una nueva familia /api/v{N+1}/, nunca dentro de v1. Cuando un endpoint se depreca, sus respuestas llevan Deprecation: true y una fecha Sunset al menos 180 días antes de su eliminación, y una cabecera Link apunta al sucesor.

Límites de peticiones

Las respuestas en /api/* llevan cabeceras de límite RFC 9331 — RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset y RateLimit-Policy — para que los agentes puedan autoajustar su ritmo en tiempo real; una respuesta 429 añade Retry-After. La aplicación es best-effort en el edge (120 peticiones por 60 segundos por visitante) y el acceso sigue siendo anónimo: sin claves, sin registro, sin niveles.

Servidor MCP

Un servidor de Model Context Protocol sin estado sobre Streamable HTTP. Tres herramientas de solo lectura: get_init_prompt, list_site_sections y read_page. Se admiten las versiones de protocolo 2025-03-26 y 2025-06-18; no se requiere ninguna sesión.

Terminal — JSON-RPC sobre HTTP 
# 1. Initialize (no session needed — the server is stateless)
curl -s https://deepworkplan.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-06-18","capabilities":{},
                 "clientInfo":{"name":"curl","version":"1.0"}}}'

# 2. Discover the tools
curl -s https://deepworkplan.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# 3. Call one — read any page as source Markdown
curl -s https://deepworkplan.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call",
       "params":{"name":"read_page","arguments":{"path":"/init"}}}'

El manifiesto MCP vive en /.well-known/mcp.json y la tarjeta del servidor en /.well-known/mcp/server-card.json. Claude, ChatGPT y cualquier cliente MCP pueden llamar a estas herramientas de forma nativa.

Markdown para agentes

Cada página renderizada se publica como Markdown fuente nativo — no como una conversión de HTML. Solicita Markdown explícitamente con un sufijo de URL o mediante negociación de contenido HTTP en cualquier página.

Terminal — negociación de contenido 
# Ask for Markdown on any URL (content negotiation)
curl -s https://deepworkplan.com/methodology \
  -H 'Accept: text/markdown'

# Or fetch the .md mirror directly — every page has one, in every language
curl -s https://deepworkplan.com/es/developers.md

La negociación de contenido devuelve el mismo Markdown fuente desde el que el sitio renderiza, en el idioma de la URL que solicites.

Instala el kit

La ruta de instalación oficial de la skill Deep Work Plan — el mismo comando que el endpoint /init da a los agentes. Funciona con cualquier agente de programación compatible con skills (Claude Code, Cursor, Codex, Gemini y otros).

Terminal — CLI de skills y CLI oficial 
# 1. Install the DWP skill — same command the /init endpoint gives agents
npx skills add DailybotHQ/deepworkplan-skill@latest

# 2. Official CLI — zero-dependency client over this API (Node >= 18),
#    prepared in the site repo's cli/ directory pending npm publication
deepworkplan init
deepworkplan read /es/developers

La skill se vendoriza en .agents/skills/deepworkplan/ dentro de tu repositorio, de modo que cada agente que toca el repositorio comparte la misma metodología. La CLI oficial deepworkplan — un cliente sin dependencias sobre esta misma API (init, sections, read, open, mcp) — está preparada para npm y vive en el directorio cli/ del repositorio del sitio hasta su publicación.

Recursos legibles por máquina

Apunta un agente a ello

La ruta más rápida sigue siendo una línea: entrega el prompt de /init a cualquier agente de programación y este instala la skill, incorpora tu repositorio y empieza a terminar deep work.

Abrir el prompt de /init Leer la metodología