概要
https://zenn.dev/shusuke_o/articles/f63e1bf61363b8
詳細内容
## 2025年、Claude Code と 1 人で 40 万行規模のフルスタック＋インフラを構築した話（あみださん）
https://zenn.dev/shusuke_o/articles/f63e1bf61363b8
**提示する**、AIエージェント「Claude Code」を軸に一人で40万行規模のフルスタック開発を完遂するための、AIに最適化されたアーキテクチャとワークフローの実践知を。
**Content Type**: ⚙️ Tools
**Language**: ja
**Scores**: Signal:5/5 | Depth:4/5 | Unique:4/5 | Practical:5/5 | Anti-Hype:4/5
**Main Journal**: 89/100 | **Annex Potential**: 87/100 | **Overall**: 88/100
**Topics**: [[Claude Code, AI駆動開発, ソフトウェアアーキテクチャ, プロンプトエンジニアリング, 個人開発]]
著者は、1万人以上の利用者がいるオンラインあみだくじサービス「あみださん」の構築において、約40万行に及ぶコードとインフラを一人で完結させた。この成果を支えたのは、GitHub CopilotからClaude Codeへと至るAIツールの進化と、それに対応して進化させた「AIとの協働を前提とした設計手法」である。著者は、AIに丸投げするのではなく、AIが効率的にコンテキストを理解できる「土台」を人間が用意することの重要性を強調している。
具体的に提示されている手法は、AIの推論を制御するための「構造化」に集約される。アーキテクチャ面では、フロントエンドにレイヤードアーキテクチャ、バックエンドにクリーンアーキテクチャを採用し、AIが必要なコンテキストを最小限の探索で収集できるよう整理している。ドキュメント管理においては、`docs/todo`（計画）と`docs/done`（完了）ディレクトリを使い分けることで、セッションごとのコンテキスト肥大化を防ぎ、実装意図を明確に残す運用を提案している。
また、プロンプトエンジニアリングにおける独自の知見として、「重い言葉」の使用を挙げている。例えば「シンプルに」という抽象的な指示ではなく、「YAGNI」や「KISSの法則」といったソフトウェアエンジニアリング特有の専門用語（ドメイン知識を持った尖った単語）を用いることで、少ない語数で的確にLLMの推論を誘導できると主張する。加えて、`Claude.md`の設定やMCPの選定（Serena, Context7, Playwright）を最小限に絞ることで、コンテキストの汚染を防ぎ、ツールの精度を維持する工夫も凝らされている。
著者は、AI駆動開発のフェーズを「設計・実装・レビュー」に分け、特に設計フェーズでの対話が実装の質を左右すると説く。実装自体はAIに任せつつも、人間はエディタを監視し、意図と異なる挙動を即座に中断させる「監督者」としての役割を担う。2025年時点において、大規模プロジェクトを個人で完遂するためには、AIの進化に合わせつつ、人間側の設計力と判断力を「AIが理解しやすい形式」で出力し続けることが不可欠であるというのが著者の結論である。