Spec vers Implémentation

Convertir une spec Notion en plans d'implémentation liés, tâches et mises à jour de statut continues.

Démarrage rapide

1. Localisez la spec avec Notion:notion-search, puis récupérez-la avec Notion:notion-fetch.
2. Analysez les requirements et ambiguïtés en utilisant reference/spec-parsing.md.
3. Créez une page de plan avec Notion:notion-create-pages (choisissez un template : rapide ou complet).
4. Trouvez la base de données des tâches, confirmez le schéma, puis créez les tâches avec Notion:notion-create-pages.
5. Liez spec ↔ plan ↔ tâches ; maintenez le statut à jour avec Notion:notion-update-page.

Flux de travail

0) Si un appel MCP échoue parce que Notion MCP n'est pas connecté, mettez en pause et configurez-le :

1. Ajoutez le Notion MCP :
   • codex mcp add notion --url https://mcp.notion.com/mcp
2. Activez le client MCP distant :
   • Réglez [features].rmcp_client = true dans config.toml ou exécutez codex --enable rmcp_client
3. Connectez-vous avec OAuth :
   • codex mcp login notion

Après une connexion réussie, l'utilisateur devra redémarrer codex. Vous devez terminer votre réponse et lui dire que lors de la prochaine tentative, il pourra continuer à l'étape 1.

1) Localisez et lisez la spec

• Recherchez d'abord (Notion:notion-search) ; en cas de résultats multiples, demandez à l'utilisateur lequel utiliser.
• Récupérez la page (Notion:notion-fetch) et analysez les requirements, critères d'acceptation, contraintes et priorités. Consultez reference/spec-parsing.md pour les patterns d'extraction.
• Capturez les lacunes/hypothèses dans un bloc de clarifications avant de poursuivre.

2) Choisissez la profondeur du plan

• Changement simple → utilisez reference/quick-implementation-plan.md.
• Feature multi-phase/migration → utilisez reference/standard-implementation-plan.md.
• Créez le plan via Notion:notion-create-pages, incluez : aperçu, spec liée, résumé des requirements, phases, dépendances/risques et critères de succès. Liez de nouveau à la spec.

3) Créez les tâches

• Trouvez la base de données des tâches (Notion:notion-search → Notion:notion-fetch pour confirmer la source de données et les propriétés requises). Patterns dans reference/task-creation.md.
• Dimensionnez les tâches à 1–2 jours. Utilisez reference/task-creation-template.md pour le contenu (contexte, objectif, critères d'acceptation, dépendances, ressources).
• Définissez les propriétés : titre/verbe d'action, statut, priorité, relations vers spec + plan, date limite/story points/assignataire si fournis.
• Créez les pages avec Notion:notion-create-pages en utilisant le data_source_id de la base de données.

4) Liez les artifacts

• Le plan relie à la spec ; les tâches relient aux deux plan et spec.
• Optionnellement, mettez à jour la spec avec une courte section « Implémentation » pointant vers le plan et les tâches en utilisant Notion:notion-update-page.

5) Suivez la progression

• Utilisez le cadence dans reference/progress-tracking.md.
• Publiez les mises à jour avec reference/progress-update-template.md ; fermez les phases avec reference/milestone-summary-template.md.
• Maintenez les listes de contrôle et les champs de statut du plan/des tâches en synchronisation ; notez les blocages et les décisions.

Références et exemples

• reference/ — patterns d'analyse, templates plan/tâche, cadence de progression (ex. spec-parsing.md, standard-implementation-plan.md, task-creation.md, progress-tracking.md).
• examples/ — walkthroughs end-to-end (ex. ui-component.md, api-feature.md, database-migration.md).