HeadcountでClaude Codeのエージェント組織を構築する

ヘッドカウントとは？

ヘッドカウントは、Claude Code向けに構築されたエージェント組織です。AIの能力を企業のように構成し、最高経営責任者の下に16の専門部門を配置しています。合計で143のスキルがあります。

すべてのプロジェクトに大量の指示を読み込むのではなく、プロジェクトに必要な部門だけをインストールします。各部門は、Technology、Security、Product、Marketing、Finance、Operations、Revenue、Customer Experienceなど、ビジネスまたは技術機能を担う独立したClaude Codeプラグインです。

このプロジェクトには、スキルの検索、部門の表示、各部門のソース定義への移動ができるインタラクティブな組織図も用意されています。

主な機能

• モジュール式の部門: 143のスキルすべてを読み込まず、プロジェクトに関連する機能だけをインストールできます。
• スキルの自動選択: リクエストが担当領域に一致すると、スキルが読み込まれます。
• 直接呼び出し: 特定の分析視点が必要な場合、特定の専門家を呼び出せます。
• 名前空間付きスキル: すべてのスキルがdepartment:skill形式を使用するため、名前の衝突を防げます。
• エージェント憲章: 部門には.claude/agents/内の憲章が含まれており、専用の書き込み領域を持つサブエージェントに作業を委任できます。
• 部門横断ワークフロー: セキュリティインシデント、停滞したファネル、SOC 2リクエストなどに複数の部門で対応する方法を、文書化されたユースケースで確認できます。
• レビュアー級の権限: Securityのようなレビュアー級の部門は、単に別の意見を加えるのではなく、許容できないリスクを生む作業を停止できます。

ヘッドカウントのインストール

前提条件

ヘッドカウントはClaude Code向けに設計されているため、まず動作するClaude Code環境を用意します。インストールにはClaude Codeのプラグインコマンドを使用します。

ステップ1: マーケットプレイスを追加する

ヘッドカウントのリポジトリをプラグインマーケットプレイスとして追加します。

/plugin marketplace add cbrock84/headcount

ステップ2: 部門をインストールする

プロジェクトに必要な部門をインストールします。たとえば、次のコマンドでSecurity部門を追加します。

/plugin install security@headcount

同じ方法で追加の部門もインストールできます。このモジュール式のアプローチにより、組織全体をすべてのプロジェクトに読み込むのではなく、アクティブなツールセットを必要なものに絞れます。

ステップ3: 必要なスキルを特定する

スキルは部門の名前空間を使って指定します。

department:skill

例:

• security:threat-modeling
• finance:unit-economics
• technology:systematic-debugging
• demand-generation:landing-page-cro-expert

タスクに必要な部門と正確なスキル名は、インタラクティブな組織図で確認できます。

基本的な使い方

ヘッドカウントに専門家を選ばせる

通常の使い方では、問題を自然な言葉で説明します。リクエストがインストール済み部門の担当領域に該当すると、一致する専門家が自動的に読み込まれます。

たとえば、次のように質問します。

なぜこのランディングページはコンバージョンしないのでしょうか？

このリクエストは、ランディングページのコンバージョン診断と改善に特化したdemand-generation:landing-page-cro-expertに一致します。

このプロジェクトには、ほかにも次の例があります。

• リクエスト: これを構築する前にデザインをレビューしてください。
  スキル: security:threat-modeling
• リクエスト: この採用にかかる費用を負担できますか？
  スキル: finance:unit-economics
• リクエスト: 成長が止まっています。
  スキル: executive:business-growth-consultant

スキルを直接呼び出す

ヘッドカウントに関連する専門家を選ばせたい場合は、自動ルーティングが便利です。必要な視点がすでに分かっている場合は、スキル名で直接呼び出します。

/finance:financial-modeling

直接呼び出すことで、意図する機能を明確に指定できます。たとえば、予測やシナリオ分析にはfinancial modelingを使用します。一方、finance:unit-economicsは貢献利益、顧客獲得コスト、回収期間、顧客生涯価値、コホートの動向に焦点を当てます。

プロジェクトに合わせた部門の選び方

利用可能な部門をすべてインストールするのではなく、プロジェクトの実際の責任範囲から始めます。ソフトウェア開発プロジェクトでは、Technologyをアーキテクチャ、テスト、デバッグ、コードレビュー、デプロイに使用できます。Securityはそこに脅威モデリングとアーキテクチャレビューを加えられます。

