plan

name	plan
description	구현 전 설계 및 계획 수립 — 요구사항 분석, 설계 대안 비교, 구현 계획을 사용자와 정렬한다
user-invocable	true

Plan

1. 요구사항 분석

• 인자가 전달되면 (/plan <task-description>) 그 내용을 작업 설명으로 쓴다.
• docs/architecture.md와 .agents/rules/를 읽어 제약을 확인하고, 관련 기존 코드를 탐색해 현재 구조와 패턴을 파악한다.
• 정리할 항목: 목표 / 제약(건드리면 안 되는 것) / 영향 범위(파일·모듈) / 불확실한 점.

2. 설계 대안 비교

3개 이상 파일을 고치거나 설계 판단이 필요할 때만 한다. 단순한 변경이면 건너뛴다.

접근 방식 2-3개를 도출하고 각각에 대해: 핵심 아이디어(1-2문장), 장점, 단점/리스크, 영향받는 파일·모듈.

3. 구현 계획

선택한 방식을 작업 단위로 분해한다. 각 단위마다 변경할 파일·모듈, 검증 방법, 예상 commit 단위(commits.md)를 적는다.

• 의존되는 쪽을 먼저 구현한다.
• 각 단계가 끝난 시점에 AGENTS.md의 Verify 게이트가 통과하는 상태여야 한다.
• 새 라이브러리를 도입하면 .agents/rules/dependencies.md의 선정 절차를 따르고 근거를 docs/architecture.md에 남긴다.

4. 사용자 확인

계획을 다음 형식으로 보고하고 구현 전 정렬한다.

목표 및 제약

(정리된 목표와 제약)

접근 방식

(선택한 방식과 이유. 대안이 있었으면 비교 요약)

구현 계획

(번호가 매겨진 단계별 목록)

불확실한 점

(추가 확인이 필요한 사항. 없으면 없음)

사용자가 계획을 승인하면 구현을 시작한다. 수정 요청이 있으면 계획을 조정한 후 재확인한다.