PLANS.md

이 파일은 실행 계획(execution plan)이 어떻게 생성·업데이트·완료·보관되는지를 정의합니다.

실행 계획은 단일 세션을 초과하는 작업, 여러 하위 시스템에 걸친 변경, 또는 공개된 결정 사항이 있는 작업을 구조화된 방식으로 추적합니다. 계획을 저장소에 영속화함으로써 에이전트(agent)가 이전 컨텍스트(context) 없이도 작업을 이어받을 수 있습니다.

계획이 필요한 경우

다음에 해당할 때 실행 계획을 생성한다.

• 하나 이상의 세션에 걸치는 작업
• 하나 이상의 하위 시스템을 변경하는 작업
• 중요하지 않은 검증 또는 배포 위험이 있는 작업
• 기록되어야 할 미결 결정이 있는 작업

계획 위치

• docs/exec-plans/active/: 현재 작업을 이끄는 계획
• docs/exec-plans/completed/: 향후 에이전트 컨텍스트를 위해 보관된 완료 계획
• docs/exec-plans/tech-debt-tracker.md: 미뤄진 작업과 후속 조치

최소 계획 섹션

• 목표(objective)
• 범위 및 범위 외(scope and out-of-scope)
• 검증 경로(verification path)
• 위험 및 차단 요소(risks and blockers)
• 진행 로그(progress log)
• 미결 결정(open decisions)

운영 규칙

• 하나의 활성 계획에는 현재 진행 중인 단계가 명확하게 하나 있어야 한다.
• 작업이 진행되면 계획을 업데이트한다. 정적 산문으로 취급하지 않는다.
• 결정이 구현 방향을 변경하면 계획에 기록한다.
• 완료된 계획은 에이전트가 이전 컨텍스트를 계속 발견할 수 있도록 completed/로 이동한다.