Communitygithub.com

AgenticPW/AgenticPW

Un ensemble pratique de pratiques et workflows agentiques, comprenant des compétences réutilisables, des commandes, des notes de référence et des documents de base.

Qu'est-ce que AgenticPW ?

Cette compétence est conçue pour transformer une tâche floue en un plan structuré avant le début de la mise en œuvre. Elle sert de pont en amont de `apw-implement` et en aval de `apw-research` / `apw-brainstorm`, garantissant que les décisions ne sont pas basées uniquement sur le contexte volatil. Son objectif principal est d'éviter deux échecs courants : se lancer dans le code sans plan solide, ce qui entraîne des oublis et des dérives par rapport à la demande initiale, et produire un plan qui perd le fil des exigences. La compétence prend en charge des documents durables comme `requirements.md`, `design.md` et `plan.md`, et suit un processus en cinq étapes pour garantir la clarté et l'alignement avant toute implémentation. La compétence est idéale pour les environnements agentiques où la planification et la documentation sont cruciales. Elle fonctionne sur toutes les plateformes prenant en charge les workflows agentiques (comme Cursor, Claude Code, Codex). Pour l'utiliser, l'agent absorbe d'abord toutes les entrées (brief, documents, artefacts existants, codebase), puis clarifie la compréhension avec l'utilisateur avant de choisir la profondeur des documents (FULL, MEDIUM ou PLAN). Ensuite, il produit les documents un par un, en ordre de dépendance, en s'arrêtant pour chaque révision. Si des conflits surviennent, l'agent doit les signaler immédiatement. Enfin, un résumé concis est fourni après approbation de tous les documents.

Compatible avec~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add AgenticPW/AgenticPW

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Utilisez cette compétence lorsqu'une tâche doit être transformée en plan avant que quiconque ne commence à la construire. C'est le compagnon amont de apw-implement et le consommateur aval de apw-research / apw-brainstorm : il prend un brief flou (plus tous les documents ou artefacts antérieurs) et produit des documents de planification durables sur lesquels une implémentation peut s'appuyer. Il existe pour lutter contre deux échecs : se lancer dans le code avec tout le plan détenu uniquement dans un contexte volatil — ce qui fait sauter des étapes et dérive le travail de la demande initiale — et produire un plan qui perd le fil des exigences qu'il était censé satisfaire. Suivez les étapes ci-dessous strictement et dans l'ordre.

Style de sortie

Lorsque cette compétence demande un plan, un rapport, un résumé, une mise à jour de statut ou toute autre sortie destinée à la conversation, privilégiez les puces ou les listes numérotées plutôt que les paragraphes simples. Gardez chaque élément concis et porteur de sens. Omettez le langage qui ne fait que lisser le ton, répéter le contexte ou ajouter du "sucre langagier" sans changer le sens.

Étape 1 — Absorber les entrées

Avant de former un plan, lisez tout ce qui définit la tâche :

  • Le brief — la description de la tâche, le ticket ou la demande telle que donnée.
  • Le matériel fourni — tous les documents, specs, designs ou références remis avec.
  • Les artefacts antérieurs — si les artefacts research.md ou brainstorm.md de votre élément de travail existent (voir apw-work-with-work-item-artifacts pour savoir où ils se trouvent), le plan s'appuie sur eux, il ne refait pas leur travail.
  • La codebase — les fichiers, modules et conventions que le travail va toucher, afin que le plan s'adapte à la réalité plutôt qu'à une architecture imaginée.

Ne sautez pas cette étape, même si la tâche semble petite. Un plan n'est aussi bon que l'image qui le sous-tend.

Étape 2 — Énoncer votre compréhension, demander et choisir la profondeur

D'abord, rédigez une déclaration concise de ce que vous comprenez devoir être fait — l'objectif, le périmètre tel que vous le lisez, et les principaux éléments de travail. Cela donne à l'utilisateur quelque chose de concret à corriger avant que tout document ne soit rédigé.

