タスク同期/非同期依存関係マトリクス + 開発着手順序ロードマップ¶

出典: docs/core/workflow.md §3 Issue ライフサイクル、docs/core/poc-beta-scope.md §3 ロードマップ

Phase 別依存関係マトリクス¶

Stage1-Phase1 Core（Beta M0 — Foundations）¶

全 Phase1 タスクは 相互に並行実施可能（依存関係なし）。ただし、Phase 2 以降は Phase 1 が 全て完了 していることが前提。

Stage1-Phase2 Base（Beta M1 — MVP 依存）¶

前提: Phase 1 が全て完了していること。

Stage1-Phase3 Features（Beta M1/M2 — Main Features）¶

前提: Phase 2 が完了していること（特に #44 Outbox Publisher）。

Stage1-Phase4 Advanced（Beta M2/M3）¶

前提: Phase 3 が完了していること。

依存関係グラフ¶

graph LR
    subgraph Phase1 [Phase 1 — Foundations]
        infra38[recerdo-infra #38<br/>Docker Compose]
        infra39[recerdo-infra #39<br/>CI/CD テンプレ]
        infra40[recerdo-infra #40<br/>Traefik + Flipt + Obs]
        proto25[recerdo-shared-proto #25<br/>buf lint / proto]
        lib27[recerdo-shared-lib #27<br/>JWT middleware]
        lib28[recerdo-shared-lib #28<br/>Idempotency + RateLimit]
        core42[recerdo-core #42<br/>CA 構造 + CI/CD + Health]
        core43[recerdo-core #43<br/>DB スキーマ + マイグレ]
    end

    subgraph Phase2 [Phase 2 — MVP deps]
        core44[recerdo-core #44<br/>Outbox + QueuePort]
        core45[recerdo-core #45<br/>Permission / RBAC]
        core46[recerdo-core #46<br/>Storage / Garage CAS]
        infra41[recerdo-infra #41<br/>Beta デプロイ]
    end

    subgraph Phase3 [Phase 3 — Main Features]
        core47[Events #47]
        core48[Album #48]
        core49[Timeline #49]
        core50[Notification #50]
        core51[Media Transcoder #51]
    end

    subgraph Phase4 [Phase 4 — Advanced]
        core52[Audit #52]
        admin27[Admin Console UI #27]
        cli10[Admin CLI #10]
        infra42[Integration Tests #42]
    end

    core42 --> core44
    core43 --> core44
    core42 --> core45
    core43 --> core45
    lib27 --> core45
    core42 --> core46
    core43 --> core46
    infra38 --> infra41
    infra39 --> infra41

    core44 --> core47
    core45 --> core47
    core44 --> core48
    core46 --> core48
    core44 --> core49
    core47 --> core49
    core48 --> core49
    core44 --> core50
    core44 --> core51
    core46 --> core51

    core44 --> core52
    core45 --> admin27
    core52 --> admin27
    admin27 --> cli10
    Phase3 --> infra42

開発推奨順序（Scrum Sprint 想定）¶

Sprint 1 — Beta M0, Week 1–2¶

全 Phase 1 タスクを並行実施（開発者を機能領域でアサイン）。

• インフラ担当: recerdo-infra #38, #39, #40
• バックエンド担当 A: recerdo-shared-proto #25、recerdo-shared-lib #27, #28
• バックエンド担当 B: recerdo-core #42, #43
• フロント担当: recerdo-ios #11、recerdo-android-dart #2、recerdo-spa-webclient #2

Sprint 2 — Beta M1, Week 3–4¶

Phase 2 タスクを並行実施（Phase 1 完了が前提）。

• バックエンド担当 A: recerdo-core #44（Outbox）、#45（Permission）
• バックエンド担当 B: recerdo-core #46（Storage）
• インフラ担当: recerdo-infra #41（Beta デプロイ）

Sprint 3 — Beta M1/M2, Week 5–7¶

Phase 3 タスクを依存関係に従って実施。

• #47 (Events) と #48 (Album) は並行実施可
• #49 (Timeline) は #47 / #48 の Saga イベント定義後に着手
• #50 (Notification) と #51 (Media Transcoder) は並行実施可

LLM エージェント向け判断ルール¶

AI エージェントがこの文書を参照して自律的にタスクを選ぶ場合、以下を順に適用する。

1. Phase の優先: 現在着手可能な最も若い Phase の Issue を選ぶ。Phase n+1 の Issue は Phase n の Issue が 全て 完了するまで着手しない。
2. 同期前提の確認: Issue の「同期前提（必須）」欄に挙がる Issue が全て status:done であることを確認する。未完了がある場合は着手しない。
3. 非同期可の活用: 同一 Phase 内で「非同期可」と書かれた Issue は並行実施可能。複数エージェントで分担する際の分割軸に使う。
4. security:review ラベル付き Issue の扱い: AI によるコード生成は禁止（poc-beta-scope.md §1.2）。該当 Issue は人間が実装する。
5. 依存関係の双方向性: ある Issue が別 Issue の前提である場合、そのことを両 Issue の本文に Linked Issues として明記する。

メンテナンス¶

• 新しい Phase の Issue が追加された場合、本文書のマトリクスに追記する。
• Issue の優先順位・依存関係が変わった場合、docs/core/sprints/ 配下のスプリント報告と併せて更新する。
• Phase 進行に応じて status:done の Issue はマトリクスから削除せず、履歴として残す（完了年月日を付記）。

参考文献¶

• 開発ワークフロー §2 Milestone / Sprint 運用
• PoC/Beta スコープ §3 実装ロードマップ
• ADR-0001 命名規約
• ADR-0002 リポレイアウト（per-service）