放っておくと、すべてのソフトウェアプロジェクトが辿るグラフがある。コード行数は増える。依存関係は増える。ビルド時間は増える。システム全体を理解している人の数は減る。ある時点で、プロジェクトは一人の人間が全体を頭の中に収められなくなる閾値を超え、それ以降、すべての変更は完全には見えない複雑さとの交渉になる。
ほとんどのAIエージェントフレームワークは何年も前にその閾値を超えた。LangChainは数万行のコアコードを持つ。OpenClawのnode_modulesには1,200以上のパッケージが含まれる。「ミニマル」なフレームワークでさえ、ツール実行エンジン、プロバイダー抽象層、プラグインシステム、設定パーサーを数えると数千行になりがちだ。
NanoClawのコアは約500行のTypeScriptだ。機能が少ないからではない——WhatsAppメッセージング、コンテナ隔離、永続メモリ、スケジュールタスク、エージェントスウォーム、Web閲覧をサポートしている。複雑さがどこに存在すべきかについて、異なる賭けをしているからだ。
複雑さはどこかに存在しなければならない
「より少ないコード」の議論の正直なバージョンは、NanoClawが複雑さを排除したということではない。NanoClawが複雑さをより適切に管理される場所に移動したということだ。
エージェントループ——メッセージの受信、使用するツールの決定、ツールの実行、エラー処理、マルチターン会話の管理——は複雑だ。ほとんどのフレームワークでは、この複雑さはフレームワークのメンテナーが書いたアプリケーションコードに存在し、あなたはそれを信頼し、デバッグし、更新しなければならない。NanoClawでは、この複雑さはClaude Agent SDKに存在する。Anthropicのエンジニアリングチームが保守し、Claudeの実際の動作に対してテストされ、モデルと同期して更新される。
ツール実行——Web閲覧、ファイルアクセス、シェルコマンド——は複雑だ。ほとんどのフレームワークでは、各ツールは独自のエラーハンドリング、独自のリトライロジック、独自のセキュリティモデルを持つカスタム実装だ。NanoClawでは、ツールはコンテナ内のClaude Codeによって提供される。ツール実装はAnthropicが保守し、数千の開発者がClaude CodeのCLI経由で日常的に使っているのと同じツールだ。
セキュリティモデル——サンドボックス、権限強制、シークレット管理——は複雑だ。ほとんどのフレームワークでは、セキュリティはバグがありうるアプリケーションレベルのコードだ。NanoClawでは、セキュリティはオペレーティングシステムが強制するコンテナ隔離だ。Apple ContainerとDockerは何千人ものエンジニアによって何年もかけて堅牢化されてきた。NanoClawの80行のコンテナオーケストレーションコードは、その投資を複製しようとするのではなく活用する。
パターンは一貫している：NanoClawの500行は、十分に保守され、十分にテストされたコンポーネントを接続するオーケストレーション層だ。複雑さは存在するが、単一のオープンソースプロジェクトが匹敵できるよりも多くのリソースと専門知識を持つチームが保守するコンポーネントに存在する。
500行で何ができるか
500行が可能にする機能は、ほとんどの人が予想するよりも広い。機能はNanoClawのコードからではなく、コンポーネントから来るからだ。
Web閲覧が動くのは、コンテナイメージにChromiumとagent-browserが含まれているからだ。NanoClawはブラウザを実装しない——コンテナにマウントする。ファイルアクセスが動くのは、コンテナにマウントされたファイルシステムがあるからだ。NanoClawはファイルI/Oを実装しない——利用可能なパスを設定する。エージェントスウォームが動くのは、Claude Codeがエージェント委任をネイティブにサポートしているからだ。NanoClawはマルチエージェントオーケストレーションを実装しない——コンテナを起動してClaudeに調整を任せる。
500行は、NanoClawのユースケースに固有のことを処理する：Baileys経由でWhatsAppメッセージを受信し、SQLiteでグループ状態を検索し、適切なマウントで適切なコンテナを起動し、stdin経由でシークレットを渡し、IPC経由でレスポンスを収集し、WhatsAppに返す。これらがNanoClawをプロダクトとして定義する判断だ——ユーザーをAIエージェントに安全かつ便利に接続する方法についての選択。
それ以外はすべて、NanoClawよりもうまくやるコンポーネントに委任されている。これは怠慢ではない。書かなくて済むコードが最良のコードだという認識だ。書かないコードにはバグがなく、メンテナンスが不要で、セキュリティ脆弱性を生まない。
メンテナンスの配当
小さなコードベースの実用的なメリットは、最初は明らかでない方法で時間とともに複利的に増大する。
Anthropicがツール使用を改善したClaude Agent SDKの新バージョンをリリースすると、NanoClawは1つの依存関係を更新するだけで改善を得る。更新すべき抽象層も、書き直すべきアダプターも、チェックすべき互換性マトリクスもない。SDKは直接使用されるため、SDKの改善は即座に反映される。
コンテナランタイムにセキュリティ脆弱性が発見された場合、修正はDockerまたはApple Containerの更新であり、NanoClawのコードのパッチではない。セキュリティ境界は小さなオープンソースプロジェクトではなく、AppleとDockerのインフラチームによって維持される。
新しいコントリビューターがコードベースを理解したいとき、500行すべてを1時間以内に読める。プラグインシステム、プロバイダー抽象化、ツール実行フレームワークを理解する必要はない。アーキテクチャ全体が1つのメンタルモデルに収まる：メッセージがWhatsAppから来て、コンテナがClaudeで処理し、レスポンスがWhatsAppに戻る。
これがミニマルコードのメンテナンス配当だ。書かないすべての行は、デバッグしない行、ドキュメント化しない行、新しいコントリビューターに説明しない行、世界が変わったときにパッチしない行だ。
少ないことが本当に多いとき
500行の哲学は普遍的に適用できるわけではない。特定のビジネスロジックを持つカスタムAIアプリケーションを構築するなら、そのロジックを表現できるフレームワーク——LangChain、CrewAI、または類似のツール——が必要だ。Claude Agent SDKがカバーしないAIプロバイダーをサポートする必要があるなら、プロバイダー抽象層が必要だ。非技術ユーザー向けのプラグインエコシステムが必要なら、プラグインシステムが必要だ。
NanoClawの賭けはより狭い：チャットチャンネルに接続し、コンテナ内で安全に実行し、公式SDKを通じてClaudeの機能を活用するパーソナルAIアシスタントにとって、500行は十分なだけでなく最適だ。それを超えるすべての行は、ユーザーに貢献しない複雑さ、プロダクトを改善しないメンテナンス負担、存在する必要のない攻撃対象面になる。
ソフトウェア業界には「より多く」への深いバイアスがある。より多くの機能、より多くの抽象化、より多くの設定オプション、より多くのコード行。より多くのコードはより多くの機能を意味するという前提だ。NanoClawはその反例だ——機能が含まれるコードからではなく、接続するコンポーネントから来るプロジェクト。500行はプロダクトではない。ユーザーとAIの間の最小限のブリッジであり、何も邪魔にならないよう可能な限り薄く設計されている。