Concordia

Concordia

複数の AI コーディングエージェントセッション間の **協調 / 認識 / 記録** サービス。

---

ラテン語で **同心 / 一致 / 協調** を意味し、 ローマ女神 Concordia (元老院・市民の和合の象徴) に由来する。 **lock せず**、 各セッションが自律的に状態を共有することで重複作業や知識の分断を防ぐ。

---

セットアップ

設定・起動手順は用途別に [`spec/setup/`](spec/setup/) にまとめてある:

• 本体を起動する / Windows で起動する / Discord bot / observability / セッション管制 spawn
• 全設定キー: spec/setup/config-reference.md

---

解決する課題

複数の AI コーディングエージェント (Claude Code / Gemini CLI / Codex CLI など) を並行して使うとき、 以下が起きる:

1. 同じ repo を複数セッションで触っていて、 互いの作業を知らない
2. 片方のセッションが落ちたことに気付かず、 残作業が宙に浮く
3. セッション終了時のレポートが手作業で大変
4. どのセッションが今動いているかが見えない

Concordia は repo・session・event を 1 つの SQLite に集約し、 各エージェントの hook から HTTP で報告させることで、 これらを解決する。

---

アーキテクチャ概観

┌──────────────────┐     hooks (HTTP)    ┌────────────────────────┐
│ Claude Code      ├────────────────────►│ Concordia (HTTP/Hono)  │
│ session          │  POST /v1/sessions  │  - sessions table      │
└──────────────────┘  POST /v1/.../event │  - session_events      │
┌──────────────────┐                     │  - session_reports     │
│ Gemini CLI       ├────────────────────►│  - background sweeper  │
│ (v0.2)           │                     │    (heartbeat→lost)    │
└──────────────────┘                     │  - jsonl recovery      │
┌──────────────────┐                     │  - worktree manager    │
│ Codex CLI        ├────────────────────►│                        │
│ (v0.2)           │                     │  Backend: SQLit