Spécification à Implémentation

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

Démarrage rapide

1. Localisez la spécification avec Notion:notion-search, puis récupérez-la avec Notion:notion-fetch.
2. Analysez les exigences et ambiguïtés en utilisant reference/spec-parsing.md.
3. Créez une page de plan avec Notion:notion-create-pages (choisissez un modèle : rapide ou complet).
4. Trouvez la base de données des tâches, confirmez le schéma, puis créez des 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 car 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 :
   • Définissez [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 spécification

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

2) Choisissez la profondeur du plan

• Changement simple → utilisez reference/quick-implementation-plan.md.
• Fonctionnalité 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 exigences, phases, dépendances/risques et critères de succès. Reliez à la spec.

3) Créez des 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). Modèles 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 à spec + plan, date d'échéance/story points/assigné si fournis.
• Créez des pages avec Notion:notion-create-pages en utilisant le data_source_id de la base de données.

4) Liez les artefacts

• Le plan se lie à la spec ; les tâches se lient à la fois au plan et à la spec.
• Mettez éventuellement à 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/tâches en synchronisation ; notez les blocages et décisions.

Références et exemples

• reference/ — modèles d'analyse, templates de plan/tâches, cadence de progression (p. ex. spec-parsing.md, standard-implementation-plan.md, task-creation.md, progress-tracking.md).
• examples/ — procédures pas à pas de bout en bout (p. ex. ui-component.md, api-feature.md, database-migration.md).