Skip to content
Deep Work Plan está no Product Hunt hoje Vote nele

Superfície para agentes e desenvolvedores

Deep Work Plan para desenvolvedores e agentes de IA

O deepworkplan.com publica uma superfície legível por máquina junto às suas páginas: uma API para agentes descrita com OpenAPI, um servidor MCP sem estado, espelhos nativos em Markdown de cada página em 17 idiomas e a skill DWP instalável. Tudo nesta página está ativo, é público e gratuito — não há nada para se cadastrar.

Sem autenticação por design

Não há chaves de API para gerar, nenhuma dança de OAuth e nenhum sandbox separado de produção — a própria superfície de produção é o sandbox. Isso é uma propriedade deliberada da metodologia: agentes não conseguem preencher formulários de "falar com vendas", então o site nunca pede um.

Somente leitura

Cada operação é um GET seguro e armazenável em cache — exceto o endpoint MCP, que é POST. Não há operações de escrita, uploads nem mudanças de estado em lugar nenhum.

Sem chaves de API

Sem registro, sem tokens, sem níveis de limite de requisições. O acesso anônimo é o contrato documentado, declarado em /auth.md e nos stubs de descoberta de OAuth.

Grátis e de código aberto

O conteúdo do site e a skill DWP são licenciados sob MIT. Use-os em trabalho comercial e não comercial sem pedir permissão.

Pensado para as máquinas

Erros JSON estruturados nas rotas /api, corpos de recuperação 404 em Markdown, catálogo de API RFC 9727 e um manifesto de capacidades ARD — construído para o consumo por agentes.

Planeje e execute com a skill

