ヒント — これだけ知れば指示できる
エージェントに：「一番長いファイルを見つけて関数ごとに分離して。ファイル名は関数名と同じに。既存テスト全パス必須。」
エージェントに：「filefunc validate 回して違反0にして。既存テスト全パス必須。」
エージェントに：「tsma next 繰り返して全関数にテスト追加。未カバー分岐が出たらそのテストも追加。All functions completeまで。」
Go、TypeScript、Python全対応。
なぜこう指示すべきなのか
SWEが読みやすいコード ≠ エージェントが操作しやすいコード
エージェントはファイル全体をロードする。1ファイルに関数20個なら19個が不要なコンテキスト汚染。研究によると不要情報が混ざるとAI性能が30〜85%低下。
filefunc — 1ファイル1概念
原則：1ファイル = 1概念。ファイル名 = 概念名。 Honoフレームワーク（star 23k+）で実証：186ファイル → 626ファイル。テスト4,419個、1つも壊れなかった。
tsma — レガシーコードの回帰防衛線
tsma next → テスト作成 → 未カバー分岐を行番号で通知 → エージェントがカバー → PASS → 次の関数。エージェントが死んでもsession.jsonに進捗保存。
Agent Operable Codebaeの4条件
| 条件 | ツール | 効果 |
|---|---|---|
| 1ファイル1概念 | filefunc | コンテキスト汚染遮断 |
| 全関数にテスト | tsma | 修正後の回帰検知 |
| シンボリック参照で接続 | operationId (yongol) | レイヤー間追跡 |
| 暗黙的カップリング除去 | whyso coupling | 隠れた依存関係検出 |
第8講の核心メッセージ：電車を速くするな。線路を敷け。
関連記事
Reins Engineering 全講義
| 講 | タイトル |
|---|---|
| 第1講 | AIへの指示の仕方 |
| 第2講 | AIを信じない方法 |
| 第3講 | 壊れないアプリ |
| 第4講 | 決定をコードの外へ |
| 第5講 | 手綱のあるAI |
| 第6講 | 通過したら固定する |
| 第7講 | おべっかを逆手に |
| 第8講 | エージェントの工場 |
| 第9講 | コードを超えた自動化 |
| 第10講 | データの法 |
根拠資料出典
- Stanford, “Lost in the Middle” (2024) — 関連情報がコンテキスト中間に埋まると30%+低下
- Amazon, “Context Length Alone Hurts LLM Performance” (2025) — 不要トークンが空白でも13.9〜85%低下
- Hono実証 — 186 → 626ファイル、テスト4,419個全パス
- tsma 527関数実証 — PASS 246, DONE 281, TODO 0