specification-executor

仕様から実装へ

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

クイックスタート

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

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 - スキーマ変更