# 観察と含意の対応表

README 本文の推測を支える観察の一覧。「観察」はリポジトリから直接読める事実、「含意」はこの記事の読み（推測）で、両者は別物として扱う。

| 観察（リポジトリ内の事実） | 含意（推測） |
| --- | --- |
| TODO.md に「読み方（オーケストレーター向け）」節。タスク ID、依存欄、「依存がすべて `[x]` になったら並列着手可」「1 タスク = 1 worktree = 1 squash merge」 | タスク表は人間の備忘録ではなく、オーケストレーターがワーカーに仕事を切り出すための構造化インタフェース |
| docs/sketch/2026-11-03-wave3-prompts.md に、wave 単位のタスク分割と子セッション向けプロンプト草案がコミット済み | オーケストレーション自体が成果物として記録されている。プロンプトの改版履歴 = 手続きの実験ログ |
| skills/gom-agent-guide: 「LLM の事前知識に Gom はほぼ存在しない」を前提にした言語ツアーと間違い集。`.devin/skills/` へ symlink | 利用者より先にエージェントへの onboarding を整備している。読者は機械 |
| decisions/ 79 件。`状態: draft` で起票 → prototype 検証 → sketch に結果 → 状態更新。覆すときは旧 decision を消さず Supersedes 参照 | 決定の「証拠付き履歴」を機械的に辿れる形にして、後続セッションの再判断コストを下げている |
| sketch/ 57 件、problems/ 50 件、implementation-gaps.md 台帳。「1 件 1 ファイル、ファイル名は変えない」 | 揮発するセッションの代わりにリポジトリが長期記憶を持つ。リンク安定性はエージェントの検索のため |
| 実装完了報告 → フレッシュなセッションがレビュー → 要不要判断して更新。second-opinion review は main で再検証してから起票 | 実装者自身の文脈を信用しない構造。同じモデルでも「新鮮なコンテキスト」をレビュー手段に使っている |
| V-2..V-5: gomgen 生成器、eval-vs-compiled 差分 fuzz、HM 推論 witness オラクル、fmt 往復 fuzz。divergence / 既知バグは専用レジストリ | 「正しさ」を人間の diff 閲覧に頼らず機械判定する品質ゲート。squad の成果検査を自動化する布石 |
| AGENTS.md の文書の正テーブル: spec / design / decisions / open-questions / TODO / sketch / problems / implementation-gaps に更新権限を分離 | 「勝手に実装に合わせて spec を書き換えない」など、エージェントが行き過ぎたときのための境界線 |
| 122 コミット / 3 日、コミットはすべて podhmo 名義だが wave3-prompts 等に子セッションの存在が明示 | 実装の相当部分は分隊に委譲されている（ただし各コミットの実作者は記録からは判別不能） |
| spec.md の未実装例には「将来の例」と注記が付き、7 ブロックが実測で監査済み | 文書の正しさまで検証対象に含める姿勢。嘘のあるドキュメントはエージェントの共有メモリとして機能しないため |

## 参照したもの

- リポジトリ: https://github.com/podhmo/gom （2026-11-03 時点の main）
- 作者の投稿（squad / swarm、オーケストレーターのモデル差、工夫の列挙）: https://x.com/podhmo/status/2117504262272139706
- 運用条件「Devin の SWE-2 local use が無料なので全部 SWE-2 effort=max」は、記事執筆の依頼で作者から直接伝えられた情報。追記で作者から「コードは基本的に全部 SWE-2 だが、最初のドキュメント（spec.md・design.md）は SWE-2 ではない」と訂正あり
- 追記の「著者の回答」（存在しない言語への認識力の測定、MoonBit との対照、関数型・式志向への好み）は、記事公開後に作者本人から伝えられたもの
