構造と制約で引き出す Claude Code の実践知

概要

コーディングエージェント（特に Claude Code）を効果的に使うための社内勉強会資料。「構造と制約」を意識してプロンプトやタスクを設計することで、エージェントの出力品質を高める実践的なノウハウをまとめている。

「構造と制約」とは

• 構造: タスクや要件を明確な形式で与える（CLAUDE.md・設計ドキュメント・テスト仕様）

• 制約: 「やってはいけないこと」「守るべきこと」を明示する（lint ルール・型制約・テスト要件）

• エージェントは曖昧なタスクより、構造化された入力と明確な完了条件があるほど良い出力を返す

気になるポイント

• 「構造と制約」の具体的な設計パターン

• エージェントから良い出力を引き出すためのテクニック

• 初心者がつまずきやすいポイント

要点

• Claude Code を使いこなすにはプロンプトだけでなくコードベース側の構造も重要

• 「構造と制約」を与えると、エージェントは判断材料と行動範囲を得て自走しやすくなる

• Cognitive Debt・Intent Debt（→関連ファイル参照）を意識した設計が長期的に効く