市場投入プロジェクトでは、Marketing、Demand Generation、Revenue、Financeを組み合わせられます。関連するスキルには、ポジショニングとメッセージング、ランディングページのコンバージョン最適化、価格設定とパッケージング、マーケティング分析、ユニットエコノミクスがあります。

ヘッドカウントの中心的な設計原則は、1つの巨大なプロンプトですべての問題を解決するのではなく、必要な部門を追加することです。

高度なヒント

自動ルーティングと直接呼び出しを組み合わせる

適切な専門家をシステムに判断させたい場合は、自然言語のリクエストから始めます。特定の分野、繰り返し利用するワークフロー、または明確に定義されたレビューステップが必要な場合は、直接呼び出しに切り替えます。

たとえば、technology:solution-explorationで実装を検討し、technology:implementation-planningで計画を作成し、technology:completion-verificationで結果を検証できます。

独立したレビュアーを利用する

すべての部門を任意の意見を述べるだけの存在として扱わないでください。Securityはレビュアー型として定義されており、安全でない作業を停止できます。機密性の高い設計では、デプロイまで待つのではなく、実装前に脅威モデリングまたはセキュリティアーキテクチャレビューを実施してください。

レビューの順序は次のように表現できます。

1. 提案されたソリューションとそのトレードオフを検討する。
2. 実装計画を作成する。
3. security:threat-modelingまたはsecurity:security-architecture-reviewを実行する。
4. 続行する前に、作業を阻むリスクに対処する。
5. 完成した作業を実装し、検証する。

エージェント憲章を通じて委任する

各部門は.claude/agents/にエージェント憲章を備えています。これらの憲章により、各部門は専用の書き込み範囲を持つサブエージェントとして動作できます。

専用の書き込み範囲は、エージェント間の重複を減らせるため、並行作業で特に役立ちます。Technology部門には、エージェント階層の設計と並行エージェントによるデリバリーのスキルも含まれており、オーケストレーターとサブエージェントの構成、および互いに重ならない作業範囲を扱います。

名前空間を一貫して使用する

ドキュメント、繰り返し実行する手順、直接呼び出しでは、常に完全なdepartment:skill名を保持してください。名前空間を使うことで担当部門が明確になり、同名の機能同士が衝突するのを防げます。

部門横断のシナリオを学ぶ

リポジトリのユースケースドキュメントでは、部門の境界をまたぐ7つの状況を説明しています。そこには、SOC 2を求めるエンタープライズ見込み客、セキュリティインシデント、停滞したファネルなどが含まれます。例では、レビュアー型の権限によって作業を停止できる場面も示しています。

インストール対象を絞る

プロジェクトのニーズが生じた時点で部門をインストールしてください。対象を絞ったインストールにより、不要な機能を減らしながら、現在の作業に関連する専門家へのアクセスを維持できます。財務分析、業務計画、マーケティング効果測定など、プロジェクトに本当に新しい責任が加わったら、別の部門を追加してください。

ワークフローの例

チームが新しいプロダクト体験を準備しているとします。構造化されたHeadcountのワークフローは、次のようになります。

1. Productのスキルを使って、インターフェースとデザインシステムを監査または改善する。
2. Technologyにソリューションアーキテクチャの検討と実装計画の作成を依頼する。
3. 構築前にSecurityに設計の脅威モデリングを実施してもらう。
4. デリバリー中にTechnologyのテスト駆動開発、コードレビュー、完了検証のスキルを使う。
5. ランディングページのコンバージョンについてはDemand Generationを、ポジショニングやキャンペーン計画についてはMarketingを参加させる。
6. 必要に応じてFinanceを使い、ユニットエコノミクスを検証するか、財務シナリオを作成する。

正確な順序は、インストールされている部門とプロジェクトのニーズによって異なります。重要なのは、すべてを区別のない1つのプロンプトで共有するのではなく、各専門家に明確な担当範囲があることです。

結論

Headcountは、Claude Codeを16の部門と143の名前空間付きスキルを備えたモジュール式のエージェント組織に変えます。マーケットプレイスを追加し、プロジェクトに必要な部門だけをインストールし、タスクを自然な言葉で説明して自動ルーティングを利用し、正確な観点が必要なときは特定のスキルを呼び出してください。複雑な作業では、部門の憲章、独立したレビュー、文書化された部門横断ワークフローを組み合わせてください。