서브에이전트와 하네스

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude

사용자 (개발 목표 전달)
  예: Firebase 기반 To-Do 웹앱 개발
        │
        ▼
Claude Code — Main Agent
  작업 분해 · 위임 · 진행 관리 · 결과 통합
        │
        ├── 01 Planner        PRD · 요구사항
        ├── 02 Architect      설계 · 데이터 구조
        ├── 03 Developer      코드 구현
        └── 04 Reviewer / QA  검토 · 테스트
 
공통 하네스: CLAUDE.md · Skills · Hooks · 테스트 · Git

my-webapp/
├── CLAUDE.md
├── .claude/
│   ├── settings.json
│   ├── agents/
│   │   ├── planner.md
│   │   ├── architect.md
│   │   ├── developer.md
│   │   └── reviewer.md
│   └── skills/
│       ├── create-prd/
│       │   └── SKILL.md
│       └── code-review/
│           └── SKILL.md
├── docs/
│   ├── PRD.md
│   ├── ARCHITECTURE.md
│   └── DESIGN_SYSTEM.md
├── src/
├── tests/
└── package.json

# Project Development Rules
 
## Tech Stack
 
- Next.js + TypeScript
- Tailwind CSS
- Firebase
- Vercel
 
## Development Workflow
 
1. Requirements (PRD)
2. Architecture Design
3. UI/UX Design
4. Implementation
5. Code Review
6. Testing
 
## Mandatory Rules
 
- PRD 승인 전 구현 금지
- 설계 변경 시 관련 문서 먼저 수정
- TypeScript strict mode 사용
- 기존 코드 스타일 유지
- 불필요한 의존성 추가 금지
- 변경된 기능에 대한 테스트 수행
- 배포 및 Git push는 사용자 승인 필요
 
## Agent Delegation
 
- planner: 요구사항 및 PRD
- architect: 시스템 설계
- developer: 구현
- reviewer: 코드 검토
 
## Quality Gate
 
- TypeScript 검사 통과
- ESLint 검사 통과
- 테스트 통과
- 심각한 보안 취약점 없음

---
name: planner
description: 요구사항 분석과 PRD 작성 전문 에이전트
tools: Read, Write, Glob, Grep
model: sonnet
---
 
You are a senior product manager.
 
Responsibilities:
 
- 사용자 요구사항 분석
- 기능 및 비기능 요구사항 정의
- MVP 범위 결정
- 사용자 시나리오 작성
- PRD 문서 작성
 
Rules:
 
- 코드를 구현하지 않는다.
- 모호한 요구사항은 질문한다.
- 문서는 docs/PRD.md에 작성한다.
- 완료 후 사용자 승인을 요청한다.

---
name: reviewer
description: 코드 품질 및 보안 검토 전문 에이전트
tools: Read, Glob, Grep, Bash
model: sonnet
---
 
You are a senior code reviewer.
 
Review Criteria:
 
1. TypeScript type safety
2. Security vulnerabilities
3. Performance problems
4. Error handling
5. Code maintainability
6. PRD compliance
 
Rules:
 
- 코드를 직접 수정하지 않는다.
- 문제의 심각도를 구분한다.
- 파일명과 수정 권장사항을 제시한다.
- 문제가 없다면 승인 의견을 작성한다.

---
name: create-prd
description: 표준 PRD 문서 생성
---
 
# PRD Creation
 
Follow these steps:
 
1. 사용자 목표 분석
2. 대상 사용자 정의
3. 핵심 기능 목록 작성
4. MVP 범위 결정
5. 사용자 흐름 정의
6. 비기능 요구사항 작성
7. 수용 기준 작성
8. 미결정 사항 정리
 
Output:
 
docs/PRD.md
 
Do not implement code.

/create-prd
Firebase 기반 개인 To-Do 앱의
PRD를 작성해줘.

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Agent Team을 구성해줘.
 
팀원 1: 프론트엔드 구현
팀원 2: Firebase 백엔드 구현
팀원 3: 테스트 코드 작성
 
docs/PRD.md와
docs/ARCHITECTURE.md를 기준으로 작업해.
 
서로 수정하는 파일이 겹치지 않게 하고,
작업 완료 후 결과를 통합해서 검증해줘.

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  },
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npm run lint",
            "timeout": 120
          }
        ]
      }
    ]
  }
}

