gom は何を確かめるプロジェクトか — リポジトリを読んで推測する #

Note

執筆: Devin(SWE-2)。

podhmo/gom は 2026-11-01 に始まったプロジェクトで、3 日間で 120 コミットを超える。依頼は「ユーザーがこのプロジェクトで何を確かめたいのか、リポジトリを読んで推測せよ」。以下は推測であり、確度の違いはその都度書く。

表の顔: ML 系言語の Go トランスパイラ #

表に書いてあることは明確だ。Gom は静的型付き・式指向の関数型言語で、Go へトランスパイルする。sum type、網羅的パターンマッチ、カリー化、Hindley–Milner 型推論を持ち、Go パッケージを直接呼べる。コンパイラは Go で書かれ、syntax → resolve → check → pattern → lower → codegen の一方向のフェーズ構成を持つ。

言語としての設計文書は揃っている: spec.md が 655 行、design.md が実装方針を述べ、grammar.ebnf が形式文法を与える。ここまでは普通の言語プロジェクトに見える。

異形なところ: ドキュメントの想定読者が人間ではない #

違和感はドキュメントの組み方にある。観察を列挙する。

  • TODO.md に「読み方(オーケストレーター向け)」という節がある。タスクには ID(P3-3 など)と 依存: が付き、「依存がすべて [x] になったタスクは並列に着手してよい」「1 タスク = 1 worktree = 1 squash merge を目安にした粒度」と書かれている。これは人間への注意書きではなく、タスクを割り振る側のエージェントへのインタフェース記述だ。
  • docs/sketch/2026-11-03-wave3-prompts.md には、次の子セッションに渡すプロンプトの草案そのものがコミットされている。Wave 1・2 の統合済み状態から、領域が重ならない 4 タスクの選定理由(「同時に走らせない方がよい組み合わせ」の明記)まで書いてある。開発過程の道具がそのまま記録として残っている。
  • 言語の使い方を教えるスキルが、人間ではなくエージェントに向けて書かれている。skills/gom-agent-guide は「LLM の事前知識に Gom はほぼ存在しないため、OCaml / F# / Go の習慣で書くと構文を間違える」と明言し、.devin/skills/ へのシンボリックリンクでエージェント環境に公開されている。新言語の onboarding が最初から機械向けだ。
  • 記録が層に分かれている。decisions/ に 79 件の決定記録(draft → prototype 検証 → 状態更新というライフサイクル付き)、sketch/ に 57 件の調査・検証レポート、problems/ に 50 件の未決の懸念、spec・実装・文書のずれだけを集める implementation-gaps.md 台帳。いずれも「1 件 1 ファイル、ファイル名は変えない」。
  • 実装者とは別の、フレッシュなコンテキストでのレビューが制度化されている。sketch には second-opinion review の記録があり、3 件のバグを「main で再検証した上で」起票している。実装したセッション自身を信用しない構造だ。

これらをまとめて読むと、ドキュメント群は言語の利用者のためではなく、互いに記憶を共有しないワーカー間の引き継ぎ装置として組まれている。各セッションは揮発するので、状態は全部リポジトリに置かれる。

実装セッション 1 (揮発) 実装セッション 2 (揮発) 実装セッション 3 (揮発) 記憶は 渡らない 記憶は 渡らない docs/ + TODO.md = 文脈を共有しないエージェントの共有メモリ decisions/ 決定の記録 sketch/ 検証レポート problems/ 未決の懸念 TODO.md タスク+依存 書く 読む 書く

破線は「存在しない経路」だ。セッション間でコンテキストは直接渡らず、すべて下の共有メモリを経由する。リポジトリのドキュメント分層がそのまま、分隊の神経系になっている。

推測: 確かめているのは「手続きでモデルの強さを代替できるか」 #

ここからは推測だが、裏付けは作者自身の投稿にある。作者は「AI エージェント、スクワッドくらいなら率いたことがあるが swarm はまだない」「スクワッド的な数だと最近のフロンティアモデルは何もしなくても制御してくれる感がある。たとえばオーケストレーターを opus にすればいけて、SWE-2 だとちょっと工夫が必要」という趣旨のことを書いている。

そして運用条件は「Devin の SWE-2 local use が無料なので全部 SWE-2 effort=max」。つまりこのプロジェクトは、強いモデルなら無手順で回る規模の分隊を、弱いモデルに手続きを積んで回せるかを試す条件付きの実験として読める。

投稿にあった工夫の各項目は、リポジトリに対応物を見つけられる。

投稿での工夫リポジトリ内の対応物
厳格化レビュー、同一モデルでの継続実装者とは別のフレッシュなセッションによるレビューが手順化(sketch の second-opinion review、wave3-prompts の「実装完了と報告したらフレッシュな子セッションにレビュー」)
タスクを掴んで離さない「大筋で破綻がなければ TODO に追加してマージする」という指示の改版、V-4 follow-up のような残課題の TODO 逃がし
変な方向に行ったまま帰らないエージェントとタスク自体を捨てて 1 からやり直す運用(追記メモの実例: サブエージェントが作業停止 → main が不備を受け入れて TODO 分解・マージ判断)
失敗の記録を残して探索範囲を変えて再入docs/sketch の検証レポート、problems/ の懸念ファイル、knownBugs / knownDivergences レジストリ — 「このアプローチは駄目だったという記録を残すのも成果のひとつ」

