AgentsBuild & Analysis
Planner
사용자 인터뷰를 거쳐 실행 가능한 작업 계획을 수립하는 전략 계획 에이전트.
개요
Planner는 사용자와 정해진 순서로 인터뷰를 거쳐 실행 가능한 작업 계획을 만드는 에이전트입니다. "X를 해줘"라는 요청을 받으면, 직접 구현하지 않고 "X를 위한 작업 계획"을 만듭니다.
핵심 원칙은 두 가지입니다.
- 사용자에게는 선호도/우선순위만 질문하고, 코드베이스 사실은 explore 에이전트로 직접 확인합니다
- 3-6 단계의 실행 가능한 계획을 생성합니다 (30개 마이크로 스텝도, 2개 모호한 지시도 아닙니다)
계획은 .omc/plans/{name}.md에 저장됩니다.
언제 쓰는가
- 새 기능이나 프로젝트의 실행 계획이 필요할 때
- 리팩토링이나 마이그레이션의 단계를 정리할 때
- 복잡한 작업의 순서와 의존성을 파악할 때
- ralplan(합의 기반 계획)을 실행할 때
사용 예시
"다크 모드 추가 계획을 세워줘"
"이 모듈 리팩토링 계획을 만들어줘"
"ralplan으로 인증 시스템 재설계 계획을 수립해줘"계획 수립 프로세스
- 의도 분류: 간단한 수정 / 리팩토링 / 신규 구축 / 중간 규모 중 판단합니다
- 코드베이스 조사: explore 에이전트로 기존 패턴과 구조를 파악합니다
- 사용자 인터뷰: 선호도, 타임라인, 범위 결정에 대해 한 번에 하나씩 질문합니다
- analyst 자문: 계획 생성 전에 요구사항 갭을 분석합니다
- 계획 생성: 컨텍스트, 목표, 가드레일, 작업 흐름, 상세 TODO, 성공 기준을 포함합니다
- 사용자 확인: 명시적 승인을 받은 후에만 실행 단계로 이동합니다
Consensus 모드 (ralplan)
/plan --consensus 또는 /ralplan으로 실행하면 합의 기반 계획 모드가 켜집니다.
- RALPLAN-DR 요약: 원칙(3-5개), 결정 동인(상위 3개), 실행 가능한 옵션(2개 이상)
- ADR 포함: 결정, 동인, 검토된 대안, 선택 이유, 결과, 후속 작업
--deliberate플래그: 고위험 작업에 대해 사전 검토(pre-mortem)와 확장 테스트 계획을 추가합니다
다른 에이전트와의 조합
- explore: 코드베이스 사실 확인용으로 자동 스폰합니다
- analyst: 계획 생성 전 요구사항 갭 분석에 자문합니다
- critic: 생성된 계획의 품질을 검토합니다
- executor: 계획 승인 후 구현을 담당합니다
레퍼런스
| 항목 | 값 |
|---|---|
| 모델 | opus |
| 서브에이전트 타입 | oh-my-claudecode:planner |
| 레인 | Build & Analysis |
| 출력 경로 | .omc/plans/{name}.md |