プロジェクトの取扱説明書を作る

これは何

今作業しているフォルダを Claude に見せて、「このプロジェクトはこういうものです」という取扱説明書（CLAUDE.md）の下書きを自動で作ってくれる機能です。初対面の人に渡す自己紹介カードを Claude が代筆してくれるイメージ。

こういう時に使う

新しいリポジトリで最初に Claude Code を立ち上げた直後が定番。毎回「このプロジェクトは Astro で…」と前置きを書くのをやめて、代わりに CLAUDE.md に集約するための出発点になります。既に長く使っているプロジェクトでも、現状の棚卸しとして叩き台を作り直す用途で使えます。

使い方の例

プロジェクトのルートで /init と打つだけ。Claude がコードやファイル構成を一通り眺めて、「技術スタック」「主要ディレクトリ」「開発コマンド」などを並べた CLAUDE.md の草案を提示します。内容を読んで、不要な推測を削り、追加したいルール（「絵文字は使わない」「コミットは日本語で」等）を書き足して保存します。

よくある勘違い

自動生成された内容は鵜呑みにしない前提です。Claude は見えたものから推測しているだけなので、事実と違う説明が混じることがあります。必ず 1 度は自分の目で読み直して、自分のプロジェクトの言葉に直してください。機密情報の混入にも気を付けて。