로드맵 규칙

agent-ops/roadmap/ 디렉터리가 있는 프로젝트에서만 적용한다.

로딩

세션 최초 1회 agent-ops/roadmap/current.md를 읽고 활성 Milestone 후보의 이름, 경로, 선택 규칙만 짧게 기억한다.
활성 Milestone 후보는 agent-ops/roadmap/milestones/ 하위 문서만 대상으로 한다.
Milestone의 목표, 주요 범위, 범위 제외는 선택한 활성 Milestone 문서에서 확인한다.
일반 작업에서는 ROADMAP.md를 읽지 않는다.
ROADMAP.md는 로드맵 생성/갱신, Phase 전환, Milestone 추가/수정, 활성 Milestone 밖 작업 확인 때만 읽는다.
agent-ops/roadmap/archive/**는 사용자가 과거 Milestone 상세 확인이나 복원을 명시적으로 요청한 경우에만 읽는다.

current.md는 현재 작업 위치가 아니라 활성 Milestone 후보 목록이다.
기능 추가, 구조 변경, 스킬/문서 구조 변경 전에는 요청, 브랜치, 변경 파일, 관련 경로를 보고 관련 Milestone 문서를 1회 읽는다.
선택한 Milestone의 목표 또는 범위 제외와 요청이 충돌하면 구현 전에 사용자에게 확인한다.
current.md가 아카이브 경로를 가리키면 그 항목은 활성 후보로 읽지 말고 로드맵 갱신이 필요하다고 보고한다.

구현 잠금은 승인 의식이 아니라 사용자 결정이 필요한지 표시하는 얇은 상태다.
제품 방향, 범위, 우선순위, 책임 경계처럼 사용자만 결정할 수 있는 항목이 남아 있으면 상태를 잠금으로 두고 결정 필요 체크리스트에 질문을 적는다.
기존 구조, 도메인 rule, 플랫폼 관례, 업계 표준으로 합리적으로 정할 수 있는 항목은 결정 필요가 아니라 작업 컨텍스트의 표준선이나 구현 가정으로 기록한다.
작업에 필요한 결정이 이미 충분히 정해져 에이전트가 실행만 하면 되는 Milestone은 상태를 해제로 둔다.
선택한 Milestone에 구현 잠금 섹션이 없거나 상태가 잠금이면 코드 구현, agent-task 구현 계획, 세부 API/파일 구조 확정을 시작하기 전에 현재 요청에 직접 영향을 주는 결정 필요 항목만 사용자에게 확인한다.
현재 요청과 직접 관련 없는 미정 항목은 잠금 상태로 남겨도 되며, 표준선으로 처리 가능한 작업을 막지 않는다.
잠금 상태를 바꾸더라도 필수 기능이나 완료 기준을 자동 완료 처리하지 않는다.

Milestone 문서의 필수 기능 체크리스트는 - [ ] [item-id] 설명 형식을 사용한다.
item-id는 공백 없는 짧은 ASCII 토큰이며, 영문/숫자 segment 1~~4개로 작성하고 segment 구분자는 -, _, +, =만 사용한다. 가능하면 1~~3 segment를 우선하며, 전체 길이는 32자 이하를 권장한다.
item-id는 해당 Milestone 안에서만 유일하면 된다.
다른 Milestone에서는 같은 item-id를 다시 사용할 수 있다. 여러 Milestone 후보에서 같은 item-id가 발견되면 Milestone 이름이나 문서 경로로 대상을 확정한다.
사용자가 item-id를 언급하면 해당 Milestone의 필수 기능 항목을 우선 anchor로 삼고, 기존 item-id는 명시적 요청 없이 바꾸지 않는다.

현재 작업 지점이나 남은 작업 분석 요청은 analyze-roadmap-position 스킬로 처리한다.
분석 답변은 agent-ops/skills/common/_templates/roadmap-position-report-template.md 섹션과 필드 순서를 따른다.
이때 current.md만으로 단정하지 말고 코드, git 상태, diff, 활성 Milestone 문서를 함께 본다.