From ded8d832b391d0167ec1b303ec383bef2d5cb467 Mon Sep 17 00:00:00 2001 From: toki Date: Sun, 24 May 2026 17:00:10 +0900 Subject: [PATCH] sync: from oto v1.1.48 --- agent-ops/.version | 2 +- agent-ops/rules/common/rules-roadmap.md | 2 +- .../_templates/roadmap-current-template.md | 2 +- .../_templates/roadmap-milestone-template.md | 2 +- .../common/_templates/roadmap-template.md | 2 +- .../skills/common/create-roadmap/SKILL.md | 12 ++++++------ agent-ops/skills/common/plan/SKILL.md | 2 +- .../skills/common/update-roadmap/SKILL.md | 18 +++++++++--------- 8 files changed, 21 insertions(+), 21 deletions(-) diff --git a/agent-ops/.version b/agent-ops/.version index d388d61..a8646df 100644 --- a/agent-ops/.version +++ b/agent-ops/.version @@ -1 +1 @@ -1.1.47 +1.1.48 diff --git a/agent-ops/rules/common/rules-roadmap.md b/agent-ops/rules/common/rules-roadmap.md index 0978736..0764d94 100644 --- a/agent-ops/rules/common/rules-roadmap.md +++ b/agent-ops/rules/common/rules-roadmap.md @@ -23,7 +23,7 @@ - `구현 잠금`은 승인 의식이 아니라 사용자 결정이 필요한지 표시하는 얇은 상태다. - 제품 방향, 범위, 우선순위, 책임 경계처럼 사용자만 결정할 수 있는 항목이 남아 있으면 상태를 `잠금`으로 두고 `결정 필요` 체크리스트에 질문을 적는다. - 기존 구조, 도메인 rule, 플랫폼 관례, 업계 표준으로 합리적으로 정할 수 있는 항목은 `결정 필요`가 아니라 `작업 컨텍스트`의 표준선이나 구현 가정으로 기록한다. -- 작업에 필요한 결정이 이미 충분히 정해져 에이전트가 실행만 하면 되는 Milestone은 상태를 `해제`로 둔다. +- Milestone 전체에서 사용자만 결정할 항목이 더 이상 없고 에이전트가 표준선에 따라 실행하면 되는 상태라면 `해제`로 둔다. - 선택한 Milestone에 `구현 잠금` 섹션이 없거나 상태가 `잠금`이면 코드 구현, `agent-task` 구현 계획, 세부 API/파일 구조 확정을 시작하기 전에 현재 요청에 직접 영향을 주는 `결정 필요` 항목만 사용자에게 확인한다. - 현재 요청과 직접 관련 없는 미정 항목은 잠금 상태로 남겨도 되며, 표준선으로 처리 가능한 작업을 막지 않는다. - 잠금 상태를 바꾸더라도 `필수 기능`이나 `완료 기준`을 자동 완료 처리하지 않는다. diff --git a/agent-ops/skills/common/_templates/roadmap-current-template.md b/agent-ops/skills/common/_templates/roadmap-current-template.md index 8a694ec..ff6695f 100644 --- a/agent-ops/skills/common/_templates/roadmap-current-template.md +++ b/agent-ops/skills/common/_templates/roadmap-current-template.md @@ -11,4 +11,4 @@ - 요청 내용, 현재 브랜치, 변경 파일, 관련 코드 경로를 보고 가장 관련 있는 Milestone을 선택하고 같은 세션에서 1회 읽는다. - 활성 Milestone 둘 이상에 걸치면 필요한 Milestone 문서를 모두 읽고 작업 범위를 좁힌다. - 활성 Milestone 밖의 작업이면 `agent-ops/roadmap/ROADMAP.md`의 Milestone 목록을 확인하고 사용자에게 진행 또는 전환 여부를 확인한다. -- 선택된 Milestone의 `구현 잠금` 섹션이 없거나 상태가 `잠금`이면 구현이나 구현 계획을 시작하기 전에 현재 요청에 직접 영향을 주는 `결정 필요` 항목만 확인한다. 관련 결정이 없고 표준선으로 처리 가능하면 잠금을 유지한 채 진행할 수 있으며, 작업에 필요한 결정이 모두 정해져 있으면 Milestone 문서의 `구현 잠금` 상태를 `해제`로 둔다. +- 선택된 Milestone의 `구현 잠금` 섹션이 없거나 상태가 `잠금`이면 구현이나 구현 계획을 시작하기 전에 현재 요청에 직접 영향을 주는 `결정 필요` 항목만 확인한다. 관련 결정이 없고 표준선으로 처리 가능하면 잠금을 유지한 채 진행할 수 있으며, Milestone 전체에서 사용자만 결정할 항목이 더 이상 없을 때만 `구현 잠금` 상태를 `해제`로 둔다. diff --git a/agent-ops/skills/common/_templates/roadmap-milestone-template.md b/agent-ops/skills/common/_templates/roadmap-milestone-template.md index 6a54dde..31739d8 100644 --- a/agent-ops/skills/common/_templates/roadmap-milestone-template.md +++ b/agent-ops/skills/common/_templates/roadmap-milestone-template.md @@ -38,7 +38,7 @@ ## 작업 컨텍스트 - 관련 경로: `` -- 표준선: <기존 구조, 도메인 rule, 플랫폼 관례, 업계 표준으로 진행할 기본 기준 또는 없음> +- 표준선(선택): <기존 구조, 도메인 rule, 플랫폼 관례, 업계 표준으로 진행할 기본 기준> - 선행 작업: <없음 또는 Milestone/태스크 이름> - 후속 작업: <없음 또는 Milestone/태스크 이름> - 확인 필요: diff --git a/agent-ops/skills/common/_templates/roadmap-template.md b/agent-ops/skills/common/_templates/roadmap-template.md index 06e5f3e..c707f4c 100644 --- a/agent-ops/skills/common/_templates/roadmap-template.md +++ b/agent-ops/skills/common/_templates/roadmap-template.md @@ -35,4 +35,4 @@ - 아카이브된 Milestone 문서는 최신 템플릿이나 스킬 규약에 맞춰 재포맷하지 않는다. - 선택된 Milestone의 `구현 잠금` 섹션이 없거나 상태가 `잠금`이면 코드 구현, `agent-task` 구현 계획 생성, 세부 API/파일 구조 확정을 시작하기 전에 현재 요청에 직접 영향을 주는 `결정 필요` 항목만 확인한다. - 현재 요청과 직접 관련 없는 미정 항목은 잠금 상태로 남겨도 되며, 기존 구조/도메인 rule/플랫폼 관례로 정할 수 있는 작업은 표준선으로 기록하고 진행할 수 있다. -- 작업에 필요한 결정이 모두 정해져 에이전트가 실행만 하면 되는 Milestone은 `구현 잠금` 상태를 `해제`로 둔다. +- Milestone 전체에서 사용자만 결정할 항목이 더 이상 없고 에이전트가 표준선에 따라 실행하면 되는 상태라면 `구현 잠금` 상태를 `해제`로 둔다. diff --git a/agent-ops/skills/common/create-roadmap/SKILL.md b/agent-ops/skills/common/create-roadmap/SKILL.md index ad755ab..cb757d6 100644 --- a/agent-ops/skills/common/create-roadmap/SKILL.md +++ b/agent-ops/skills/common/create-roadmap/SKILL.md @@ -11,8 +11,8 @@ description: AI-first 개인/소규모 프로젝트의 전체 목표, Phase, 결 `agent-ops/roadmap/` 하위에 전체 목표 / Phase / Milestone 기반 한국어 로드맵 구조를 처음 생성한다. 전체 로드맵은 로드맵 설계와 갱신 때만 읽고, 일반 작업에서는 `current.md`의 활성 Milestone 창과 관련 Milestone 문서만 읽도록 공통 로드맵 룰을 따른다. Milestone은 구현 계획이 아니라 방향성, 범위, 위험, 확인 필요 사항을 기록하는 협업 문서로 시작한다. -새 Milestone의 `구현 잠금`은 사용자만 결정할 수 있는 항목이 있을 때만 잠금으로 둔다. 기존 구조, 도메인 rule, 플랫폼 관례, 업계 표준으로 정할 수 있는 항목은 `결정 필요`가 아니라 표준선으로 기록한다. -작업에 필요한 결정이 모두 정해져 에이전트가 실행만 하면 되는 Milestone은 해제 상태로 둔다. +새 Milestone의 `구현 잠금`은 사용자만 결정할 수 있는 항목이 있을 때만 잠금으로 둔다. 기존 구조, 도메인 rule, 플랫폼 관례, 업계 표준으로 정할 수 있는 항목은 `결정 필요`가 아니라 필요 시 표준선으로 기록한다. +Milestone 전체에서 사용자만 결정할 항목이 더 이상 없고 에이전트가 표준선에 따라 실행하면 되는 상태라면 해제 상태로 둔다. ## 언제 호출할지 @@ -61,9 +61,9 @@ agent-ops/ - 새 Milestone 문서는 `agent-ops/skills/common/_templates/roadmap-milestone-template.md` 형식을 따른다. - 섹션 순서는 `목표`, `단계`, `상태`, `구현 잠금`, `범위`, `필수 기능`, `완료 기준`, `범위 제외`, `작업 컨텍스트`를 유지한다. - 새 Milestone은 제품 방향, 범위, 우선순위, 책임 경계 등 사용자만 결정할 수 있는 항목이 남아 있으면 `구현 잠금` 상태를 `잠금`으로 둔다. -- 작업에 필요한 결정이 이미 충분히 정해져 에이전트가 실행만 하면 되는 Milestone은 `구현 잠금` 상태를 `해제`로 둔다. +- Milestone 전체에서 사용자만 결정할 항목이 더 이상 없고 에이전트가 표준선에 따라 실행하면 되는 상태라면 `구현 잠금` 상태를 `해제`로 둔다. - `구현 잠금`에는 상태와 `결정 필요` 체크리스트만 적는다. 결정할 항목이 없으면 `결정 필요: 없음`으로 적고, 별도 해제 근거/금지 목록을 만들지 않는다. -- 기존 구조, 도메인 rule, 플랫폼 관례, 업계 표준으로 처리 가능한 내용은 `결정 필요`에 넣지 않고 `작업 컨텍스트`의 `표준선`에 기록한다. +- 기존 구조, 도메인 rule, 플랫폼 관례, 업계 표준으로 처리 가능한 내용은 `결정 필요`에 넣지 않고, 필요할 때만 `작업 컨텍스트`의 `표준선`에 기록한다. - `필수 기능`은 구현 파일/함수 단위 작업 목록이 아니라 Milestone에서 달성해야 할 capability 또는 산출물 체크리스트로 작성한다. 완료 근거가 명확한 항목만 `- [x]`로 표시한다. - `필수 기능`의 각 체크리스트 항목은 `- [ ] [item-id] 설명` 형식을 사용한다. item-id는 사람이 타이핑하고 LLM이 참조하기 쉬운 공백 없는 짧은 ASCII 토큰으로 작성한다. - item-id는 영문/숫자 segment 1~4개로 작성하고, segment 구분자는 `-`, `_`, `+`, `=`만 사용한다. 가능하면 1~3 segment를 우선하며, 전체 길이는 32자 이하를 권장한다. @@ -138,7 +138,7 @@ agent-ops/ - 각 Milestone 문서는 `roadmap-milestone-template.md`의 섹션 순서와 형식을 따른다. - 각 Milestone 문서에 `구현 잠금` 섹션을 포함한다. - 사용자만 결정할 수 있는 항목이 있으면 `구현 잠금` 상태는 `잠금`으로 작성하고, 필요한 결정을 체크리스트로 적는다. - - 작업에 필요한 결정이 모두 정해진 Milestone은 `구현 잠금` 상태를 `해제`로 작성하고, `결정 필요`는 `없음`으로 둔다. + - Milestone 전체에서 사용자만 결정할 항목이 더 이상 없으면 `구현 잠금` 상태를 `해제`로 작성하고, `결정 필요`는 `없음`으로 둔다. - `필수 기능`과 그 하위 항목은 capability 또는 산출물 수준의 `- [ ] [item-id] 설명` 체크리스트로 작성한다. - 완료 근거가 확인된 항목만 `- [x]`로 표시하고, 근거가 없으면 체크하지 않는다. - `완료 기준`도 검증 가능한 조건의 `- [ ]` 체크리스트로 작성한다. @@ -208,7 +208,7 @@ agent-ops/ - Milestone 문서를 단순 TODO 목록으로만 만들지 않는다. 반드시 템플릿의 목표, 단계, 상태, 구현 잠금, 범위, 필수 기능, 완료 기준, 범위 제외, 작업 컨텍스트를 포함한다. - Milestone 문서에서 `구현 잠금` 섹션을 생략하지 않는다. - 사용자만 결정할 수 있는 항목이 남아 있는데 새 Milestone을 `해제` 상태로 만들지 않는다. -- 작업에 필요한 결정이 모두 정해진 Milestone을 관성적으로 `잠금` 상태로 만들지 않는다. +- Milestone 전체에서 사용자만 결정할 항목이 더 이상 없는 Milestone을 관성적으로 `잠금` 상태로 만들지 않는다. - Milestone을 구현 계획처럼 package/file/function 단위로 과도하게 세분화하지 않는다. - 해야 할 capability 또는 산출물을 일반 불릿이나 설명 문장에 숨기지 않는다. `필수 기능` 또는 그 하위 항목의 item-id가 있는 체크리스트로 작성한다. - 확정되지 않은 제품 방향을 사실처럼 단정하지 않는다. diff --git a/agent-ops/skills/common/plan/SKILL.md b/agent-ops/skills/common/plan/SKILL.md index f2dbf92..d00a3e3 100644 --- a/agent-ops/skills/common/plan/SKILL.md +++ b/agent-ops/skills/common/plan/SKILL.md @@ -120,7 +120,7 @@ The routed plan file is the loop entry point. A missing active plan normally mea - `current.md`가 `agent-ops/roadmap/archive/**`를 가리키면 해당 문서는 읽지 말고 활성 Milestone이 아니라고 보고한다. - 선택한 Milestone을 한 번 읽는다. `구현 잠금` 섹션이 없거나 상태가 `잠금`이면 현재 요청에 직접 영향을 주는 `결정 필요` 항목만 확인하고, 그 결정 없이는 `PLAN-*-G??.md`, `CODE_REVIEW-*-G??.md`, file/API/package 수준 구현 단계를 확정하지 않는다. - 현재 요청과 직접 관련 없는 미정 항목은 잠금 상태로 남겨도 되며, 기존 구조, 도메인 rule, 플랫폼 관례로 정할 수 있는 세부는 표준선/가정으로 계획에 기록하고 진행할 수 있다. -- 사용자가 선택한 Milestone의 작업, 구현, 계획 작성을 명시했고 작업에 필요한 결정이 모두 정해져 있다면 계획 작성을 이어간다. Milestone 전체의 결정 필요 항목이 모두 정해졌을 때만 roadmap update 흐름으로 `구현 잠금` 상태를 `해제`로 갱신한다. 현재 요청에 직접 걸리는 결정이 필요하면 그 항목만 체크리스트로 남기고 사용자에게 확인한다. +- 사용자가 선택한 Milestone의 작업, 구현, 계획 작성을 명시했고 현재 계획에 필요한 결정이 모두 정해져 있다면 계획 작성을 이어간다. Milestone 전체에서 사용자만 결정할 항목이 더 이상 없을 때만 roadmap update 흐름으로 `구현 잠금` 상태를 `해제`로 갱신한다. 현재 요청에 직접 걸리는 결정이 필요하면 그 항목만 체크리스트로 남기고 사용자에게 확인한다. - roadmap/current 파일이 없으면 기존 task routing 규칙대로 진행한다. Use short snake_case task group names, e.g. `api_refactor`. diff --git a/agent-ops/skills/common/update-roadmap/SKILL.md b/agent-ops/skills/common/update-roadmap/SKILL.md index 1d750d9..529fd1a 100644 --- a/agent-ops/skills/common/update-roadmap/SKILL.md +++ b/agent-ops/skills/common/update-roadmap/SKILL.md @@ -13,8 +13,8 @@ description: 기존 전체 목표, Phase, 결정 필요 체크리스트 기반 Milestone은 구현 계획이 아니라 방향성, 범위, 위험, 확인 필요 사항을 기록하는 협업 문서로 유지한다. 구현 잠금은 승인 절차가 아니라 사용자 결정이 필요한지 표시하는 얇은 상태다. 제품 방향, 범위, 우선순위, 책임 경계처럼 사용자만 결정할 수 있는 항목이 남아 있으면 `잠금`으로 두고 `결정 필요` 체크리스트에 질문을 적는다. -기존 구조, 도메인 rule, 플랫폼 관례, 업계 표준으로 합리적으로 정할 수 있는 항목은 `결정 필요`가 아니라 표준선으로 기록한다. -작업에 필요한 결정이 모두 정해져 에이전트가 실행만 하면 되는 Milestone은 `해제`로 둔다. +기존 구조, 도메인 rule, 플랫폼 관례, 업계 표준으로 합리적으로 정할 수 있는 항목은 `결정 필요`가 아니라 필요 시 표준선으로 기록한다. +Milestone 전체에서 사용자만 결정할 항목이 더 이상 없고 에이전트가 표준선에 따라 실행하면 되는 상태라면 `해제`로 둔다. 잠금 상태 변경은 Milestone 완료 판정이 아니므로 `필수 기능`과 `완료 기준`을 자동 완료 처리하지 않는다. 완료 또는 폐기되어 현재 작업 후보에서 제외할 과거 Milestone은 `agent-ops/roadmap/archive/YYYY/MM/`로 이동하고, `ROADMAP.md`에는 아카이빙 당시 요약만 남긴다. 아카이브된 Milestone은 최신 스킬 규약이나 템플릿에 맞춰 재포맷하지 않고, 사용자가 명시적으로 과거 기록 확인이나 복원을 요청한 경우에만 읽는다. @@ -101,7 +101,7 @@ Milestone은 구현 계획이 아니라 방향성, 범위, 위험, 확인 필요 - 갱신 범위에 포함된 Milestone 문서가 제각각 형식이면, 내용을 삭제하지 말고 표준 섹션 순서로 재배치한다. - 기존 Milestone에 `구현 잠금` 섹션이 없으면 추가하고, 사용자만 결정할 수 있는 항목이 남아 있는지 보고 `잠금` 또는 `해제`를 정한다. - `구현 잠금` 섹션이 없거나 상태가 `잠금`이면 코드 구현, `agent-task` 구현 계획, 세부 API/파일 구조 확정을 시작하기 전에 현재 요청에 직접 영향을 주는 `결정 필요` 항목만 확인한다. -- `구현 잠금`은 사용자만 결정할 수 있는 항목이 있으면 `잠금`, 작업에 필요한 결정이 모두 정해져 에이전트가 실행만 하면 되면 `해제`로 둔다. +- `구현 잠금`은 사용자만 결정할 수 있는 항목이 있으면 `잠금`, Milestone 전체에서 사용자만 결정할 항목이 더 이상 없고 에이전트가 표준선에 따라 실행하면 되면 `해제`로 둔다. - `구현 잠금`에는 상태와 `결정 필요` 체크리스트만 유지한다. 결정할 항목이 없으면 `결정 필요: 없음`으로 적고, 별도 해제 근거/금지 목록은 만들지 않는다. - 기존 Milestone 문서에 `이유`, `해제 근거`, `잠금 중 금지`, 잠금 해제를 위한 별도 체크리스트가 있으면 사용자만 결정할 수 있는 질문만 `결정 필요` 체크리스트로 옮기고, 표준선이나 배경 설명은 `작업 컨텍스트`로 옮기거나 제거한다. - `필수 기능`은 구현 파일/함수 단위 작업 목록이 아니라 Milestone에서 달성해야 할 capability 또는 산출물 체크리스트로 유지한다. @@ -149,9 +149,9 @@ Milestone은 구현 계획이 아니라 방향성, 범위, 위험, 확인 필요 | 기존 태스크의 하위 작업 | 기존 태스크의 구현 세부, 보완, 테스트, 문서화, 예외 처리, 완료 기준 보완처럼 부모 태스크를 완성하기 위한 세부 항목이다. 잠긴 Milestone이어도 현재 작업에 직접 영향을 주는 사용자 결정이 없고 표준선으로 처리 가능하면 사용할 수 있다 | | 작업 컨텍스트/TODO | 사용자 결정이 아니라 조사/확인이 먼저 필요해 필수 기능으로 확정하기 어렵다 | -- 신규 Milestone은 사용자만 결정할 수 있는 항목이 있으면 `구현 잠금: 잠금`, 작업에 필요한 결정이 모두 정해져 있으면 `구현 잠금: 해제`로 생성한다. +- 신규 Milestone은 사용자만 결정할 수 있는 항목이 있으면 `구현 잠금: 잠금`, Milestone 전체에서 사용자만 결정할 항목이 더 이상 없으면 `구현 잠금: 해제`로 생성한다. - 잠긴 Milestone 안에 새 작업을 추가할 때 현재 요청에 직접 걸리는 사용자 결정은 `결정 필요` 체크리스트로 옮기고, 표준선으로 처리 가능한 세부 작업은 관련 `필수 기능` 항목의 하위 작업이나 `작업 컨텍스트`로 배치한다. -- `구현 잠금`이 없거나 잠긴 Milestone에 대해 사용자가 작업, 구현, 계획 작성을 명시하면 현재 요청에 직접 영향을 주는 결정 필요 항목이 남아 있는지 먼저 판단한다. 남은 결정이 없으면 잠금을 유지하더라도 표준선으로 요청한 작업을 이어갈 수 있고, Milestone 전체에 필요한 결정이 모두 정해졌을 때만 상태를 `해제`로 갱신한다. +- `구현 잠금`이 없거나 잠긴 Milestone에 대해 사용자가 작업, 구현, 계획 작성을 명시하면 현재 요청에 직접 영향을 주는 결정 필요 항목이 남아 있는지 먼저 판단한다. 남은 결정이 없으면 잠금을 유지하더라도 표준선으로 요청한 작업을 이어갈 수 있고, Milestone 전체에서 사용자만 결정할 항목이 더 이상 없을 때만 상태를 `해제`로 갱신한다. - 위치 지정이 있으면 anchor의 레벨을 먼저 확인한다. ` 아래`처럼 하위 위치가 명시되면 기존 태스크 하위 항목으로 넣고, ` 앞/뒤`면 같은 목록 레벨의 형제 항목으로 넣는다. - 사용자가 item-id를 언급하면 해당 Milestone의 `필수 기능` 체크리스트에서 정확히 일치하는 item-id를 우선 매칭한다. 중복되거나 없으면 임의로 고르지 말고 확인한다. - 여러 Milestone 후보에서 같은 item-id가 발견되면 item-id만으로 확정하지 말고 Milestone 이름이나 문서 경로를 확인한다. @@ -182,7 +182,7 @@ Milestone은 구현 계획이 아니라 방향성, 범위, 위험, 확인 필요 - [ ] 완료 상태로 바꾸는 경우 사용자의 명시 또는 확인 가능한 evidence가 있는지 확인 - [ ] archive 모드이면 대상 Milestone이 `agent-ops/roadmap/milestones/` 하위에 있고, `ROADMAP.md`에 남길 요약 근거가 있는지 확인 - [ ] 대상 Milestone의 `구현 잠금` 상태와 `결정 필요` 체크리스트를 확인. 섹션이 없거나 잠금 상태에서 작업/구현/계획 작성을 요청받은 경우 현재 요청에 직접 영향을 주는 사용자 결정이 남아 있는지 판단한다. -- [ ] 작업에 필요한 결정이 모두 정해져 있으면 `구현 잠금`을 `해제`로 두고, 결정이 필요하면 `잠금` 상태와 체크리스트를 유지한다. +- [ ] Milestone 전체에서 사용자만 결정할 항목이 더 이상 없으면 `구현 잠금`을 `해제`로 두고, 현재 요청과 직접 관련 없더라도 사용자 결정 항목이 남아 있으면 `잠금` 상태와 체크리스트를 유지한다. ## 실행 절차 @@ -206,7 +206,7 @@ Milestone은 구현 계획이 아니라 방향성, 범위, 위험, 확인 필요 - `ROADMAP.md`와 `current.md`가 표준 템플릿 섹션 순서와 형식을 따르는지 확인한다. - 대상 또는 후보 Milestone 문서의 목표, 범위, 필수 기능, 완료 기준, 범위 제외 항목을 확인한다. - 대상 또는 후보 Milestone 문서의 `구현 잠금` 상태와 `결정 필요` 항목을 확인한다. - - `구현 잠금`이 없거나 잠긴 Milestone에 대한 작업, 구현, 구현 계획 요청이면 현재 요청에 직접 영향을 주는 사용자 결정이 남아 있는지 판단한다. 남은 결정이 없으면 잠금을 유지하더라도 표준선으로 요청한 작업을 이어갈 수 있고, Milestone 전체에 필요한 결정이 모두 정해진 경우에만 `구현 잠금` 상태를 `해제`로 갱신한다. + - `구현 잠금`이 없거나 잠긴 Milestone에 대한 작업, 구현, 구현 계획 요청이면 현재 요청에 직접 영향을 주는 사용자 결정이 남아 있는지 판단한다. 남은 결정이 없으면 잠금을 유지하더라도 표준선으로 요청한 작업을 이어갈 수 있고, Milestone 전체에서 사용자만 결정할 항목이 더 이상 없는 경우에만 `구현 잠금` 상태를 `해제`로 갱신한다. - 대상 Milestone 문서가 표준 템플릿 섹션 순서와 체크리스트 형식을 따르는지 확인한다. - 대상 Milestone 문서의 `필수 기능` item-id 목록을 확인하고, 중복 또는 누락이 갱신 범위에 있으면 보정 대상으로 기록한다. - 신규 작업과 이름, 산출물, 코드 경계, 완료 기준이 겹치는 기존 태스크가 있는지 확인한다. @@ -242,7 +242,7 @@ Milestone은 구현 계획이 아니라 방향성, 범위, 위험, 확인 필요 - `concretize` 모드에서는 구현 세부를 무작정 채우지 말고, 사용자 요청에 필요한 방향/범위 보완, 표준선 기록, 또는 잠금 상태 갱신만 반영한다. - `구현 잠금`을 갱신할 때는 `결정 필요` 항목이 남아 있는지 결과 보고에 남긴다. 이 갱신만으로 `필수 기능`이나 `완료 기준`을 완료 처리하지 않는다. - 새 Milestone은 사용자 지정 또는 자동 판단 위치에 삽입하고, 기존 Milestone 이름이나 파일명을 순서 맞춤 목적으로 바꾸지 않는다. - - 새 Milestone은 사용자만 결정할 수 있는 항목이 있으면 `잠금`, 작업에 필요한 결정이 모두 정해져 있으면 `해제`로 작성한다. + - 새 Milestone은 사용자만 결정할 수 있는 항목이 있으면 `잠금`, Milestone 전체에서 사용자만 결정할 항목이 더 이상 없으면 `해제`로 작성한다. - 기존 Milestone에 새 태스크를 넣는 경우 `필수 기능` 체크리스트에 사용자 지정 또는 자동 판단 위치로 삽입하고, 근거 없이 목록 맨 앞이나 맨 뒤에 붙이지 않는다. - 해제된 Milestone에서 기존 태스크의 하위 작업으로 넣는 경우 부모 태스크 아래의 하위 체크리스트로 작성하고, 부모 태스크의 의미가 바뀌면 부모 문장도 필요한 만큼만 보완한다. - 새로 추가하거나 형식 보정 범위에 포함된 `필수 기능` 항목은 `- [ ] [item-id] 설명` 또는 `- [x] [item-id] 설명` 형식으로 작성한다. @@ -348,7 +348,7 @@ Milestone은 구현 계획이 아니라 방향성, 범위, 위험, 확인 필요 - `구현 잠금`이 없거나 잠긴 Milestone에 대해 현재 요청과 직접 관련된 `결정 필요` 항목을 확인하기 전에 코드 구현, `agent-task` 구현 계획, 세부 API/파일 구조 확정을 시작하지 않는다. - 현재 요청과 직접 관련 없는 미정 항목만 남아 있거나 표준선으로 처리 가능한 작업까지 잠금 상태라는 이유만으로 막지 않는다. - 사용자만 결정할 수 있는 항목이 남아 있는데 Milestone의 `구현 잠금`을 `해제`로 바꾸지 않는다. -- 작업에 필요한 결정이 모두 정해진 Milestone을 관성적으로 `잠금` 상태로 두지 않는다. +- Milestone 전체에서 사용자만 결정할 항목이 더 이상 없는 Milestone을 관성적으로 `잠금` 상태로 두지 않는다. - 초기 Milestone을 구현 계획처럼 자세한 package/file/function 체크리스트로 채우지 않는다. - 사용자가 지정한 앞/뒤/아래 anchor 또는 대상 Phase/Milestone 컨테이너를 무시하지 않는다. - Milestone 목표와 범위 제외 항목을 무시하고 태스크 체크리스트만 갱신하지 않는다.