Ensuite, dans le même tour :

  • Posez jusqu'à 5 questions principales — uniquement les ambiguïtés réelles qui changeraient le plan. Ignorez celles auxquelles vous pouvez déjà répondre à partir de l'étape 1. Ne demandez pas pour demander.
  • Demandez quelle profondeur de document produire (utilisez l'outil AskUserQuestion) :
    • FULL — requirements.md + design.md + plan.md. Pour les travaux plus importants ou à forts enjeux où le quoi et le comment méritent d'être fixés avant tout code.
    • MEDIUM — design.md + plan.md. Lorsque les exigences sont déjà claires (ou capturées en amont) mais que l'approche technique/UI nécessite encore une décision.
    • PLAN — plan.md uniquement. Pour les travaux bien compris qui ont juste besoin d'être décomposés en étapes ordonnées et vérifiables.

Attendez les réponses de l'utilisateur et leur choix de profondeur avant de produire quoi que ce soit.

Étape 3 — Produire et confirmer les artefacts, un par un

Écrivez les documents (requirements.md, design.md, plan.md) dans le dossier d'artefacts de votre élément de travail — voir apw-work-with-work-item-artifacts pour savoir où se trouvent les artefacts des éléments de travail.

Produisez les documents un par un, dans l'ordre des dépendances — jamais tous à la fois. Après avoir écrit chaque artefact, arrêtez-vous : dites à l'utilisateur qu'il est prêt (avec son chemin) et un résumé d'une ou deux lignes de ce qu'il contient, puis attendez leur révision. L'utilisateur soit :

  • valide → passez à l'artefact suivant, ou
  • demande des modifications → révisez cet artefact et représentez-le, en répétant jusqu'à validation.

Ne construisez l'artefact suivant que sur un précédent confirmé — la conception ne doit pas être écrite tant que les exigences ne sont pas approuvées, et le plan ne doit pas être écrit tant que la conception (et les exigences) ne sont pas approuvées. Cet ordre est le point clé : les documents ultérieurs référencent les ID des documents antérieurs, donc chaque porte empêche le document suivant d'être construit sur quelque chose que l'utilisateur était sur le point de modifier.

La séquence dépend de la profondeur choisie à l'étape 2 :

  • FULL → requirements.md → révision → design.md → révision → plan.md → révision
  • MEDIUM → design.md → révision → plan.md → révision
  • PLAN → plan.md → révision

Chaque document, en utilisant les modèles de ce dossier de compétence :

  • requirements.md (FULL uniquement) — REQUIREMENTS_TEMPLATE.md. Donnez à chaque exigence un ID stable (R1, R2, …) afin que la conception et le plan puissent la référencer. Les ID ne doivent pas changer une fois assignés.
  • design.md (FULL et MEDIUM) — DESIGN_TEMPLATE.md. Couvre la conception technique (les principales décisions techniques, comment les pièces s'assemblent, ce qui a été rejeté) et — uniquement lorsque la tâche a une interface utilisateur — la conception UI sous forme de maquettes ASCII. Donnez à chaque décision de conception un ID stable (D1, D2, …) et liez-la à la ou les exigences qu'elle sert. Supprimez la section UI lorsqu'il n'y a pas d'interface utilisateur.
  • plan.md (toutes les profondeurs) — PLAN_TEMPLATE.md. La liste ordonnée des sous-tâches. Règles :
    • Chaque sous-tâche est une case à cocher : - [ ], laissée non cochée. La case est destinée à l'agent implémentateur pour cocher (- [x]) au fur et à mesure qu'il termine cette tâche — c'est le mécanisme de transfert vers apw-implement.
    • En FULL/MEDIUM, chaque tâche nomme ce qu'elle implémente — (implémente : R2, D1). Un plan qui ne remonte pas aux exigences/conception dont il est issu est la dérive exacte que cette compétence existe pour empêcher. En profondeur PLAN, il n'y a pas de documents amont, donc supprimez les références et gardez chaque tâche autonome.
    • Chaque tâche est concrète et vérifiable indépendamment, avec une note d'acceptation "fait quand".
    • Ordonnez les tâches pour que les dépendances viennent en premier ; regroupez en phases si le travail est important.

Étape 4 — Faire remonter les conflits

Si, pendant la planification, vous trouvez que les entrées se contredisent, qu'une exigence est impossible telle qu'énoncée, ou que le périmètre est matériellement plus large que ce que le brief suggérait — arrêtez-vous et dites-le à l'utilisateur. Recadrez avec eux plutôt que d'écrire un plan confiant et bien structuré pour le mauvais problème.

Étape 5 — Résumé concis

Chaque artefact a déjà été révisé et approuvé un par un à l'étape 3, donc c'est une courte conclusion finale, pas la première occasion de s'y opposer. Gardez la conversation brève — les détails se trouvent dans les artefacts. Rapportez uniquement :

  • La profondeur choisie et les chemins vers tous les documents écrits.
  • La forme du plan en une ou deux lignes — nombre de phases, nombre de tâches, l'épine dorsale de l'approche.

Confirmez ensuite qu'il est prêt à être remis à apw-implement, et offrez un dernier coup d'œil au cas où quelque chose dans l'ensemble devrait changer maintenant que tout est visible ensemble.

Skills associés