Program Composition

목적

web/
- CEO Dashboard, 조직 관리, Capacity 패널, Stage Flow/Approval Inbox UI를 제공한다.
- Codex/Claude/Gemini 실행 권한 인자, CLI 타임아웃, Directive 자동승인 여부를 UI에서 직접 설정한다.
- CEO 입력은 directive 단일 진입을 원칙으로 한다.
mcp-server/
- Runtime API/WS, Orchestrator, Capacity Controller, Agent Command 실행을 담당한다.
- 사용자 설정(execution)을 영속 저장하고, provider별 CLI 실행 인자를 런타임에 반영한다.
- runtime:snapshot, runtime:directive, runtime:scaling, runtime:agent_stream 이벤트를 발행한다.
docs/
- 운영 헌장, 역할 운영 기준, 조직 전결 규칙의 SoT다.
knowledge-base/technical/
- 아키텍처/API/보안/운영 정책의 SoT다.
<workdir>/.agentCompany/
- 런타임 상태/이벤트/지시/작업 산출물 영속 저장 경계다.

CEO가 Dashboard에서 directive를 등록한다.
Orchestrator가 chief 그룹으로 라우팅해 work-order를 생성한다.
Stage Router가 PLAN -> WORK -> REVIEW -> COMPOUND를 진행한다.
Capacity Controller가 evaluate -> drain -> apply 상태머신으로 lead/member 수를 조정한다.
directiveAutoApprove=false이면 Approval Inbox에서 승인 이벤트(approval.validated, 필요 시 approval.user-confirmed)를 생성해 다음 단계로 진행한다.
결과/증빙/이벤트는 실시간 WS + 파일 상태로 동기화된다.

Stage Flow
- 현재 work의 단계 진행 상태를 시각적으로 표시한다.
- 단계별 CEO 체크리스트와 실행 템플릿을 제공한다.
Approval Inbox
- PLAN/REVIEW/BLOCKED 상태를 우선 노출해 CEO 의사결정 대기 항목을 모은다.
- Inbox 항목에서 승인 이벤트를 직접 생성해 blocked 전환을 해소한다.
Team Capacity Panel
- 그룹별 backlog/진행량/리스크/멤버 목표치를 보여주고 reconcile을 제공한다.
- 실행 정책(타임아웃/auto-approve/provider별 extra args)과 사용자 승인 actor 설정을 함께 제공한다.
Agent Activity Radar
- 각 agent 실행 상태 및 최신 work 이벤트를 추적한다.

프로그램 구성 변경(컴포넌트 추가/삭제, 단계 흐름 변경, 실시간 이벤트 변경, UI 운영 패널 변경)이 발생하면 아래 문서를 같은 작업에서 함께 갱신해야 한다.

knowledge-base/technical/program-composition.md (본 문서)
knowledge-base/technical/architecture.md
인터페이스가 바뀐 경우:
- API/WS 변경: knowledge-base/technical/api-contract.md
- 프론트 구조 변경: knowledge-base/technical/frontend-architecture.md, knowledge-base/technical/frontend-ux.md
- 런타임 오케스트레이션 변경: knowledge-base/technical/mcp-server-rust-architecture.md, knowledge-base/operations/ceo-command-orchestration.md