Files
everything-claude-code/docs/ko-KR/commands/plan.md
hahmee a693d2e023 docs(ko-KR): add Korean translation for commands and agents
- commands: 18 files (build-fix, checkpoint, code-review, e2e, eval,
  go-build, go-review, go-test, learn, orchestrate, plan, refactor-clean,
  setup-pm, tdd, test-coverage, update-codemaps, update-docs, verify)
- agents: 12 files (architect, build-error-resolver, code-reviewer,
  database-reviewer, doc-updater, e2e-runner, go-build-resolver,
  go-reviewer, planner, refactor-cleaner, security-reviewer, tdd-guide)
2026-03-10 12:56:11 +09:00

1.7 KiB

description
description
요구사항을 재확인하고, 위험을 평가하며, 단계별 구현 계획을 작성합니다. 코드를 건드리기 전에 사용자 확인을 기다립니다.

Plan 커맨드

이 커맨드는 planner 에이전트를 호출하여 코드를 작성하기 전에 포괄적인 구현 계획을 만듭니다.

이 커맨드가 하는 것

  1. 요구사항 재확인 - 무엇을 만들어야 하는지 명확히 함
  2. 위험 식별 - 잠재적 이슈와 차단 요소 도출
  3. 단계별 계획 작성 - 구현을 단계로 분해
  4. 확인 대기 - 진행 전 반드시 사용자 승인을 받음

사용 시점

/plan을 사용해야 할 때:

  • 새 기능 시작
  • 중요한 아키텍처 변경
  • 복잡한 리팩토링 작업
  • 여러 파일/컴포넌트에 영향을 미칠 때
  • 요구사항이 불명확하거나 모호할 때

작동 방식

planner 에이전트가 수행하는 작업:

  1. 요청을 분석하고 요구사항을 명확하게 재확인
  2. 구체적이고 실행 가능한 단계로 분해
  3. 컴포넌트 간 의존성 식별
  4. 위험 평가 및 잠재적 차단 요소 파악
  5. 복잡도 추정 (High/Medium/Low)
  6. 계획을 제시하고 명시적 확인을 대기

중요 참고 사항

핵심: planner 에이전트는 "yes"나 "proceed" 같은 긍정적 응답으로 명시적으로 확인하기 전까지 코드를 작성하지 않습니다.

다른 커맨드와의 연계

계획 수립 후:

  • /tdd를 사용하여 테스트 주도 개발로 구현
  • /build-fix로 build 에러 발생 시 수정
  • /code-review로 완성된 구현 리뷰

관련 에이전트

이 커맨드는 planner 에이전트를 호출합니다: ~/.claude/agents/planner.md