mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-03-31 14:13:27 +08:00
3e9c207c25
Add missing example sessions, code blocks, and detailed sections to 14 command files that were previously summarized versions.
173 lines
3.7 KiB
Markdown
173 lines
3.7 KiB
Markdown
# Orchestrate 커맨드
|
|
|
|
복잡한 작업을 위한 순차적 에이전트 워크플로우입니다.
|
|
|
|
## 사용법
|
|
|
|
`/orchestrate [workflow-type] [task-description]`
|
|
|
|
## 워크플로우 유형
|
|
|
|
### feature
|
|
전체 기능 구현 워크플로우:
|
|
```
|
|
planner -> tdd-guide -> code-reviewer -> security-reviewer
|
|
```
|
|
|
|
### bugfix
|
|
버그 조사 및 수정 워크플로우:
|
|
```
|
|
planner -> tdd-guide -> code-reviewer
|
|
```
|
|
|
|
### refactor
|
|
안전한 리팩토링 워크플로우:
|
|
```
|
|
architect -> code-reviewer -> tdd-guide
|
|
```
|
|
|
|
### security
|
|
보안 중심 리뷰:
|
|
```
|
|
security-reviewer -> code-reviewer -> architect
|
|
```
|
|
|
|
## 실행 패턴
|
|
|
|
워크플로우의 각 에이전트에 대해:
|
|
|
|
1. 이전 에이전트의 컨텍스트로 **에이전트 호출**
|
|
2. 구조화된 핸드오프 문서로 **출력 수집**
|
|
3. 체인의 **다음 에이전트에 전달**
|
|
4. **결과를 종합**하여 최종 보고서 작성
|
|
|
|
## 핸드오프 문서 형식
|
|
|
|
에이전트 간에 핸드오프 문서를 생성합니다:
|
|
|
|
```markdown
|
|
## HANDOFF: [이전-에이전트] -> [다음-에이전트]
|
|
|
|
### Context
|
|
[수행된 작업 요약]
|
|
|
|
### Findings
|
|
[주요 발견 사항 또는 결정 사항]
|
|
|
|
### Files Modified
|
|
[수정된 파일 목록]
|
|
|
|
### Open Questions
|
|
[다음 에이전트를 위한 미해결 항목]
|
|
|
|
### Recommendations
|
|
[제안하는 다음 단계]
|
|
```
|
|
|
|
## 예시: Feature 워크플로우
|
|
|
|
```
|
|
/orchestrate feature "Add user authentication"
|
|
```
|
|
|
|
실행 순서:
|
|
|
|
1. **Planner 에이전트**
|
|
- 요구사항 분석
|
|
- 구현 계획 작성
|
|
- 의존성 식별
|
|
- 출력: `HANDOFF: planner -> tdd-guide`
|
|
|
|
2. **TDD Guide 에이전트**
|
|
- planner 핸드오프 읽기
|
|
- 테스트 먼저 작성
|
|
- 테스트를 통과하도록 구현
|
|
- 출력: `HANDOFF: tdd-guide -> code-reviewer`
|
|
|
|
3. **Code Reviewer 에이전트**
|
|
- 구현 리뷰
|
|
- 이슈 확인
|
|
- 개선사항 제안
|
|
- 출력: `HANDOFF: code-reviewer -> security-reviewer`
|
|
|
|
4. **Security Reviewer 에이전트**
|
|
- 보안 감사
|
|
- 취약점 점검
|
|
- 최종 승인
|
|
- 출력: 최종 보고서
|
|
|
|
## 최종 보고서 형식
|
|
|
|
```
|
|
ORCHESTRATION REPORT
|
|
====================
|
|
Workflow: feature
|
|
Task: Add user authentication
|
|
Agents: planner -> tdd-guide -> code-reviewer -> security-reviewer
|
|
|
|
SUMMARY
|
|
-------
|
|
[한 단락 요약]
|
|
|
|
AGENT OUTPUTS
|
|
-------------
|
|
Planner: [요약]
|
|
TDD Guide: [요약]
|
|
Code Reviewer: [요약]
|
|
Security Reviewer: [요약]
|
|
|
|
FILES CHANGED
|
|
-------------
|
|
[수정된 모든 파일 목록]
|
|
|
|
TEST RESULTS
|
|
------------
|
|
[테스트 통과/실패 요약]
|
|
|
|
SECURITY STATUS
|
|
---------------
|
|
[보안 발견 사항]
|
|
|
|
RECOMMENDATION
|
|
--------------
|
|
[SHIP / NEEDS WORK / BLOCKED]
|
|
```
|
|
|
|
## 병렬 실행
|
|
|
|
독립적인 검사에 대해서는 에이전트를 병렬로 실행합니다:
|
|
|
|
```markdown
|
|
### Parallel Phase
|
|
동시에 실행:
|
|
- code-reviewer (품질)
|
|
- security-reviewer (보안)
|
|
- architect (설계)
|
|
|
|
### Merge Results
|
|
출력을 단일 보고서로 통합
|
|
```
|
|
|
|
## 인자
|
|
|
|
$ARGUMENTS:
|
|
- `feature <description>` - 전체 기능 워크플로우
|
|
- `bugfix <description>` - 버그 수정 워크플로우
|
|
- `refactor <description>` - 리팩토링 워크플로우
|
|
- `security <description>` - 보안 리뷰 워크플로우
|
|
- `custom <agents> <description>` - 사용자 정의 에이전트 순서
|
|
|
|
## 사용자 정의 워크플로우 예시
|
|
|
|
```
|
|
/orchestrate custom "architect,tdd-guide,code-reviewer" "Redesign caching layer"
|
|
```
|
|
|
|
## 팁
|
|
|
|
1. 복잡한 기능에는 **planner부터 시작**하세요
|
|
2. merge 전에는 **항상 code-reviewer를 포함**하세요
|
|
3. 인증/결제/개인정보 처리에는 **security-reviewer를 사용**하세요
|
|
4. **핸드오프는 간결하게** 유지하세요 - 다음 에이전트에 필요한 것에 집중
|
|
5. 필요한 경우 에이전트 사이에 **검증을 실행**하세요
|