Surface pour agents et développeurs
Deep Work Plan pour les développeurs et les agents IA
deepworkplan.com publie une surface lisible par machine à côté de ses pages : une API pour agents décrite par OpenAPI, un serveur MCP sans état, des miroirs natifs en Markdown pour chaque page en 17 langues et la skill DWP installable. Tout sur cette page est en ligne, public et gratuit — il n’y a rien pour lequel s’inscrire.
Sans authentification, par conception
Il n’y a aucune clé d’API à générer, aucune gymnastique OAuth et aucun bac à sable séparé de la production — c’est la surface de production elle-même qui sert de bac à sable. C’est une propriété délibérée de la méthodologie : les agents ne peuvent pas remplir les formulaires « contact commercial », donc le site n’en demande jamais.
Lecture seule
Chaque opération est un GET sûr et mettable en cache — sauf l’endpoint MCP, qui est en POST. Il n’existe aucune opération d’écriture, aucun téléversement ni aucun changement d’état.
Aucune clé d’API
Aucune inscription, aucun jeton, aucun palier de limite de débit. L’accès anonyme est le contrat documenté, déclaré dans /auth.md et dans les stubs de découverte OAuth.
Gratuit et open source
Le contenu du site et la skill DWP sont sous licence MIT. Utilisez-les dans un cadre commercial ou non commercial sans demander la permission.
Pensé d’abord pour les machines
Erreurs JSON structurées sur les chemins /api, corps de récupération 404 en Markdown, catalogue d’API RFC 9727 et manifeste de capacités ARD — conçus pour la consommation par les agents.
Planifier et exécuter avec la skill
L’API ci-dessus permet à un agent de lire ce site. La skill DWP est ce qui permet à un agent d’exécuter la méthodologie — installez-la une fois dans un dépôt, et elle fournit un routeur plus neuf sub-skills, invoquées comme des commandes slash (ou par leur nom, pour les agents qui interceptent le slash — la plupart utilisent # à la place, par exemple #dwp-execute).
Deux choix indépendants : le format, et le niveau de relecture souhaité
Chaque plan choisit une valeur sur chaque axe. Ils sont indépendants — un plan Lite peut fonctionner en trust, un plan Full peut fonctionner en guided, et l’un ou l’autre peut changer de mode plus tard sans changer de format.
Lite
Les enregistrements de tâches vivent en ligne dans le README du plan, derrière des ancres stables #task-N — pas de fichiers de tâche séparés. Conçu pour un travail petit et borné : une seule préoccupation, environ une session. Toujours un plan complet : identifiants de tâche stables, une Touched Surface, des critères d’acceptation, une porte de validation et un Final Review — jamais une esquisse allégée.
Full
Un fichier par tâche sous N.task_<slug>.md, pour un travail à long horizon s’étendant sur des heures ou des jours, ou lorsqu’un plan a de vraies dépendances entre tâches. Un plan Lite est promu en Full plus tard avec /dwp-refine promote lorsque les enregistrements compacts ne suffisent plus — la promotion ne ré-exécute jamais le travail terminé.
Guided (par défaut)
dwp-create analyse l’objectif, le décompose et matérialise un plan relisible — déjà le plan réel et exécutable, jamais une ébauche jetable — puis demande : le conserver, promouvoir Lite en Full, le modifier, ou arrêter. Un humain reste dans la boucle avant que tout travail produit ne commence. Recommandé les premières fois, ou pour tout ce qui comporte des enjeux plus élevés.
Trust (ou auto)
Ajoutez trust (ou auto) comme dernier mot — par exemple /dwp-create <goal> trust — et l’agent saute le tour de relecture, matérialise un plan pré-approuvé, et renvoie directement la commande d’exécution. Le raccourci pour utilisateur expérimenté une fois que vous faites confiance au flux ; il enregistre toujours chaque décision et chaque porte, il ne s’arrête simplement pas pour demander.
Les neuf sub-skills
Chaque sub-skill est invoquée comme une commande slash à l’intérieur du dépôt qui a installé la skill — pas contre ce site web. La référence complète de chacune se trouve dans le catalogue du kit.
/dwp-create <goal> | Transforme un objectif en plan — Lite par défaut, Full pour un travail plus important, l’un ou l’autre mode selon le tableau ci-dessus. |
/dwp-execute | Exécute un plan existant tâche par tâche : le lit intégralement, exécute chaque tâche dans l’ordre, valide sa porte, met à jour la progression. |
/dwp-refine | Ajoute, supprime ou réordonne des tâches dans un plan existant tout en préservant le travail terminé et ses preuves enregistrées. |
/dwp-resume | Reconstruit l’état à partir des propres fichiers du plan et poursuit un plan interrompu depuis sa première tâche incomplète. |
/dwp-status | Rapporte la progression d’un plan — tâches terminées, en cours, en attente — sans effectuer aucun changement. |
/dwp-verify | Vérifie, mécaniquement, si le dépôt est AI-first et si ses plans sont bien formés. Ne change rien ; rapporte réussite ou échec. |
/deepworkplan-onboard | Rend un dépôt AI-first : raisonne sur sa stack, puis génère un AGENTS.md adapté, docs/, .agents/, et un .dwp/ ignoré par git. |
/skill-create, /agent-create | La sub-skill auteure : fait grandir le kit propre du dépôt — une skill réutilisable pour une procédure répétable, ou un agent pour un rôle récurrent avec son propre modèle et ses propres outils. |
/dwp-upgrade | Vérifie s’il existe une version plus récente de la skill publiée et, seulement après approbation explicite, l’installe et relance l’intégration comme un passage neuf — chaque plan en cours sous .dwp/ reste intact. |
Deux façons de l’exécuter
La même skill, les mêmes neuf commandes — le format et le mode de relecture changent avec la taille et les enjeux du travail, pas avec l’outil.
Une correction petite et bornée — Lite, trust
Une seule préoccupation, environ une session, enjeux faibles : sauter le tour de relecture et laisser l’agent matérialiser et exécuter directement un plan Lite.
# A small, bounded fix: skip the review round, run it directly.
/dwp-create fix the flaky checkout test trust
/dwp-executeTravail à long horizon — Full, guided
De vraies dépendances entre tâches, ou des enjeux plus élevés : relire le plan proposé avant que tout travail produit ne commence, le promouvoir en Full si l’objectif s’avère en avoir besoin, puis exécuter et reprendre entre sessions au besoin.
# 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-resumeLa sortie de chaque plan — manifeste, journal de progression, enregistrements de tâches, preuves de porte — vit dans un répertoire .dwp/ ignoré par git, dans le dépôt lui-même. Rien n’est envoyé à ni stocké par deepworkplan.com ; la skill n’effectue aucun appel réseau.
Endpoints
Les endpoints principaux de l’API pour agents. La spécification complète et typée — chaque opération, paramètre et schéma de réponse — se trouve dans le document OpenAPI.
GET | /openapi.json | Spécification OpenAPI 3.1 de toute l’API pour agents. |
GET | /llms.txt | Sélection d’indications pour les LLM — le point d’entrée recommandé pour les agents. |
GET | /init.md | Le prompt canonique d’adoption de DWP (rend AI-first n’importe quel dépôt). |
GET | /{page}.md | N’importe quelle page en Markdown source natif — dans les 17 langues (p. ex. /es/developers.md). |
GET | /api/health.json | Marqueur d’état statique avec des liens vers la spécification et ce portail. |
GET | /api/v1/index.json | Catalogue versionné de la famille v1 : chemins des endpoints, version du site et liens vers la spécification. |
GET | /api/v1/sections.json | Le plan du site en JSON typé — nom, chemin et description par section. |
GET | /api/v1/pages.json | Tous les endpoints Markdown dans chaque langue, groupés par code de langue. |
GET | /api/v1/health.json | Marqueur d’état versionné — le miroir v1 de /api/health.json. |
POST | /api/mcp | Serveur MCP (Streamable HTTP, sans état) : initialize, ping, tools/list, tools/call. |
GET | /.well-known/ai-catalog.json | Manifeste de capacités ARD — l’agentmap déclaré dans robots.txt. |
Les chemins /api/* inconnus renvoient une erreur JSON structurée avec une piste de résolution, jamais une page d’erreur HTML.
Versionnement et dépréciation
La famille JSON versionnée vit sous /api/v1/ — index, sections, pages et health — et les chemins canoniques non versionnés (/llms.txt, /{page}.md, /api/mcp) appartiennent au même contrat v1. Les changements cassants paraissent uniquement dans une nouvelle famille /api/v{N+1}/, jamais au sein de v1. Quand un endpoint est déprécié, ses réponses portent Deprecation: true et une date Sunset au moins 180 jours avant le retrait, et un en-tête Link pointe vers le successeur.
Limites de débit
Les réponses sur /api/* portent des en-têtes de limite RFC 9331 — RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset et RateLimit-Policy — pour que les agents puissent s’auto-réguler en temps réel ; une réponse 429 ajoute Retry-After. L’application est best-effort en périphérie (120 requêtes par 60 secondes par visiteur) et l’accès reste anonyme : pas de clés, pas d’inscription, pas de paliers.
Serveur MCP
Un serveur Model Context Protocol sans état sur Streamable HTTP. Trois outils en lecture seule : get_init_prompt, list_site_sections et read_page. Les versions de protocole 2025-03-26 et 2025-06-18 sont prises en charge ; aucune session n’est requise.
# 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"}}}'Le manifeste MCP se trouve dans /.well-known/mcp.json et la fiche du serveur dans /.well-known/mcp/server-card.json. Claude, ChatGPT et n’importe quel client MCP peuvent appeler ces outils nativement.
Markdown pour les agents
Chaque page rendue est publiée en Markdown source natif — pas une conversion HTML. Demandez le Markdown explicitement avec un suffixe d’URL ou via la négociation de contenu HTTP sur n’importe quelle page.
# 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.mdLa négociation de contenu renvoie le même Markdown source que celui dont le site tire ses pages, dans la langue de l’URL demandée.
Installez le kit
Le chemin d’installation officiel de la skill Deep Work Plan — la même commande que l’endpoint /init donne aux agents. Elle fonctionne avec tout agent de code compatible skills (Claude Code, Cursor, Codex, Gemini et d’autres).
# 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/developersLa skill s’installe par vendoring dans .agents/skills/deepworkplan/ à l’intérieur de votre dépôt, pour que chaque agent qui touche le dépôt partage la même méthodologie. La CLI officielle deepworkplan — un client sans dépendances sur la même API (init, sections, read, open, mcp) — est prête pour npm et vit dans le répertoire cli/ du dépôt du site jusqu’à sa publication.
Ressources lisibles par machine
Pointez un agent dessus
Le chemin le plus rapide reste une ligne : donnez le prompt /init à n’importe quel agent de code et il installe la skill, intègre votre dépôt et se met à terminer du deep work.