Agent-First Toolchain — ツールから選び直すハーネスエンジニアリング

コーディングエージェントのハーネスを整える中で、スキルではなくツールを選び直した話。開発用DBを PostgreSQL on Docker から SQLite へ、E2Eテストを Playwright から agent-browser へ、デザイン連携を Figma MCP から素のHTMLへ、開発環境を Docker / Homebrew から Nix devShell へ。エージェントのために選び直してみると、基準は「使い捨てできる・直接操作できる・持ち出せる・宣言的に定義できる」といったものであり、それは Easy よりも Simple なツールを評価するという、昔からある普遍的な価値基準でした。

Transcript

1. Gunma.web #60 / 2026.07.18 Agent-First Toolchain ツールから選び直すハーネスエンジニアリング
2. Hikaru Otabe 大田部 晃 フリーランスエンジニア who am i
3. Issue起票 計画ループ 作成 → レビュー → 修正 実装ループ 実装 → テスト → レビュー → 修正 PR作成 悩み introduction ぼくのかんがえたさいきょうのハーネス モックだらけの単体テスト・穴だらけのE2Eテスト - 開発・検証用の仮想環境が乱立して重い - Figmaのデザインと全然違う - 知らないうちに色々なツールがインストールされる -
4. スキルではなく、 ツールを見直してみた approach
5. + SQLite on FileSystem After changelog 1/4 開発用のDB - PostgreSQL on Docker Before 仮想環境 + volumeで重い - 依存するテストがモックになりがち - 毎回起動したり空いているポートを探 したり面倒 - 軽い + 一時ファイルの実DBを使って並列でテ ストできる + DBファイルをLLMが直接編集してくれ る +
6. サーバー不要・設定不要の組み込み型SQLデータベース。 changelog 1/4 SQLiteとは サーバープロセスを持たず、アプリに組み込まれるライブラリとして動く · 1つのファイルが1つのDB。コピー・削除するだけで複製・破棄できる · トランザクション（ACID）対応のフル機能SQLエンジン · スマホ・ブラウザ・OSに標準搭載。世界で最も利用されているDBエンジン · パブリックドメインで、用途を問わず無料で使える ·
7. + agent-browser After changelog 2/4 E2Eテスト環境 - Playwright Before 実装の手間がかかる - あらゆるシナリオを正確に再現するの は難しい - 書いた通りにしか動かない - 観点やシナリオだけ渡せば良い + 実際の人間の操作に近い + 探索的にテストしてくれる +
8. Vercel Labs製の、AIエージェント用ブラウザ操作CLI。 changelog 2/4 agent-browserとは Rust製のCLI。デーモンが常駐してブラウザを保持するから応答が速い · snapshot で観測したものを直接操作する · 旧来の具体的なセレクタによる操作ではないので壊れにくい · スクリーンショットやJS実行、Electronアプリの操作もできる · Playwright MCPよりコンテキスト消費が小さい · パスワードマネージャーなどの機能が豊富 ·
9. + HTML After changelog 3/4 デザイン - Figma MCP Before トークン消費が激しい - レート制限が厳しい - 運用を頑張らないと実態と乖離していく - トークン消費が小さく、速い + ベンダーロックインがない + Git管理できる +
10. + Nix devShell After changelog 4/4 開発環境 - Docker - Homebrew Before 仮想環境が増えると重いし、状況を把 握しきれない - AIが何を入れたか分からず、グローバル 環境が汚染される - 仮想環境なしで、ディレクトリごとに環 境を定義できる + 必要な環境をテキストファイルで宣言し て、Git管理できる +
11. 純粋関数型のパッケージマネージャー & ビルドシステム。 changelog 4/4 Nixとは パッケージや環境を、Nix言語で宣言的に定義する · ビルド結果は /nix/store にハッシュ付きで隔離され、互いに干渉しない · 同じ定義からは常に同じ結果が得られる（再現性） · 12万以上のパッケージを持つ公式リポジトリ nixpkgs · Linux / macOS で動く。NixOSというディストリビューションもある ·
12. zsh — ~ $ aws --version zsh: command not found: aws $ cd github.com/me/website $ nvim flake.nix $ direnv allow direnv: loading ~/github.com/me/website/.envrc direnv: using flake direnv: nix-direnv: Using cached dev shell $ aws --version aws-cli/2.27.50 Python/3.13.4 Darwin/25.4.0 source/arm64 changelog 4/4 Nix devShell
13. Nix devShell Declarative ディレクトリごとの宣言的な開発環境 Issue起票 計画ループ 実装ループ ブラウザ検証 PR作成 素のHTML デザインモックを直接作る Portable SQLite 一時ファイルの実DBで並列テスト Disposable agent-browser 自分の目と手で操作 Interactive apply 新しいツールをハーネスに適用する
14. SQLite 使い捨てできる 軽量で再現性があれば、壊れても作り直して試行できる agent-browser 直接操作できる 自由を与えれば人間以上の仕事ができる HTML どこへでも持ち出せる Gitで管理して、どんな環境やツール、エージェントでも使える Nix devShell 宣言的に定義できる 暗黙的な部分が増えるほどAIのコンテキストを圧迫し、人間の認知負荷も高く なる summary ハーネスエンジニアリングによって ツールの選び方が変わった
15. Simple trend EasyよりSimpleなツールが見直されている Easy VSCode - Notion - MCP - Ruby / Python - Terminal + tmux + Markdown（Obsidian） + CLI + Rust +
16. Gunma.web #60 / 2026.07.18 Agent-First Toolchain?