概要
Claude Codeの「Context Window（会話バケツ）は有限である」という根本制約から逆算し、Plan Modeの活用やディレクトリ構成による効率的な設計手法を体系化したガイド。
詳細内容
Claude Codeを1ヶ月運用して得られた「設計の地図」を解説する記事です。最大のポイントは、すべての機能（Plan Mode、Skills、Agents、Hooks）が「会話バケツ（Context Window）の節約」という単一の制約から導かれているという洞察です。まず、実装前にPlan Modeで計画を文章化する「スペック駆動」の4ステップ（Explore/Plan/Implement/Commit）により、修正ループによるバケツの浪費を防ぐ重要性を説いています。また、プロジェクトの仕様をCLAUDE.md（永続・高頻度）、SKILL.md（オンデマンド）、Plan Mode出力（一過性）の3階層で管理し、情報の露出を段階的に制御する「Progressive Disclosure」の重要性を提示。さらに、.claude/配下の各ディレクトリ（skills, agents, hooks等）の役割を整理し、決定論的なガードとしてのhooksや、コンテキストを分離して作業するagentsの使い分けについて、著者の実践的な知見に基づいた具体的な運用フローを提案しています。