Skip to content
Deep Work Plan est sur Product Hunt aujourd’hui Votez pour nous
← Tous les chapitres

Chapitre 03

Modèles de plan et de tâche

Un Deep Work Plan est un répertoire de fichiers Markdown. La forme de ce répertoire — et de chaque fichier qu’il contient — est ce qui rend un plan relisible à la fois par les humains et par les agents.

Structure d’un plan

Un plan est un répertoire sous .dwp/plans/ nommé PLAN_<slug>/. Il contient :

  • README.md — la vue d’ensemble du plan : objectif, matériau source, tableau des tâches et statut.
  • Un fichier par tâche, nommé <n>.task_<slug>.md.
  • PROGRESS.md — un journal d’exécution continu.

Structure d’un fichier de tâche

Chaque fichier de tâche est nommé <n>.task_<slug>.md et suit l’anatomie en dix sections : Goal, Context, Surface touchée, Steps, Acceptance criteria, Validation, Files, Dependencies, Risks et Completion & Log. Les sections apparaissent toujours dans cet ordre, de sorte que tout lecteur sait où chercher. Chaque tâche se réancre à l’objectif du plan avant d’agir, ce qui empêche un agent de dériver sur un long horizon de plusieurs heures.

Le Final Review

Tout plan doit se terminer par exactement une tâche obligatoire : le Final Review. Il clôt le plan en trois passes ordonnées — rien de la passe de sécurité n’est relâché :

  1. Passe de sécurité — auditer tout ce que le plan a changé à la recherche de secrets, de risques d’injection et de nouvelle surface d’attaque, et garder docs/SECURITY.md à jour. La sécurité n’est pas un chantier séparé greffé à la fin : chaque plan laisse ses propres changements audités, et une découverte critique bloque l’achèvement.
  2. Validation de l’état final — la validation complète du dépôt s’exécute et réussit sur le dernier état pertinent, après le correctif final.
  3. Réconciliation des skills — chaque tâche a enregistré sa propre disposition de skills pendant que ses preuves étaient fraîches ; la revue réconcilie le registre. L’Executive Report reste disponible sur demande.

Conventions README et PROGRESS

Le README.md du plan doit contenir un titre (# Deep Work Plan: <name>), un énoncé d’objectif en prose, une section facultative sur le matériau source, un tableau des tâches (numéro, nom de la tâche, case de statut) et une ligne de statut du plan sous la forme <n>/<total> tasks complete.

PROGRESS.md est un journal d’exécution en ajout seul. Chaque entrée consigne un horodatage ISO 8601, le numéro et le nom de la tâche, ce qui a été fait, et tout écart ou raison de saut. Comme il ne fait que grandir, c’est un historique fiable de la façon dont le plan s’est réellement déroulé.

Titres et renvois

Tous les titres utilisent la casse de phrase, et les documents évitent le langage marketing et les points d’exclamation. Ces conventions gardent les plans cohérents d’un agent à l’autre et dans le temps.