prime-codebase

Prime：プロジェクトのコンテキストを読み込む

目的

コードベースの構造、ドキュメント、主要ファイルを分析し、包括的に把握します。外部タスクの参照情報が指定されている場合は、コードベースの分析を実際の作業に沿ったものにするため、最初に読み込みます。

プロセス

ステップ 0：外部コンテキストを読み込む

コードベースの分析を始める前に、このステップを実行してください。 任意の引数 [jira-issue-keys] [confluence-page-ids] を受け付けます。

• Jira キーは単一のキー（ACC-2）またはカンマ区切り（ACC-2,ACC-3）で指定できます。
• Confluence のページ ID は数値です。

Jira の課題キーが指定されている場合：

1. mcp__atlassian__getAccessibleAtlassianResources を呼び出し、cloudId を取得します。
2. Jira キーごとに、該当する cloudId、課題キー、および responseContentFormat: "markdown" を指定して mcp__atlassian__getJiraIssue を呼び出します。
3. 返された課題の概要、説明、受け入れ条件を、それ以降のすべての作業のタスクコンテキストとして扱います。

Confluence のページ ID が指定されている場合：

1. ページ ID ごとに、contentFormat: "markdown" を指定して mcp__atlassian__getConfluencePage を呼び出します（上記の cloudId を使用します。まだ取得していない場合は、mcp__atlassian__getAccessibleAtlassianResources を呼び出して取得します）。
2. 返されたページの内容を、補足コンテキスト（仕様、設計ドキュメント、要件）として扱います。

引数が指定されていない場合： このステップを完全に省略し、ステップ 1 に進みます。

続行する前に、読み込んだ外部コンテキストを簡潔に要約してください。以降の分析の前提となります。

1. プロジェクト構造を分析する

追跡対象のファイルをすべて一覧表示します。 !git ls-files

ディレクトリ構造を表示します。 Linux では、次を実行します：tree -L 3 -I 'node_modules|__pycache__|.git|dist|build'

2. 主要なドキュメントを読む

• CLAUDE.md または同様の全体ルールファイルを読みます
• プロジェクトルートと主要ディレクトリにある README ファイルを読みます
• アーキテクチャに関するドキュメントを読みます

3. 主要ファイルを特定する

プロジェクト構造に基づいて、次のファイルを特定して読みます。

• 主なエントリーポイント（main.py、index.ts、app.py など）
• 主要な設定ファイル（pyproject.toml、package.json、tsconfig.json）
• 主要なモデル／スキーマ定義
• 重要なサービスまたはコントローラーファイル

4. 現在の状態を把握する

最近の作業状況を確認します。 !git log -10 --oneline

現在のブランチと状態を確認します。 !git status

出力レポート

次の項目を含む、簡潔な要約を作成してください。

外部タスクのコンテキスト（読み込んだ場合）

• Jira の課題：キー、タイトル、目標を一文で、受け入れ条件
• Confluence のページ：タイトルと、指定されている内容

プロジェクト概要

• アプリケーションの目的と種類
• 主な技術とフレームワーク
• 現在のバージョン／状態

アーキテクチャ

• 全体的な構造と構成
• 特定した主要なアーキテクチャパターン
• 重要なディレクトリとその用途

技術スタック

• 言語とバージョン
• フレームワークと主要ライブラリ
• ビルドツールとパッケージマネージャー
• テストフレームワーク

基本原則

• 確認したコードスタイルと規約
• ドキュメントの規定
• テストの方針

現在の状態

• 作業中のブランチ
• 最近の変更または開発の重点
• 直ちに確認できる点や懸念事項

箇条書きと明確な見出しを使い、要約を把握しやすくしてください。