掲載済み (2026-03-07号)
#141 135文字 • 1分

CLAUDE.mdに本当は何を書くべきなのか

日本語

掲載情報

概要

Claude CodeのCLAUDE.mdはSystem PromptではなくUser Messageとして注入されるため、永続的なルールは.claude/rules/に、プロジェクト概要はCLAUDE.mdに書くべきという最適な構成を解説しています。

詳細内容

Claude CodeにおけるCLAUDE.mdの技術的な仕様と、それに基づいた効率的なプロジェクト管理手法を提案する記事です。著者は、CLAUDE.mdが「最初のユーザーメッセージ」として扱われ、会話が進むにつれて影響力が低下する(コンテキスト内で古くなる)という性質を指摘しています。このため、CLAUDE.mdは「Session Start Hook」としてプロジェクト概要やモジュール構成、開始手順のみを記述する場所とし、コーディング規約やテスト方針などの永続的なルールは、必要な時に注入される`.claude/rules/`(Conditional Rules)に記述すべきであると述べています。Before/Afterの具体例を通じて、AIへの指示の精度を最大化するための使い分けを明確化しています。