M3E: Skill for Claude Code

canvas-protocol — Agent ↔ Canvas Interaction Rules

M3E マップを共有 canvas として agent と人間で使う。canvas は 任意の同期ポイントであり、 agent の主作業 (実装・テスト・PR) は canvas 不在でも完結できる設計を保つ。

1. Target server

• default: beta (port 4173)
• map discovery: GET /api/maps で label="開発" の mapId を取得
• final (38482) は本番確認時のみ使う (m3e-map skill 参照)

2. Canvas Layout (固定パス)

M:(開発)> SYSTEM > DEV
├── strategy/                       # 開発戦略・タスクボード
│   └── HOME Re-implementation/     # プロジェクト単位のサブツリー
│       ├── Visual tasks/           # ロール別タスク
│       ├── Data tasks/
│       └── Team coordination/
├── reviews/                        # 人間の判断待ちキュー
│   └── {Project}/Q1, Q2, ...       # 各 Q の子ノードが選択肢
│       └── (option) attributes.selected="yes" で確定
├── Agent Status/                   # 各 worker の現在状態
├── tasks/ doing / ready / done     # devM3E の Phase 5 同期先
├── scratch/                        # アイデア・バグ報告・後回し
└── Bugs/                           # 既知バグ

3. Read Protocol (agent → canvas)

着手前に必ず実施:

# reviews/{Project} を読み、status="open" の Q に未回答が無いか確認
curl -s http://localhost:4173/api/maps | node -e "..."

判断:

• 該当 Q が attributes.selected="yes" 付き選択肢を持つ → その決定で進める
• status="open" で未選択 → 待機 or 自己解釈せず人間に確認
• status="resolved" だが selected が無い → 人間に再確認 (canvas が壊れている可能性)

重要: canvas に到達できない / fetch 失敗の時、agent は作業を止めない。 ローカルで実装ドラフトを進め、PR description に「canvas 未参照、要確認」と明記する。

4. Write Protocol (agent → canvas)

4.1 タスク開始

// strategy/{Project}/{Role} tasks/{taskNode}.attributes.status = "in_progress"
node.attributes = {...node.attributes, status: "in_progress", startedAt: "2026-04-14"};

4.2 タスク完了

node.attributes = {...node.attributes, status: "done", completedAt: "2026-04-14"};

4.3 新規 Q 起票 — Ambiguity Pooling (MUST)

原則: 曖昧点に当たったら block しない / silently 決めない。プールして暫定値で進む。akaghef が batch-review する。

reviews/{Project}/Qn (text="Qn: <一文の質問>",
  attributes={status:"open", raisedBy:"<role>", raisedAt:"YYYY-MM-DD"})
└── 選択肢 1 (details: Why / Trade-off)
└── 選択肢 2 (details: Why / Trade-off)
└── 選択肢 3 (attributes.tentative="yes" ← agent の暫定採用案)