A API acima permite que um agente leia este site. A skill DWP é o que permite que um agente execute a metodologia — instale-a uma vez em um repositório e ela traz um roteador mais nove sub-skills, invocadas como comandos de barra (ou pelo nome, para agentes que interceptam a barra — a maioria usa # no lugar, por exemplo #dwp-execute).

Duas escolhas independentes: formato e quanta revisão você quer

Todo plano escolhe um valor em cada eixo. Eles são independentes — um plano Lite pode rodar em trust, um plano Full pode rodar em guided, e qualquer um pode trocar de modo depois sem trocar de formato.

Lite

Os registros de tarefa vivem inline no README do plano, atrás de âncoras estáveis #task-N — sem arquivos de tarefa separados. Feito para trabalho pequeno e delimitado: uma preocupação, mais ou menos uma sessão. Ainda um plano completo: ids de tarefa estáveis, uma Touched Surface, critérios de aceitação, um gate de validação e um Final Review — nunca um esboço reduzido.

Full

Um arquivo por tarefa em N.task_<slug>.md, para trabalho de longo alcance que se estende por horas ou dias, ou quando um plano tem dependências reais entre tarefas. Um plano Lite é promovido a Full depois com /dwp-refine promote quando os registros compactos deixam de bastar — a promoção nunca reexecuta trabalho já concluído.

Guided (padrão)

O dwp-create analisa o objetivo, o decompõe e materializa um plano revisável — já o plano real e executável, nunca um rascunho descartável — e então pergunta: manter, promover de Lite para Full, editar ou parar. Um humano permanece no laço antes de qualquer trabalho de produto começar. Recomendado nas primeiras vezes, ou para qualquer coisa de risco mais alto.

Trust (ou auto)

Acrescente trust (ou auto) como última palavra — por exemplo /dwp-create <goal> trust — e o agente pula a rodada de revisão, materializa um plano pré-aprovado e devolve o comando de execução diretamente. O atalho para usuários avançados, uma vez que você confia no fluxo; ainda registra cada decisão e gate, só não para para perguntar.

As nove sub-skills

Cada sub-skill é invocada como um comando de barra dentro do repositório que instalou a skill — não contra este site. A referência completa de cada uma vive no catálogo do kit.

As nove sub-skills
/dwp-create <goal> Transforma um objetivo em plano — Lite por padrão, Full para trabalho maior, qualquer um dos modos da tabela acima.
/dwp-execute Executa um plano existente tarefa por tarefa: lê-o por completo, executa cada tarefa em ordem, valida seu gate, atualiza o progresso.
/dwp-refine Adiciona, remove ou reordena tarefas em um plano existente preservando o trabalho concluído e suas evidências registradas.
/dwp-resume Reconstrói o estado a partir dos próprios arquivos do plano e continua um plano interrompido a partir da primeira tarefa incompleta.
/dwp-status Reporta o progresso de um plano — tarefas concluídas, em andamento, pendentes — sem fazer nenhuma alteração.
/dwp-verify Verifica, mecanicamente, se o repositório é AI-first e se seus planos estão bem formados. Não muda nada; reporta aprovado ou reprovado.
/deepworkplan-onboard Torna um repositório AI-first: raciocina sobre seu stack e gera um AGENTS.md, docs/, .agents/ adaptados e um .dwp/ ignorado pelo git.
/skill-create, /agent-create A sub-skill de autoria: expande o próprio kit do repositório — uma skill reutilizável para um procedimento repetível, ou um agente para um papel recorrente com seu próprio modelo e ferramentas.
/dwp-upgrade Verifica se há um release mais novo da skill publicada e, somente após aprovação explícita, instala-o e reexecuta o onboarding como uma passagem nova — todo plano em andamento sob .dwp/ permanece intocado.

Duas formas de executá-la

A mesma skill, os mesmos nove comandos — o formato e o modo de revisão mudam com o tamanho e o risco do trabalho, não com a ferramenta.

Uma correção pequena e delimitada — Lite, trust

Uma preocupação, mais ou menos uma sessão, risco baixo: pule a rodada de revisão e deixe o agente materializar e executar um plano Lite diretamente.

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

Trabalho de longo alcance — Full, guided

Dependências reais entre tarefas, ou risco mais alto: revise o plano proposto antes de qualquer trabalho de produto começar, promova a Full se o objetivo acabar precisando, depois execute e retome entre sessões conforme necessário.

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

A saída de cada plano — manifesto, log de progresso, registros de tarefa, evidência de gate — vive sob um diretório .dwp/ ignorado pelo git no próprio repositório. Nada é enviado a ou armazenado pelo deepworkplan.com; a skill não faz nenhuma chamada de rede.

Endpoints

Os endpoints centrais da API para agentes. A especificação completa e tipada — cada operação, parâmetro e esquema de resposta — vive no documento OpenAPI.

Endpoints
GET /openapi.json Especificação OpenAPI 3.1 de toda a API para agentes.
GET /llms.txt Índice curado de orientação para LLMs — o ponto de entrada recomendado para agentes.
GET /init.md O prompt canônico de adoção do DWP (torna qualquer repositório AI-first).
GET /{page}.md Qualquer página como Markdown fonte nativo — em todos os 17 idiomas (ex.: /es/developers.md).
GET /api/health.json Marcador de saúde estático com links para a especificação e este portal.
GET /api/v1/index.json Catálogo versionado da família v1: caminhos dos endpoints, versão do site e links para a especificação.
GET /api/v1/sections.json O mapa do site como JSON tipado — nome, caminho e descrição por seção.
GET /api/v1/pages.json Cada endpoint de Markdown em cada idioma, agrupados por código de idioma.
GET /api/v1/health.json Marcador de estado versionado — o espelho v1 de /api/health.json.
POST /api/mcp Servidor MCP (Streamable HTTP, sem estado): initialize, ping, tools/list, tools/call.
GET /.well-known/ai-catalog.json Manifesto de capacidades ARD — o agentmap declarado no robots.txt.

Rotas /api/* desconhecidas retornam um erro JSON estruturado com uma dica de resolução, nunca uma página de erro HTML.

Versionamento e descontinuação

A família JSON versionada vive em /api/v1/ — index, sections, pages e health — e os caminhos canônicos sem versão (/llms.txt, /{page}.md, /api/mcp) pertencem ao mesmo contrato v1. Mudanças com quebra de compatibilidade são publicadas apenas em uma nova família /api/v{N+1}/, nunca dentro da v1. Quando um endpoint é descontinuado, suas respostas carregam Deprecation: true e uma data Sunset pelo menos 180 dias antes da remoção, e um cabeçalho Link aponta o sucessor.

Limites de requisições

As respostas em /api/* carregam cabeçalhos de limite RFC 9331 — RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset e RateLimit-Policy — para que os agentes possam ajustar seu próprio ritmo em tempo real; uma resposta 429 adiciona Retry-After. A aplicação é best-effort na borda (120 requisições por 60 segundos por visitante) e o acesso continua anônimo: sem chaves, sem registro, sem níveis.

Servidor MCP

Um servidor de Model Context Protocol sem estado sobre Streamable HTTP. Três ferramentas somente leitura: get_init_prompt, list_site_sections e read_page. As versões de protocolo 2025-03-26 e 2025-06-18 são suportadas; nenhuma sessão é necessária.

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"}}}'

O manifesto MCP vive em /.well-known/mcp.json e o card do servidor em /.well-known/mcp/server-card.json. Claude, ChatGPT e qualquer cliente MCP podem chamar essas ferramentas de forma nativa.

Markdown para agentes

Cada página renderizada é publicada como Markdown fonte nativo — não uma conversão de HTML. Solicite Markdown explicitamente com um sufixo de URL ou por meio de negociação de conteúdo HTTP em qualquer página.

Terminal — negociação de conteúdo 
# 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

A negociação de conteúdo devolve o mesmo Markdown fonte do qual o site renderiza, no idioma da URL que você solicitar.

Instale o kit

O caminho oficial de instalação da skill Deep Work Plan — o mesmo comando que o endpoint /init dá aos agentes. Funciona com qualquer agente de código compatível com skills (Claude Code, Cursor, Codex, Gemini e outros).

Terminal — CLI de skills e 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

A skill é vendorizada em .agents/skills/deepworkplan/ dentro do seu repositório, de modo que todo agente que toca o repositório compartilha a mesma metodologia. A CLI oficial deepworkplan — um cliente sem dependências sobre esta mesma API (init, sections, read, open, mcp) — está preparada para npm e vive no diretório cli/ do repositório do site até a publicação.

Recursos legíveis por máquina

Aponte um agente para ele

O caminho mais rápido continua sendo uma linha: entregue o prompt do /init a qualquer agente de código e ele instala a skill, faz o onboarding do seu repositório e começa a concluir deep work.

Abrir o prompt do /init Leia a metodologia