ComposioHQ/notion-spec-to-implementation

Von der Spezifikation zur Implementierung

Konvertieren Sie eine Notion-Spezifikation in verknüpfte Implementierungspläne, Aufgaben und laufende Statusaktualisierungen.

Kurzanleitung

1. Suchen Sie die Spezifikation mit Notion:notion-search, rufen Sie sie dann mit Notion:notion-fetch ab.
2. Analysieren Sie Anforderungen und Unklarheiten mithilfe von reference/spec-parsing.md.
3. Erstellen Sie eine Planseite mit Notion:notion-create-pages (wählen Sie eine Vorlage: quick vs. full).
4. Finden Sie die Aufgabendatenbank, bestätigen Sie das Schema, dann erstellen Sie Aufgaben mit Notion:notion-create-pages.
5. Verknüpfen Sie Spezifikation ↔ Plan ↔ Aufgaben; halten Sie den Status mit Notion:notion-update-page aktuell.

Arbeitsablauf

0) Falls ein MCP-Aufruf fehlschlägt, weil Notion MCP nicht verbunden ist, pausieren und einrichten:

1. Fügen Sie das Notion MCP hinzu:
   • codex mcp add notion --url https://mcp.notion.com/mcp
2. Aktivieren Sie den Remote-MCP-Client:
   • Setzen Sie [features].rmcp_client = true in config.toml oder führen Sie codex --enable rmcp_client aus
3. Melden Sie sich mit OAuth an:
   • codex mcp login notion

Nach erfolgreicher Anmeldung muss der Benutzer Codex neu starten. Beenden Sie Ihre Antwort und teilen Sie ihm mit, dass er beim erneuten Versuch mit Schritt 1 fortfahren kann.

1) Spezifikation finden und lesen

• Suchen Sie zuerst (Notion:notion-search); bei mehreren Treffern fragen Sie den Benutzer, welche verwendet werden soll.
• Rufen Sie die Seite ab (Notion:notion-fetch) und durchsuchen Sie sie nach Anforderungen, Akzeptanzkriterien, Einschränkungen und Prioritäten. Siehe reference/spec-parsing.md für Extraktionsmuster.
• Halten Sie Lücken/Annahmen in einem Klärungsblock fest, bevor Sie fortfahren.

2) Planungstiefe wählen

• Einfache Änderung → verwenden Sie reference/quick-implementation-plan.md.
• Mehrphasiges Feature/Migration → verwenden Sie reference/standard-implementation-plan.md.
• Erstellen Sie den Plan über Notion:notion-create-pages, inklusive: Übersicht, verlinkte Spezifikation, Zusammenfassung der Anforderungen, Phasen, Abhängigkeiten/Risiken und Erfolgskriterien. Verlinken Sie zurück zur Spezifikation.

3) Aufgaben erstellen

• Finden Sie die Aufgabendatenbank (Notion:notion-search → Notion:notion-fetch, um die Datenquelle und erforderlichen Eigenschaften zu bestätigen). Muster in reference/task-creation.md.
• Dimensionieren Sie Aufgaben auf 1–2 Tage. Verwenden Sie reference/task-creation-template.md für den Inhalt (Kontext, Ziel, Akzeptanzkriterien, Abhängigkeiten, Ressourcen).
• Setzen Sie Eigenschaften: Titel/Aktionsverb, Status, Priorität, Beziehungen zu Spezifikation und Plan, Fälligkeitsdatum/Geschichtenpunkte/Verantwortlicher, falls angegeben.
• Erstellen Sie Seiten mit Notion:notion-create-pages unter Verwendung der data_source_id der Datenbank.

4) Artefakte verknüpfen

• Der Plan verlinkt auf die Spezifikation; Aufgaben verlinken auf beide, Plan und Spezifikation.
• Aktualisieren Sie optional die Spezifikation mit einem kurzen Abschnitt „Implementierung“, der auf den Plan und die Aufgaben verweist, mit Notion:notion-update-page.

5) Fortschritt verfolgen

• Verwenden Sie den Rhythmus in reference/progress-tracking.md.
• Posten Sie Updates mit reference/progress-update-template.md; schließen Sie Phasen mit reference/milestone-summary-template.md ab.
• Halten Sie Checklisten und Statusfelder in Plan/Aufgaben synchron; notieren Sie Blockaden und Entscheidungen.

Referenzen und Beispiele

• reference/ — Parsing-Muster, Plan-/Aufgabenvorlagen, Fortschrittsrhythmus (z. B. spec-parsing.md, standard-implementation-plan.md, task-creation.md, progress-tracking.md).
• examples/ — End-to-End-Durchläufe (z. B. ui-component.md, api-feature.md, database-migration.md).