Claude Code とは何か
Anthropic公式のCLIツール。ターミナル上でAIがファイル読み書き・コマンド実行・Web検索を自律的に行い、ソフトウェア開発から業務自動化まで対応する。
自律的なファイル操作
プロジェクト内のファイルを読み書きし、コードの実装・修正・リファクタリングを自律的に実行。人間は方針指示と最終確認に集中できる。
コマンド実行とツール連携
テスト実行、ビルド確認、Git操作、外部APIコールをCLI上で直接実行。開発フロー全体をAIが一気通貫で管理する。
拡張可能な設定体系
エージェント・スキル・コマンド・フック・ルールの5層構造で、業務に合わせたカスタマイズが可能。設定はすべてMarkdownとJSONで管理。
この構成のポイント
ここで紹介する62エージェント・78スキルはすべて実稼働中の構成です。Claude Codeの標準機能に加え、独自のエージェント定義・スキルファイル・フックスクリプトを追加することで、1人の開発者が数十人分の業務を並列処理する環境を実現しています。
62の専門エージェント
~/.claude/agents/ ディレクトリに配置されたMarkdownファイルが、それぞれ専門分野を持つエージェントとして機能する。Agent Teamとして並列起動し、タスクを分担する。
コアエンジニアリング（17エージェント）
| エージェント | カテゴリ | 役割 |
|---|---|---|
| planner | 設計 | 実装計画の策定、依存関係の特定、リスク分析 |
| architect | 設計 | システムアーキテクチャ設計、技術選定、スケーラビリティ評価 |
| tdd-guide | テスト | テスト駆動開発の実践。RED→GREEN→REFACTORサイクルの強制 |
| code-reviewer | レビュー | コード品質レビュー。CRITICAL/HIGH/MEDIUMの3段階で指摘 |
| security-reviewer | セキュリティ | OWASP Top 10準拠の脆弱性検出。シークレット漏洩チェック |
| build-error-resolver | 修正 | ビルドエラー・型エラーの自動解決。最小差分で修正 |
| e2e-runner | テスト | Playwright E2Eテスト生成・実行・スクリーンショット管理 |
| refactor-cleaner | 整理 | デッドコード検出・削除。knip/depcheck/ts-pruneで分析 |
| doc-updater | ドキュメント | CODEMAPS・README・技術ドキュメントの自動更新 |
| component-designer | 設計 | コンポーネント設計論（全14章）に基づく分割・命名・Props設計 |
| react-specialist | 実装 | React 18+最適化、Server Components、Concurrent Features |
| typescript-pro | 実装 | 高度な型システム、Conditional Types、型安全API設計 |
| react-router-v7 | 実装 | React Router v7のSSR/file-based routing、データローディング |
| react-native-specialist | モバイル | RN New Architecture（JSI/Turbo Modules/Fabric）、Expo SDK 50+ |
| general-purpose | 汎用 | 特定の専門を持たない汎用実装エージェント |
| implementer | 実装 | 実装担当の基本エージェント |
| tester | テスト | テスト作成担当 |
事業検証・SNS・人事・その他（45エージェント）
事業検証 5エージェント
pain-discovery（ペイン発掘）、pain-scorer（WTPスコアリング）、competitive-gap（競合分析）、validation-synthesizer（レポート統合）、tiktok-slide-builder（TikTokスライド生成）
SNS/コンテンツ 8エージェント
personal-brand-analyst、x-account-designer、note-content-strategist、sns-content-reviewer、ai-slop-detector、x-content-writer、note-content-writer、monetization-strategist
人事・広報 4エージェント
hr-market-researcher（採用市場調査）、employer-branding（ブランド戦略）、recruitment-strategist（チャネル・選考戦略）、hr-content-planner（採用コンテンツ企画）
3エージェント
slide-planner（構成設計・発表者ノート）、visual-designer（HTML→PNG生成）、deck-assembler（Google Slidesデッキ組立）
デジタルプロダクト 5エージェント
market-researcher（市場調査）、product-builder（プロダクト制作）、listing-creator（出品コンテンツ）、marketing-writer（X+TikTok）、marketing-writer-seo（Reddit+SEO+Pinterest）
taiyaki専門 16エージェント
MOSHプロダクト向け。taiyaki-frontend、taiyaki-backend、taiyaki-planner、taiyaki-reviewer、taiyaki-tester、taiyaki-security-reviewer、taiyaki-e2e-engineer、他9種。OpenAPI駆動開発に特化。
エージェント定義の仕組み
~/.claude/agents/{name}.md にMarkdownファイルとして配置。各ファイルにエージェントの専門分野、使用可能なツール、行動指針を記述。Claude Codeが文脈に応じて適切なエージェントを自動選択する。合計約11,909行の定義ファイル。
78の自動化スキル
スキルは特定の業務ドメインに最適化された手順書。SKILL.mdファイルに入力形式、処理手順、出力テンプレートを定義し、再現性の高い業務実行を実現する。
開発基盤
TypeScript（strictモード規約）、React（18+パターン）、Hono（バックエンド）、Prisma（ORM）、React Native（モバイル）、TDD（テスト駆動）、Systematic Debugging（体系的デバッグ）
セキュリティ
Security Audit（CVE脆弱性評価）、Defense in Depth（多層防御）。OWASP Top 10、依存関係の脆弱性スキャン、シークレット管理を自動化。
コンテンツ制作
Note Writing（note記事SEO最適化）、Info Translation（一次情報翻訳3形式同時生成）、Newsletter Pipeline（Beehiivステップメール）、Ad Banner（広告バナー自動生成）
事業開発
Deep Research（市場調査・SNS検証）、Business Pain Validator（ペインSNS検証）、Bizgram（3x3ビジネスモデル図解）、MOSH Strategy（クリエイターエコノミー戦略）
EC・広告・会計
Next Engine（EC自動化）、Google Ads（広告管理）、freee（経費検出）、Google Sheets（スプレッドシート操作）、OpenStock（米国株分析）
動画・プレゼン
Remotion（プログラマブル動画）、Video Generation（動画自動生成）、Google Slides（テンプレート活用）、Slides Design System（トンマナ抽出・適用）
UI/デザイン
Figma Design QA（実装差分検出）、Visual Contract（視覚的契約によるデザイン品質）、Component Design（設計論14章準拠）、Frontend Design（AIスロップ回避）
ツール連携
Dify Workflow（DSLワークフロー作成）、n8n Workflow（自動化ワークフロー生成）、Agent Browser（Chrome DevMCP検証）、PDF Splitter（大容量PDF分割読込）
92のスラッシュコマンド
ターミナルで /コマンド名 と入力するだけで複雑なワークフローを起動。92個のコマンドがスキルとエージェントを組み合わせて業務を実行する。
開発・実装
/implement機能実装（Agent Team自動構成）/reviewコードレビュー実行/fixレビュー指摘を修正/cycle実装→レビュー→修正の自動サイクル/testテスト作成・実行/team-feat汎用機能実装チーム/team-fix汎用バグ修正チーム/team-refactorリファクタリングチーム/team-quality品質改善チーム/team-fullstackFE+BE並行実装チーム/team-securityセキュリティ監査チームSNS・コンテンツ
/sns-account-designX×noteアカウント設計/sns-content-createX投稿・note記事の追加制作/note-writenote記事の全文作成/info-translate一次情報翻訳→X/note/ニュースレター/content-pipeline-daily日次コンテンツバッチ処理/newsletter-weekly週次ニュースレター生成事業開発・調査
/deep-research市場調査（SNS必須・100万円判定）/business-validateペインSNS検証（Agent Team）/bizgram-analyze企業Web調査→ビジネスモデル図解/aishain-research企業リサーチ（並列調査）/digital-product-createデジタルプロダクト制作パイプライン/mosh-strategyMOSH事業領域の戦略リサーチEC・広告・会計
/next-engine-syncネクストエンジン商品マスタ同期/google-ads-create-campaignGoogle Adsキャンペーン作成/freee-checkfreee経費チェック実行/mosh-payment-linkMOSHペイメントリンク作成/openstock-analyze米国株銘柄分析スライド・資料
/proposal-slides提案資料スライド生成/google-slides-createテンプレートからデッキ生成/slides-extract-designデザインシステム抽出/figma-implementFigma→実装パイプライン人事・採用
/eng-recruitエンジニア採用強化施策/tech-blog-generateSlackから技術ブログ自動生成Agent Team：並列自律実行の仕組み
最大の特徴は複数のエージェントをチームとして編成し、タスクを分担して並列実行できる点。リーダーがオーケストレーションし、ワーカーが自律的にタスクを完了する。
Agent Team アーキテクチャ
Agent Team の実行フロー
TeamCreate でチーム名を指定して新規チーム作成。タスクリストとチーム設定ファイルが自動生成される。
TaskCreate でタスクを3〜10個に分解して登録。TaskUpdate で依存関係（blocks / blockedBy）を設定。
独立したタスクは必ず並列で起動。1つのメッセージで複数の Agent ツールを同時呼び出しする。
各エージェントが自律的にタスクを実行。完了時は SendMessage でリーダーに報告、次タスクを TaskList から取得。
全タスク完了を確認後、shutdown_request を全メンバーに送信し、TeamDelete でリソースを解放。
タスク種別ごとのチーム構成テンプレート
| タスク種別 | チーム名 | メンバー構成 |
|---|---|---|
| 機能実装 | feat-{機能名} | planner → component-designer + implementer（並列）→ tester → reviewer |
| バグ修正 | fix-{バグ名} | investigator → tester（回帰テスト） |
| リファクタリング | refactor-{対象} | planner → refactor-cleaner → reviewer |
| コードレビュー | review-{対象} | code-reviewer + security-reviewer（並列） |
| 調査＋実装 | research-{テーマ} | researcher（Explore）→ implementer |
| 事業検証 | validate-{テーマ} | pain-discovery + competitive-gap（並列）→ pain-scorer → validation-synthesizer |
| SNSコンテンツ | sns-{テーマ} | personal-brand-analyst → x-content-writer + note-content-writer（並列）→ sns-content-reviewer |
モデルコスト最適化
ワーカーエージェントには Haiku（Sonnetの90%性能・コスト1/3）を使用し、リーダーには Sonnet/Opus を使用。調査系エージェントは並列で5〜10体起動しても、Haikuなのでコストを抑制できる。
フック&ルール：品質の自動強制
13のフックスクリプトと8つのルールファイルが、コード品質・セキュリティ・ワークフローのガードレールとして常時稼働する。
フック（自動実行スクリプト）
| タイミング | フック名 | 動作 |
|---|---|---|
| PreToolUse | tmux reminder | 長時間コマンド（npm, cargo等）でtmux使用を提案 |
| PreToolUse | git push review | git push前にエディタでレビュー画面を表示 |
| PreToolUse | doc blocker | 不要な .md / .txt ファイルの作成をブロック |
| PostToolUse | Prettier | JS/TSファイル編集後に自動フォーマット |
| PostToolUse | TypeScript check | .ts/.tsx編集後にtsc型チェック実行 |
| PostToolUse | console.log warning | 編集ファイル内のconsole.logを警告 |
| PostToolUse | PR creation log | PR作成時にURLとGitHub Actions状態を記録 |
| PostToolUse | record-skill-usage | Skill使用をusage-stats/*.jsonlに記録 |
| PostToolUse | record-mcp-usage | MCPツール使用を同様に記録 |
| Stop | console.log audit | セッション終了時、変更ファイル全体のconsole.logを監査 |
| UserPromptSubmit | Worktree enforcer | 開発タスク開始時にWorktree作成を強制 |
ルール（常時適用ポリシー）
agents.md
非trivialタスクは必ずAgent Teamを通して実行。直接実装は1行修正と質問応答のみ許可。
coding-style.md
イミュータビリティ必須。ファイルは200-400行目安、800行上限。50行超の関数禁止。ネスト4段以下。
git-workflow.md
Conventional Commits。PRは全コミット履歴を分析してサマリー作成。Worktreeでブランチ分岐必須。
testing.md
カバレッジ80%以上必須。TDD（RED→GREEN→IMPROVE）ワークフロー強制。
security.md
ハードコードされたシークレット禁止。全ユーザー入力をバリデーション。OWASP Top 10チェック。
performance.md
Haiku/Sonnet/Opusの使い分けルール。コンテキストウィンドウ管理。ultrathink活用指針。
patterns.md
API Response / Custom Hooks / Repositoryパターンの標準テンプレート。skeleton projectの活用推奨。
hooks.md
PreToolUse/PostToolUse/Stopフックの設定方法と、auto-acceptパーミッションの使用指針。
Worktree自動強制
UserPromptSubmitフックにより、実装タスク開始時にGit Worktreeの作成が自動強制される。main直接編集は物理的に防止されており、必ずブランチを切ってからの作業になる。これにより本番コードの安全性を保証。
MCP外部ツール連携
Model Context Protocol（MCP）により、Claude CodeからFigma・Slack・Notion・ブラウザ操作・モバイルデバイス等の外部サービスに直接接続する。
| MCPサーバー | 連携先 | 主な用途 |
|---|---|---|
| Figma | Figma | デザインデータ取得、Code Connect、FigJamダイアグラム生成 |
| Slack | Slack | チャンネル読み込み、メッセージ送信、ユーザー検索、Canvas作成 |
| Notion | Notion | ページ作成・更新、データベースクエリ、コメント管理 |
| Google Calendar | Google Calendar | イベント管理、空き時間検索、会議スケジュール |
| Playwright | Webブラウザ | ページ操作、スクリーンショット取得、E2Eテスト |
| mobile-mcp | iOS/Androidデバイス | アプリ操作、スクリーンショット、画面録画、UIテスト |
| context7 | ドキュメント検索 | ライブラリドキュメントのコンテキスト提供 |
| GitHub | GitHub API | Issue/PR管理、ワークフロー操作 |
| Brave Search | Web検索 | リアルタイムWeb検索、最新情報取得 |
MCPの活用パターン
- Figma → 実装: Figma MCPでデザインデータ取得 → component-designerがコンポーネント設計 → implementerが実装 → Figma Design QAで差分検証
- Slack → 技術ブログ: Slack MCPでエンジニア会話を収集 → note-content-writerが記事化 → ai-slop-detectorでAI臭を除去
- モバイルテスト: mobile-mcpでiOS/Android実機操作 → スクリーンショット比較 → バグレポート自動生成
実運用ユースケース
この構成で実際に回している業務パイプラインの例。1つのコマンドで複数エージェントが自律的にタスクを完了する。
ユースケース 1: 機能実装（/team-feat）
新機能の実装を5エージェントが分担して並列実行。人間は方針指示と最終レビューのみ。
実装計画
コンポーネント設計
実装 ∥ テスト（並列）
レビュー
ユースケース 2: コンテンツ制作（/info-translate）
一次情報（論文・決算・政策文書）を翻訳し、X投稿・note記事・ニュースレターを同時生成。日次バッチで自動実行可能。
構造化分析
3形式同時生成（並列）
品質スコアリング
ユースケース 3: 事業検証（/business-validate）
新規事業のペイン検証をSNS横断で実施。GO/PIVOT/NO-GO判定を自動生成。
5プラットフォーム収集
WTP 5指標評価
競合弱点分析
GO/PIVOT/NO-GO
ユースケース 4: 提案資料作成（/proposal-slides）
マークダウンの提案内容をGoogle Slidesプレゼンテーションに自動変換。ビジュアルアセットもHTML→PNGで自動生成。
構成 ∥ アセット（並列）
Google Slides組立
ユースケース 5: Figma→実装（/figma-implement）
FigmaデザインURLから11ステップのパイプラインでフロントエンド・バックエンドの設計ドキュメントを自動生成。
デザイン取得
FE設計 ∥ API調査（並列）
API+DB設計