notion-spec-to-implementation

仕様から実装へ

仕様を、進捗を追跡できる実行可能な実装計画に変換します。仕様書を取得し、要件を抽出してタスクに分割し、実装ワークフローを管理します。

クイックスタート

仕様の実装を依頼された場合：

1. 仕様を見つける：Notion:notion-search を使用して仕様ページを検索します
2. 仕様を取得する：Notion:notion-fetch を使用して仕様の内容を読み取ります
3. 要件を抽出する：仕様から要件を解析し、構造化します
4. 計画を作成する：Notion:notion-create-pages を使用して実装計画を作成します
5. タスクデータベースを見つける：Notion:notion-search を使用してタスクデータベースを検索します
6. タスクを作成する：Notion:notion-create-pages を使用して、タスクデータベースに個々のタスクを作成します
7. 進捗を追跡する：Notion:notion-update-page を使用して、進捗を記録しステータスを更新します

実装ワークフロー

ステップ 1：仕様を見つける

1. Search for spec:
   - Use Notion:notion-search with spec name or topic
   - Apply filters if needed (e.g., created_date_range, teamspace_id)
   - Look for spec title or keyword matches
   - If not found or ambiguous, ask user for spec URL/ID

Example searches:
- "User Authentication spec"
- "Payment Integration specification"
- "Mobile App Redesign PRD"

ステップ 2：仕様を取得して分析する

1. Fetch spec page:
   - Use Notion:notion-fetch with spec URL/ID from search results
   - Read full content including requirements, design, constraints

2. Parse specification:
   - Identify functional requirements
   - Note non-functional requirements (performance, security, etc.)
   - Extract acceptance criteria
   - Identify dependencies and blockers

解析パターンについては、reference/spec-parsing.md を参照してください。

ステップ 3：実装計画を作成する

1. Break down into phases/milestones
2. Identify technical approach
3. List required tasks
4. Estimate effort
5. Identify risks

Use implementation plan template (see [reference/standard-implementation-plan.md](reference/standard-implementation-plan.md) or [reference/quick-implementation-plan.md](reference/quick-implementation-plan.md))

ステップ 4：実装計画ページを作成する

Use Notion:notion-create-pages:
- Title: "Implementation Plan: [Feature Name]"
- Content: Structured plan with phases, tasks, timeline
- Link back to original spec
- Add to appropriate location (project page, database)

ステップ 5：タスクデータベースを見つける

1. Search for task database:
   - Use Notion:notion-search to find "Tasks" or "Task Management" database
   - Look for engineering/project task tracking system
   - If not found or ambiguous, ask user for database location

2. Fetch database schema:
   - Use Notion:notion-fetch with database URL/ID
   - Get property names, types, and options
   - Identify correct data source from <data-source> tags
   - Note required properties for new tasks

ステップ 6：実装タスクを作成する

For each task in plan:
1. Create task in task database using Notion:notion-create-pages
2. Use parent: { data_source_id: 'collection://...' }
3. Set properties from schema:
   - Name/Title: Task description
   - Status: To Do
   - Priority: Based on criticality
   - Related Tasks: Link to spec and plan
4. Add implementation details in content

タスクのパターンについては、reference/task-creation.md を参照してください。

ステップ 7：実装を開始する

1. Update task status to "In Progress"
2. Add initial progress note
3. Document approach and decisions
4. Link relevant resources

ステップ 8：進捗を追跡する

Regular updates:
1. Update task properties (status, progress)
2. Add progress notes with:
   - What's completed
   - Current focus
   - Blockers/issues
3. Update implementation plan with milestone completion
4. Link to related work (PRs, designs, etc.)

進捗追跡のパターンについては、reference/progress-tracking.md を参照してください。

仕様分析のパターン

機能要件：ユーザーストーリー、機能の説明、ワークフロー、データ要件、統合ポイント

非機能要件：パフォーマンス目標、セキュリティ要件、スケーラビリティのニーズ、可用性、コンプライアンス

受け入れ基準：テスト可能な条件、ユーザーによる検証ポイント、パフォーマンスベンチマーク、完了の定義

詳しい解析手法については、reference/spec-parsing.md を参照してください。

実装計画の構成