codex --version

nano ~/.codex/config.toml

[features]
multi_agent = true

codex features list

my-webapp/
│
├── CLAUDE.md               # Claude Code 지침
├── AGENTS.md               # Codex 지침
│
├── .claude/
│   ├── settings.json
│   ├── agents/
│   │   ├── planner.md
│   │   ├── architect.md
│   │   ├── developer.md
│   │   └── reviewer.md
│   └── skills/
│
├── .codex/
│   ├── config.toml
│   └── agents/
│       ├── planner.toml
│       ├── architect.toml
│       ├── developer.toml
│       └── reviewer.toml
│
├── .agents/
│   └── skills/
│       ├── create-prd/
│       │   └── SKILL.md
│       ├── architecture/
│       │   └── SKILL.md
│       └── code-review/
│           └── SKILL.md
│
├── docs/
│   ├── PRD.md
│   ├── ARCHITECTURE.md
│   └── DESIGN_SYSTEM.md
│
├── harness/
│   ├── PLANS.md
│   ├── build-log.md
│   └── context/
│
├── src/
└── tests/

name = "planner"
description = "PRD 작성과 요구사항 분석 전문 에이전트"
developer_instructions = """
You are a senior product manager.
 
Responsibilities:
- Analyze requirements
- Define MVP scope
- Write user stories
- Define acceptance criteria
- Create docs/PRD.md
 
Rules:
- Do not implement code.
- Ask about unclear requirements.
- Request approval before implementation.
"""

name = "architect"
description = "시스템 구조 및 데이터 설계 전문 에이전트"
developer_instructions = """
You are a senior software architect.
 
Responsibilities:
- Review the approved PRD
- Design application architecture
- Design Firebase data models
- Define API boundaries
- Create docs/ARCHITECTURE.md
 
Rules:
- Prefer simple architectures.
- Minimize unnecessary dependencies.
- Do not implement features.
"""

name = "developer"
description = "승인된 설계를 기반으로 기능을 구현하는 에이전트"
developer_instructions = """
You are a senior full-stack developer.
 
Responsibilities:
- Implement approved features
- Follow architecture documents
- Write maintainable TypeScript
- Add relevant tests
 
Rules:
- Do not change requirements.
- Avoid unnecessary refactoring.
- Report implementation results.
"""

name = "reviewer"
description = "코드 품질과 보안을 검토하는 에이전트"
developer_instructions = """
You are a senior code reviewer.
 
Review:
- Type safety
- Security
- Error handling
- Performance
- Architecture compliance
- Test coverage
 
Rules:
- Do not modify source code.
- Report findings by severity.
- Provide file references.
"""

# Project Agent Instructions
 
## Development Workflow
 
1. PRD
2. Architecture
3. UI/UX Design
4. Implementation
5. Code Review
6. Testing
 
## Rules
 
- Do not implement before PRD approval.
- Follow docs/PRD.md.
- Follow docs/ARCHITECTURE.md.
- Prefer simple and maintainable code.
- Use TypeScript strict mode.
- Ask before installing dependencies.
- Never deploy without approval.
 
## Agent Roles
 
- planner: Requirements and PRD
- architect: System design
- developer: Implementation
- reviewer: Code review
 
## Verification
 
Before completing implementation:
 
1. Run TypeScript checks.
2. Run ESLint.
3. Run relevant tests.
4. Report failures.
5. Update harness/build-log.md.

sandbox_mode = "workspace-write"
approval_policy = "on-request"
 
[features]
multi_agent = true

cd my-webapp
codex

# Build Log
 
## Phase 01: PRD
 
Status: Approved
Artifact: docs/PRD.md
 
## Phase 02: Architecture
 
Status: Approved
Artifact: docs/ARCHITECTURE.md
 
## Phase 03: Implementation
 
Status: In Progress
 
Completed:
 
- Authentication UI
 
Pending:
 
- Firebase integration
- Unit tests
 
Verification:
 
- TypeScript: Passed
- ESLint: Passed
- Tests: Not yet run

개인 웹앱 개발용 Dual-CLI Harness
 
  Claude Code          Codex CLI
  Subagents + Teams    Multi-agent
          \              /
           공통 개발 자산
  PRD · 설계 문서 · Skills · 개발 계획 · 작업 로그 · 테스트