cc_dev_team

Claude Code で Web アプリを開発するための エージェントチーム 一式です。
20 の専門エージェント、5 つのワークフローコマンド、自動適用ルールを提供します。

概要

新しい Web アプリプロジェクトに dot_claude/ の内容をコピーすると、
設計 → タスク分解 → 実装 → コードレビュー → テスト → マージ
の開発パイプラインが自動的にセットアップされます。

セットアップ

# 1. dot_claude/ をプロジェクトの .claude/ にコピー
cp -r /path/to/cc_dev_team/dot_claude /path/to/my-project/.claude

# 2. テンプレートをコピーして、技術スタック等を編集
cp .claude/CLAUDE.project.template.md .claude/CLAUDE.project.md

# 3. セットアップ実行（CLAUDE.md生成、settings.local.json作成）
bash .claude/scripts/setup.sh

これにより、プロジェクトに以下が配置されます：

• .claude/agents/ — 20 エージェント
• .claude/commands/ — 4 コマンド (/design, /dev-start, /dev-task, /dev-rollback)
• .claude/rules/ — 自動適用ルール
• .claude/references/ — 詳細ガイド
• .claude/settings.json — パーミッション設定
• CLAUDE.md — PM ワークフロー定義（setup.sh が生成）
• .claude/settings.local.json — フルパス許可ルール（setup.sh が生成）

使い方

プロジェクトで Claude Code を起動し、以下のコマンドでワークフローを進めます：

コマンド	説明
/design	要件定義から設計ドキュメントを作成し、Beads タスクに分解
/dev-start	実行可能なタスクを取得し、開発パイプラインを開始
/dev-task <id>	単一タスクの開発パイプラインを実行
/dev-rollback <id>	タスクのロールバック処理
/fix-issue <問題>	バグ・改善要望を TDD フロー（失敗テスト作成→修正→仕様書追記）で解決

エージェント構成

層	エージェント
オーケストレーション	設計エージェント, Beads 管理者, Git 管理者
スペシャリスト	Next.js, React+Vite
実装	フロントエンド, バックエンド, DB 設計, Supabase, Web デザイナー, インフラ, セキュリティ
レビュー	FE/BE コードレビュアー
テスト	FE/BE テストエンジニア, FE/BE テストレビュアー, FE/BE テストジャッジ

技術スタック（選択式）

項目	選択肢
フレームワーク	Next.js (App Router) or React + Vite
DB/Auth	Supabase
デプロイ	Vercel / Netlify / Cloudflare Pages 等
スタイリング	CSS Modules（Tailwind CSS 禁止）
タスク管理	Beads
テスト	Jest + Playwright

開発パイプライン

実装 → コードレビュー → テスト実装 → テストレビュー → テスト実行 → テスト結果判定 → 完了
         ↑ NG(2回まで)                                        ↑ NG(2回まで)
         └─ 再実装                                             └─ 再実装
         ↑ NG(3回目〜)                                        ↑ NG(3回目〜)
         └─ ロールバック                                       └─ ロールバック

ディレクトリ構成

dot_claude/                        # 全プロジェクトに常にコピーする一式
├── CLAUDE.base.md                 # PM ワークフロー定義（全プロジェクト共通）
├── CLAUDE.project.template.md     # プロジェクト固有設定テンプレート
├── agents/                        # 20 サブエージェント
├── commands/                      # 5 スラッシュコマンド
├── rules/                         # 自動適用ルール（paths 条件付き）
├── references/                    # 詳細ガイド
├── scripts/setup.sh               # プロジェクトへの配置スクリプト
└── settings.json                  # パーミッション・フック設定

specific_set/                      # 必要なプロジェクトだけに手動でコピーする追加リソース
├── business_marketing/agents/     # ビジネス・マーケティング系エージェント
└── seo/skills/                    # SEO・マーケティング系 Claude Skill

オプションリソース（specific_set/）

specific_set/ 以下は 全プロジェクトには配布しない 追加リソース集です。 必要なプロジェクトにだけ、対象ディレクトリを .claude/agents/ や .claude/skills/ に手動でコピーして使います。 setup.sh はこれらをコピーしません。

ライセンス

MIT