計画に含める項目：概要 → 関連する仕様 → 要件の概要 → 技術的アプローチ → 実装フェーズ（目標、タスクのチェックリスト、見積もり工数） → 依存関係 → リスクと軽減策 → タイムライン → 成功基準

計画テンプレートの全文については、reference/standard-implementation-plan.md を参照してください。

タスク分割のパターン

コンポーネント別：データベース、API エンドポイント、フロントエンドコンポーネント、統合、テスト 機能スライス別：垂直スライス（認証フロー、データ入力、レポート生成） 優先度別：P0（必須）、P1（重要）、P2（あると望ましい）

進捗の記録

毎日の更新（作業中）：完了した項目、現在の注力事項、ブロッカーを含む進捗メモを追加します マイルストーンの更新（大きな進捗）：計画のチェックボックスを更新し、マイルストーンの概要を追加して、タイムラインを調整します ステータスの変更（タスクの遷移）：プロパティを更新し（進行中 → レビュー中 → 完了）、完了メモを追加して、成果物をリンクします

進捗の形式：日付の見出し → 完了 → 進行中 → 次のステップ → ブロッカー → メモ

詳しいパターンについては、reference/progress-tracking.md を参照してください。

仕様と実装のリンク

順方向リンク：計画とタスクにリンクする「実装」セクションを仕様ページに追加します 逆方向リンク：「仕様」セクションを設け、計画とタスクで仕様を参照します 双方向のトレーサビリティ：追跡しやすいよう、両方向のリンクを維持します

実装ステータスの追跡

計画のステータス：フェーズの完了状況（✅ 完了、🔄 進行中 %、⏳ 未着手）と全体の進捗率を更新します タスクの集計：計画 ID でタスクデータベースを検索し、概要（完了、進行中、ブロック中、未着手）を生成します

仕様変更への対応

検出：更新された仕様を取得 → 計画と比較 → 新しい要件を特定 → 影響を評価 反映：計画を更新 → 新しいタスクを作成 → 影響を受けるタスクを更新 → 変更メモを追加 → コメントで通知 変更ログ：日付、変更内容、影響を記録して仕様の変遷を追跡

よくあるパターン

機能フラグ：バックエンド（フラグで制御）→ テスト → フロントエンド（フラグで制御）→ 内部展開 → 外部展開 データベース移行：スキーマ設計 → 移行スクリプト → ステージングテスト → 本番移行 → 検証 API 開発：API 設計 → バックエンドの実装 → テストとドキュメント → クライアントとの統合 → デプロイ

ベストプラクティス

1. 仕様と実装を必ず相互にリンクする：双方向の参照を維持します
2. 小さなタスクに分割する：各タスクは1～2日で完了できるようにします
3. 明確な受け入れ基準を設ける：「完了」の条件を明確にします
4. 依存関係を早期に特定する：計画にブロッカーを記載します
5. 進捗を定期的に更新する：進行中の作業について毎日記録します
6. 変更を追跡する：仕様の更新とその影響を記録します
7. チェックリストを使う：進捗を視覚的に示すと、全員が状況を把握しやすくなります
8. 成果物をリンクする：PR、デザイン、ドキュメントからタスクにリンクします

高度な機能

追加の実装パターンと手法については、reference/ 内のリファレンスファイルを参照してください。

よくある問題

「仕様が見つからない」：仕様名やトピックで Notion:notion-search を使い、より広い用語でも検索するか、ユーザーに URL を尋ねてください 「仕様が複数見つかった」：どの仕様を実装するかユーザーに尋ねるか、候補を提示してください 「タスクデータベースが見つからない」：「Tasks」または「Task Management」を検索するか、データベースの場所をユーザーに尋ねてください 「仕様が不明確」：計画に曖昧な点を記載し、明確化のためのタスクを作成してください 「要件が矛盾している」：矛盾点を記録し、判断のためのタスクを作成してください 「スコープが大きすぎる」：より小さな仕様やフェーズに分割してください

例

一連のワークフローについては、examples/ を参照してください：

• examples/api-feature.md - API 機能の実装
• examples/ui-component.md - フロントエンドコンポーネント
• examples/database-migration.md - スキーマ変更