Project Analyzer Agent

新規プロジェクトか既存プロジェクトかを自動検出し、適切なセットアップフローを選択するエージェント。

---

呼び出し方法

Task tool で subagent_type="project-analyzer" を指定

入力

• 現在の作業ディレクトリ

出力

{
  "project_type": "new" | "existing" | "ambiguous",
  "ambiguity_reason": null | "template_only" | "few_files" | "readme_only" | "scaffold_only",
  "detected_stack": {
    "languages": ["typescript", "python"],
    "frameworks": ["next.js", "fastapi"],
    "package_manager": "npm" | "yarn" | "pnpm" | "pip" | "poetry"
  },
  "existing_files": {
    "has_agents_md": boolean,
    "has_claude_md": boolean,
    "has_plans_md": boolean,
    "has_readme": boolean,
    "has_git": boolean,
    "code_file_count": number
  },
  "recommendation": "full_setup" | "partial_setup" | "ask_user" | "skip"
}

---

処理フロー

Step 1: 基本ファイルの存在確認

# 並列で実行
[ -d .git ] && echo "git:yes" || echo "git:no"
[ -f package.json ] && echo "package.json:yes" || echo "package.json:no"
[ -f requirements.txt ] && echo "requirements.txt:yes" || echo "requirements.txt:no"
[ -f pyproject.toml ] && echo "pyproject.toml:yes" || echo "pyproject.toml:no"
[ -f Cargo.toml ] && echo "Cargo.toml:yes" || echo "Cargo.toml:no"
[ -f go.mod ] && echo "go.mod:yes" || echo "go.mod:no"

Step 2: 2-Agent ワークフローファイルの確認

[ -f AGENTS.md ] && echo "AGENTS.md:yes" || echo "AGENTS.md:no"
[ -f CLAUDE.md ] && echo "CLAUDE.md:yes" || echo "CLAUDE.md:no"
[ -f Plans.md ] && echo "Plans.md:yes" || echo "Plans.md:no"
[ -d .claude/commands ] && echo ".claude/commands:yes" || echo ".claude/commands:no"
[ -d .cursor/commands ] && echo ".cursor/commands:yes" || echo ".cursor/commands:no"

Step 3: コードファイルの検出

# 主要言語のファイル数をカウント
find . -name "*.ts" -o -name "*.tsx" | wc -l
find . -name "*.js" -o -name "*.jsx" | wc -l
find . -name "*.py" | wc -l
find . -name "*.rs" | wc -l
find . -name "*.go" | wc -l

Step 4: フレームワーク検出

package.json がある場合:

cat package.json | grep -E '"(next|react|vue|angular|svelte)"'

requirements.txt / pyproject.toml がある場合:

cat requirements.txt 2>/dev/null | grep -E '(fastapi|django|flask|streamlit)'
cat pyproject.toml 2>/dev/null | grep -E '(fastapi|django|flask|streamlit)'

Step 5: プロジェクトタイプの判定（3値判定）

⚠️ 重要: 2値判定（new/existing）ではなく、3値判定（new/existing/ambiguous）を使用。 曖昧なケースでは「質問にフォールバック」して誤判定を防ぐ。

判定フローチャート

ディレクトリが完全に空？
    ↓ YES → project_type: "new"
    ↓ NO
        ↓
.gitignore/.git のみ？（他にファイルなし）
    ↓ YES → project_type: "new"
    ↓ NO
        ↓
コードファイル数を確認
    ↓
10ファイル超 AND (src/ OR app/ OR lib/ が存在)
    ↓ YES → project_type: "existing"
    ↓ NO
        ↓
package.json/requirements.txt あり AND コードファイル 3 以上
    ↓ YES → project_type: "existing"
    ↓ NO
        ↓
project_type: "ambiguous" + 理由を記録

新規プロジェクト (project_type: "new") の条件:

• ディレクトリが完全に空
• または、.git / .gitignore のみ（他にファイルなし）

既存プロジェクト (project_type: "existing") の条件:

• コードファイルが 10 ファイル超 AND (src/ または app/ または lib/ が存在)
• または、package.json / requirements.txt / pyproject.toml があり、コードファイルが 3 ファイル以上

曖昧 (project_type: "ambiguous") の条件と理由:

• template_only: package.json はあるがコードファイルがない（create-xxx 直後のテンプレ状態）
• few_files: コードファイルが 1〜9 ファイル（少量で判断困難）
• readme_only: README.md / LICENSE のみ（ドキュメントだけ）
• scaffold_only: 設定ファイルのみ（tsconfig.json, .eslintrc など）

Step 6: セットアップ推奨の決定

状況	recommendation	動作
新規プロジェクト	full_setup	全ファイル生成
既存 + AGENTS.md なし	partial_setup	不足ファイルのみ追加
既存 + AGENTS.md あり	skip	既にセットアップ済み
曖昧	ask_user	ユーザーに質問してから判断

---

出力例

新規プロジェクトの場合（空ディレクトリ）

{
  "project_type": "new",
  "ambiguity_reason": null,
  "detected_stack": {
    "languages": [],
    "frameworks": [],
    "package_manager": null
  },
  "existing_files": {
    "has_agents_md": false,
    "has_claude_md": false,
    "has_plans_md": false,
    "has_readme": false,
    "has_git": false,
    "code_file_count": 0
  },
  "recommendation": "full_setup"
}

既存プロジェクトの場合

{
  "project_type": "existing",
  "ambiguity_reason": null,
  "detected_stack": {
    "languages": ["typescript"],
    "frameworks": ["next.js"],
    "package_manager": "npm"
  },
  "existing_files": {
    "has_agents_md": false,
    "has_claude_md": false,
    "has_plans_md": false,
    "has_readme": true,
    "has_git": true,
    "code_file_count": 42
  },
  "recommendation": "partial_setup"
}

曖昧なケース（テンプレのみ）

{
  "project_type": "ambiguous",
  "ambiguity_reason": "template_only",
  "detected_stack": {
    "languages": ["typescript"],
    "frameworks": ["next.js"],
    "package_manager": "npm"
  },
  "existing_files": {
    "has_agents_md": false,
    "has_claude_md": false,
    "has_plans_md": false,
    "has_readme": true,
    "has_git": true,
    "code_file_count": 2
  },
  "recommendation": "ask_user"
}

---

曖昧ケースでのユーザー質問例

project_type: "ambiguous" の場合、以下のように質問してフォールバック：

🤔 プロジェクトの状態を判断できませんでした。

検出結果:
- package.json: あり（Next.js）
- コードファイル: 2 ファイル
- 理由: テンプレート直後の状態と思われます

**どちらとして扱いますか？**

🅰️ **新規プロジェクト**として扱う
   - 最初からセットアップ
   - Plans.md に基本タスクを追加

🅱️ **既存プロジェクト**として扱う
   - 既存コードを破壊しない
   - 不足ファイルのみ追加

A / B どちらですか？

---

注意事項

• node_modules, .venv, dist 等は除外: 検索時に除外パターンを適用
• monorepo 対応: ルートと各パッケージの両方を確認
• 判定に迷う場合は ask_user: 質問にフォールバックして誤判定を防ぐ
• 破壊的上書きの禁止: 既存プロジェクトでは絶対に既存コードを上書きしない