Headcount로 Claude Code 에이전트 조직 구축하기

헤드카운트란 무엇인가요?

헤드카운트는 Claude Code를 위해 구축된 에이전트 조직입니다. 기업과 같은 방식으로 AI 기능을 구조화하며, 최고경영자 아래에 총 143개의 스킬을 보유한 16개의 전문 부서를 배치합니다.

모든 프로젝트에 하나의 대규모 지침 모음을 불러오는 대신, 프로젝트에 필요한 부서만 설치할 수 있습니다. 각 부서는 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

대화형 조직도를 사용해 작업에 필요한 부서와 정확한 스킬 이름을 찾으세요.

기본 사용법

헤드카운트가 전문 스킬을 선택하도록 하기

일반적인 사용법에서는 문제를 자연스럽게 설명하면 됩니다. 요청이 설치된 부서의 담당 영역에 해당하면 일치하는 전문 스킬이 자동으로 로드됩니다.

예를 들어 다음과 같이 요청할 수 있습니다.

Why isn't this landing page converting?

이 요청은 랜딩 페이지 전환을 진단하고 개선하는 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를 조합할 수 있습니다. 관련 스킬로는 포지셔닝과 메시징, 랜딩 페이지 전환 최적화, 가격 및 패키징, 마케팅 분석, 단위 경제성이 있습니다.

헤드카운트의 핵심 설계 원칙은 하나의 지나치게 큰 프롬프트로 모든 문제를 해결하는 것이 아니라, 필요한 부서를 추가하는 것입니다.

고급 팁

자동 라우팅과 직접 호출 조합

적절한 전문 스킬을 시스템이 판단하도록 하려면 자연어 요청으로 시작하세요. 이미 알고 있는 분야, 반복 가능한 워크플로 또는 명확하게 정의된 검토 단계가 필요할 때는 직접 호출로 전환하세요.

예를 들어 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 이름을 유지하세요. 네임스페이스를 사용하면 담당 부서가 명확해지고 이름이 비슷한 기능이 충돌하는 것을 방지할 수 있습니다.

부서 간 시나리오 살펴보기

저장소의 사용 사례 문서에서는 부서 경계를 넘나드는 일곱 가지 상황을 설명합니다. 여기에는 SOC 2를 요청하는 엔터프라이즈 잠재 고객, 보안 사고, 정체된 퍼널이 포함됩니다. 또한 검토자 클래스의 권한으로 작업을 중단할 수 있는 지점도 예시를 통해 보여 줍니다.

설치 범위를 집중적으로 유지

프로젝트에 필요한 부서가 생길 때 설치하세요. 범위를 좁혀 설치하면 불필요한 기능을 줄이면서 현재 작업에 적합한 전문가에 대한 접근성은 유지할 수 있습니다. 재무 분석, 운영 계획, 마케팅 측정처럼 프로젝트에 실질적으로 새로운 책임이 추가될 때 다른 부서를 설치하세요.

예시 워크플로

한 팀이 새로운 제품 경험을 준비하고 있다고 가정해 보겠습니다. 구조화된 Headcount 워크플로는 다음과 같을 수 있습니다.

1. Product 스킬을 사용해 인터페이스와 디자인 시스템을 감사하거나 개선합니다.
2. Technology에 솔루션 아키텍처를 탐색하고 구현 계획을 수립하도록 요청합니다.
3. 구축하기 전에 Security가 설계에 대한 위협 모델링을 수행하도록 합니다.
4. 제공 과정에서 Technology의 테스트 주도 개발, 코드 검토, 완료 검증 스킬을 사용합니다.
5. 랜딩 페이지 전환을 위해 Demand Generation을, 포지셔닝이나 캠페인 계획을 위해 Marketing을 참여시킵니다.
6. 필요한 경우 Finance를 활용해 단위 경제성을 검증하거나 재무 시나리오를 구축합니다.

정확한 순서는 설치된 부서와 프로젝트의 요구 사항에 따라 달라집니다. 중요한 차이는 모든 전문가가 하나의 구분 없는 프롬프트를 공유하는 대신 각자 명확한 담당 범위를 가진다는 점입니다.

결론

Headcount는 Claude Code를 16개 부서와 143개의 네임스페이스 스킬로 구성된 모듈형 에이전트 조직으로 전환합니다. 마켓플레이스를 추가하고, 프로젝트에 필요한 부서만 설치하며, 자연어로 작업을 설명해 자동 라우팅을 사용하고, 정확한 관점이 필요할 때는 특정 스킬을 호출하세요. 복잡한 작업에서는 부서 헌장, 독립적인 검토, 문서화된 부서 간 워크플로를 조합하세요.