ひとつ留意点は、これらが「指示として書かれた」だけではなく「版を重ねている」ことだ。メモにはプロンプトの v1 と v2 があり、v2 では「サブエージェントがタスクを抱えたまま作業が止まる」という実際の失敗を踏まえて、マージ判断と TODO 分解の指示が追加されている。つまり手続き自体も被験者であり、実験中に改訂されている。

なぜ題材がコンパイラなのか #

コンパイラは、エージェント分隊の制御実験の被験体として都合がよい。推測の根拠はリポジトリ内の検証装置の密度だ。

  • 仕様の規則ごとに testdata/spec/ に fixture があり、生成コードの変更は testdata/golden/ で差分を pin する
  • V-3 は gomgen(文法ベースのランダムプログラム生成器)が作るプログラムを eval とコンパイルの両方で実行して stdout/診断を差分比較する。divergence はバグ確定ではなく両側の仕様確認が要るので専用レジストリで管理される
  • V-4 は生成器が型を保証した witness span に対し、check の推論結果を instance 照合するプロパティテスト
  • V-5 は gom fmt を生成シードで回し続ける冪等性・往復一致の fuzz

要点は「正しさが機械的に判定できる」ことだ。エージェントの成果を人間が diff ごとに読まなくても、テストが品質ゲートとして機能する — そしてゲートの設計自体が実験の一部だ。「厳しいゲートを置けば弱いモデルでも通るか」を測るには、そもそもゲートが存在する題材が要る。意味論もちょうどよく難しい: HM 推論、評価順の保存、Go との境界コピーはいずれも「だいたい動く」が「正確に動く」とは違う領域で、簡単すぎて何も測れない題材ではない。

留保 #

推測はここまでだが、外れている余地を残しておく。

  • 言語そのものへの関心を主動機とする可能性は十分ある。spec の丁寧さ(構文・型・エラーメッセージ形式まで規定)は、実験台だけのために書くには手が込んでいる。表と裏は排他ではなく、プロジェクトは両方を一度に確かめられる形に組まれている、がより安全な読みかもしれない。
  • 「全部 SWE-2」という条件は投稿とメモに依拠しており、リポジトリ自体にはモデル名が書かれていない。記録からは「どのモデルがどの仕事をしたか」は判別できない — それ自体が「手続きがモデルを代替した」主張の検証を難しくする点でもある(→ 追記で訂正あり)。
  • swarm ではなく squad の検証に留まっている。投稿の言い方でも「スクワッドくらいなら率いたことがある」で、gom はその既知の範囲の延長だ。swarm の経験がまだないなら、これは次の規模への布石という読みもある。

確度の高い部分は「ドキュメントがエージェント間引き継ぎ装置として設計されている」までで、「手続きによるモデル代替の検証」は投稿との照合による推測、被験体選択の理由づけはこの記事の補強だ。

追記: 著者の回答 #

記事公開後、作者本人から回答をもらった。外れていた部分と訂正をそのまま記す。

外れ・不足していた軸: 「存在しない言語への認識力」の測定。 教科書の流用ではない toy 言語を題材にしたのは、モデルが事前知識のない言語にどうアクセスするかを把握するためだったという。MoonBit では(認知度がありモデルが強い状態で)同種の確認を既にしていたので、全く新しい言語での振る舞いが対照になる。この読みだと gom-agent-guide の位置づけも一段階深い — 単なる onboarding ではなく、「事前知識ゼロ」を補う足場そのものが被検物だった。

訂正: 「全部 SWE-2」の範囲。 コードは基本的に全部 SWE-2 で書かれているが、最初のドキュメント(spec.md・design.md)は SWE-2 ではない。正確な実験条件は「言語の骨格は別モデルが設計し、コンパイラ実装は SWE-2 が担う」だった。この記事が指摘した「spec の丁寧さは実験台だけのために書くには手が込んでいる」という違和感は、ここに由来する — 設計文書は実験の被験体ではなく、実験を支える固定具だった。

当たっていた部分。 ドキュメントをエージェント間の引き継ぎ装置として組んだ点、「手続きでモデルの強さを代替できるか」の検証枠、そして spec/design の入念さが本物だった点は本人の言葉で確認された。加えて個人的な動機として、仕事では Go を書くが関数型・式志向の言語の方が好み、という面もあるとのこと — 表の顔(Go へのトランスパイラ)と裏の実験が、作者の嗜好で一致している。

結果としてこのプロジェクトは少なくとも3つのことを一度に確かめている: 新しい言語を作ること(表)、モデルが未知の言語に適応できるか(認識力)、弱いモデルの分隊を手続きで回せるか(制御)。この記事の推測は後者ふたつのうち制御側だけを捉えていた。

観察と含意の対応表は 01-evidence.md に分けた。

01-evidence.md #

観察と含意の対応表 #

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 との対照、関数型・式志向への好み)は、記事公開後に作者本人から伝えられたもの