プロジェクトコンテキスト生成 は何をしますか?
.claude/docs/project.md を作成または更新します。これはClaudeがすべての会話で読み込む、簡潔なプロジェクトリファレンスです。README(人間向けに書かれる)とは異なり、project.mdはClaude向けに書かれます。密度が高く、事実に基づき、マーケティング的な表現はありません。
このスキルが存在する理由
.claude/docs/project.md は CLAUDE.md を介してすべてのClaude会話に自動ロードされます。これがないか古くなっていると、Claudeは技術スタック、テストコマンド、アーキテクチャを再発見するために余分なターンを浪費します。このスキルはその発見を自動化し、正確で簡潔なリファレンスファイルを生成します。
ワークフロー
ステップ 1: コードベースを分析する
プロジェクトの事実を収集するために、構造化された三段階の分析を実行します。すべての事実には確信度レベルをタグ付けします: [confirmed](ソースから読み取った)、[inferred-high](強い証拠がある)、[inferred-low](部分的な証拠がある)、[unknown]。
詳細なツールアクション、glob/grepパターン、レコードテンプレートについては、references/analysis-methodology.md を参照してください。
フェーズ 1 — プロジェクトメタデータ: パッケージマネージャーファイル、環境テンプレート、CI設定、ツールチェーンファイルをglob検索します。以下を抽出: プロジェクト名、言語、Pythonバージョン、依存関係(用途付き)、スクリプト/コマンド、環境変数、CIステージ、テストマーカー。
フェーズ 2 — アーキテクチャスキャン: すべてのソースファイルをglob検索します。エントリポイントを特定し、インポートグラフを構築し、モジュールを分類し(コア/リーフ/オーケストレーター)、アーキテクチャパターンを特定します。ソースコードから参照されている設定ファイルを読み取ります。
フェーズ 3 — データソースとインフラストラクチャ: 外部データソース(データベース、API、ファイル)、出力ターゲット(ファイル、アップロード、API)、テスト構造、カスタム例外階層を特定します。
ステップ 2: 明確化のための質問をする
分析後、[inferred-low] と [unknown] の項目についてユーザーに質問します。焦点を絞ってください — すでにわかっていることについて質問しないでください。よくあるギャップ:
- プロジェクトの目的: これはどのような問題を解決するのか?(コードから明らかでない場合)
- データソース: どのシステムがデータを入力し、どこが出力を受け取るのか?
- デプロイ: これはどのように/どこで実行されるのか?(ローカル、スケジュール実行、クラウド)
コードベースが単純な場合、質問は1〜2個、またはまったく不要なこともあります。
ステップ 3: project.md を生成する
以下の構造を使用してファイルを書き込みます。.claude/docs/project.md がすでに存在する場合は、上書きする前にユーザーに確認します。
出力構造
生成される project.md は以下の構造に従う必要があります。プロジェクトに合わせて詳細度を調整してください — 小規模プロジェクトではセクションをスキップしてもよく、複雑なプロジェクトではサブセクションを追加しても構いません。
# {プロジェクト名} — プロジェクトコンテキスト
{一文の説明: それが何か、何をするか、主要技術。}
## 技術スタック
- **{言語/ランタイム}** — {バージョン制約(既知の場合)}
- **{フレームワーク}** — {用途}
- **{主要ライブラリ}** — {目的}
- ...箇条書き、ツール名を太字にし、目的を注釈する
## プロジェクトレイアウト
```text
{注釈付きディレクトリツリー — エントリごとに短いフレーズ1つ}
```
データフロー
{ソース → 変換 → 出力パイプラインを示すASCII図}
データソース
{ソース名}— {それが提供するもの}- ...データベース、API、ローカルファイルなど
テストマーカー
{テストコマンド}— {実行する内容}{マーカー名}— {ゲートする条件}
主要アーキテクチャパターン
- {パターン名} (
{ファイル}): {一文の説明} - ...呼び出す価値のある、明白でないパターンのみ
記述ガイドライン
- 冗長より密度優先。 すべての行が存在する価値を持つべきです。Claudeに動機や背景説明は不要です — 事実だけで十分です。
- 汎用より具体優先。 「外部依存関係を除外してテストを実行」よりも「
uv run pytest -m 'not snowflake'を実行」の方が優れています。 - パターンは一文で。 アーキテクチャパターンは各行1つ — 名前、ファイル、説明。
- 実際のコマンドを使用。 テストコマンドは
pyproject.tomlやCI設定からコピーし、言い換えたバージョンは使いません。 - 依存関係に注釈を付ける。
polarsとだけリストするのではなく、polars — 高性能DataFrameのようにします。 - データソースは重要。 Claudeはどのような外部システムが存在するかを知る必要があります。すべてのデータベース、API、ファイルソースをリストしてください。
- 100行未満に保つ。 project.mdが約100行のコンテンツを超える場合は詳細すぎます — 詳細は専用のドキュメントに移動し、それらにリンクしてください。
出力
ファイルを .claude/docs/project.md として保存します(必要に応じてディレクトリを作成します)。ファイルがすでに存在する場合は、上書きする前に差分サマリーをユーザーに表示します。
project.mdの生成後、CLAUDE.md がそれを参照しているか確認します。参照していない場合は、次のような行を追加することを提案します:
プロジェクト固有の詳細(技術スタック、アーキテクチャ、テストマーカー)については [.claude/docs/project.md](.claude/docs/project.md) を参照してください。