toki/nomadcode
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
nomadcode/agent-ops/skills/common/analyze-roadmap-position/SKILL.md

11 KiB
Raw Blame History

name version description
analyze-roadmap-position 1.10.0 지금 작업이 뭐지?, 현재 작업 분석, 남은 작업 확인 요청에 대해 로드맵이 있으면 활성 Phase/Milestone과 코드 상태를 함께 읽고, 로드맵이 없으면 git/active task 기준으로 현재 작업 지점과 남은 일을 추정하는 읽기 전용 스킬

작업 지점 분석

목적

현재 브랜치, 변경 파일, 코드 구조를 분석하고, 로드맵이 있으면 활성 Phase와 활성 Milestone 문서를 함께 읽어 지금 작업이 어느 Phase/Milestone에 걸쳐 있는지와 남은 작업 후보를 보고한다. 로드맵이 있으면 결과에는 추정한 Phase와 Milestone의 문서 링크를 함께 출력한다. Phase나 Milestone 후보가 여럿이면 가장 먼저 볼 후보와 다음 후보를 추천하고, 추천 근거를 짧게 남긴다. Milestone의 기능에 Epic/Task id가 있으면 남은 작업과 판단 근거에 함께 표시해 사용자가 짧은 id로 후속 지시를 할 수 있게 한다. current.md만 보고 현재 작업 위치를 단정하지 않고, 실제 코드 상태와 요청 내용을 근거로 판단한다. agent-ops/roadmap/ 디렉터리 또는 current.md가 없으면 로드맵 분석을 건너뛰고 git 상태, active agent-task, 요청 문장을 기준으로만 보고한다.

언제 호출할지

  • 사용자가 "지금 작업이 뭐지?", "현재 작업이 뭐야?", "어디까지 했지?"라고 물을 때
  • 사용자가 현재 브랜치 또는 변경 파일 기준으로 남은 작업을 알고 싶어 할 때
  • 활성 Phase/Milestone 안에서 이번 요청이 어느 범위에 속하는지 확인해야 할 때
  • 구현 전에 로드맵 기준 작업 위치를 가볍게 점검해야 할 때

먼저 확인할 것

  • agent-ops/skills/common/_templates/roadmap-position-report-template.md를 읽어 최신 답변 템플릿 확인
  • agent-ops/roadmap/ 디렉터리 존재 여부 확인
  • agent-ops/roadmap/current.md 존재 여부 확인
  • 로드맵이 있으면 current.md의 활성 Phase와 활성 Milestone 목록이 가리키는 문서 존재 여부 확인
  • 로드맵이 있으면 활성 항목이 agent-ops/roadmap/archive/** 경로를 가리키지 않는지 확인
  • 로드맵이 있으면 활성 Phase/Milestone 이름과 문서 경로를 결과 출력에 쓸 Markdown 링크로 기록
  • git 저장소이면 현재 브랜치, git status --short, 변경 파일 목록 확인
  • 변경 파일이 있으면 agent-ops/rules/project/rules.md의 도메인 매핑 기준으로 관련 domain rule 확인

실행 절차

  1. 활성 창 확인

    • agent-ops/roadmap/ 디렉터리가 없으면 ROADMAP.md, current.md, Phase, Milestone, archive 문서를 읽지 않고 로드맵 없음으로 기록한 뒤 작업 흔적 확인으로 넘어간다. 이 경우 아래 로드맵 읽기 단계는 수행하지 않는다.
    • agent-ops/roadmap/current.md가 없으면 ROADMAP.md를 자동으로 읽지 않는다. 로드맵 컨텍스트는 없음 또는 확인 불가로 기록하고 작업 흔적 확인으로 넘어간다. 이 경우 아래 로드맵 읽기 단계는 수행하지 않는다.
    • agent-ops/roadmap/current.md를 읽고 활성 Phase, 활성 Milestone 후보와 선택 규칙을 파악한다.
    • current.md의 후보가 agent-ops/roadmap/archive/**를 가리키면 해당 문서는 읽지 말고 로드맵 갱신 필요 항목으로 기록한다.
    • 관련 활성 Phase 문서를 읽고 Phase 목표, Milestone 흐름, Phase 경계를 확인한다.
    • 관련 활성 Milestone 문서를 읽고 목표, 상태, 승격 조건, 범위, 기능 Task, 완료 리뷰, 범위 제외, 구현 잠금을 확인한다. 승격 조건은 [스케치]에서만 필수이며, [계획] 이상에서 섹션이 없으면 없음으로 본다.
    • 목록이 많으면 사용자 요청이나 변경 파일과 관련 높은 Phase/Milestone부터 읽는다.
    • current.md 형식이 맞지 않으면 ROADMAP.md를 자동으로 읽지 말고 로드맵 컨텍스트 불확실성을 보고한다.

  2. 작업 흔적 확인

    • git 저장소이면 git branch --show-current, git status --short, git diff --name-only, 필요 시 git diff --stat을 확인한다.
    • 변경 파일이 없으면 사용자의 요청 문장과 최근 대상 경로 힌트를 기준으로 추정한다.
    • 변경 파일이 있으면 관련 코드와 테스트 파일을 필요한 만큼만 읽는다.

  3. Phase/Milestone 매칭

    • 로드맵이 없거나 current.md가 없으면 Phase/Milestone을 추정하지 않는다. 추정 Phase, 추정 Milestone, 문서 링크는 없음으로 기록하고 아래 Phase/Milestone 비교 항목은 수행하지 않는다.
    • 활성 Phase의 목표/경계와 변경 파일/요청 내용을 비교한다.
    • 활성 Milestone의 목표, 범위, 기능 Task, 범위 제외 항목과 변경 파일/요청 내용을 비교한다.
    • Milestone의 기능에서 관련 Epic/Task id가 있으면 판단 근거와 남은 작업에 함께 기록한다.
    • 여러 Milestone 후보에서 같은 epic-id 또는 item-id가 보이면 id만으로 위치를 확정하지 말고 Milestone 이름과 문서 링크를 함께 제시한다.
    • 활성 Milestone의 구현 잠금 섹션, 상태, 완료 리뷰 섹션, 결정 필요 항목을 함께 확인한다.
    • 하나의 Milestone에 명확히 속하면 단일 후보로 보고한다.
    • 둘 이상의 Phase 또는 Milestone에 걸치면 복수 후보로 보고하고, 어떤 파일이나 기능이 어느 후보에 닿는지 나눈다.
    • 복수 후보일 때는 후보 우선순위를 추천한다. 요청 문장/변경 파일 직접성, 현재 diff 근거, Milestone 상태, 구현 잠금, 선후 의존성, Phase/Milestone 흐름상 위치를 함께 본다.
    • 관련성이 비슷하면 [검토중] 후보는 리뷰/승인 요청에서 우선하고, 구현 작업 요청에서는 [진행중] 후보를 [계획] 후보보다 우선한다. [스케치] 후보는 구현 작업보다 컨셉 보강/계획 승격 요청에서 우선한다. 같은 상태라면 현재 변경 파일을 더 많이 설명하는 후보를 우선한다.
    • 사용자가 특정 Phase, Milestone, epic-id, item-id, 파일 경로를 명시했으면 그 후보를 우선하되, 범위 제외나 잠금 결정 필요가 있으면 우선순위 근거에 같이 적는다.
    • 로드맵이 있고 활성 Phase/Milestone 밖으로 보이면 ROADMAP.md의 Phase 흐름을 확인하고 전환 또는 신규 Phase/Milestone 필요성을 제안한다.

  4. 남은 작업 분류

    • 확인됨: 코드, 문서, 테스트, diff로 근거가 있는 남은 작업
    • 추정됨: 구조상 필요해 보이지만 추가 확인이 필요한 작업
    • 확인 필요: 현재 요청에 직접 영향을 주는 제품 판단, 범위 결정, 사용자 의도가 필요한 작업
    • 완료 여부는 evidence 없이 확정하지 않는다.

  5. 결과 보고

    • agent-ops/skills/common/_templates/roadmap-position-report-template.md를 기준으로 출력한다.
    • 템플릿의 섹션 제목, 필드명, 순서를 바꾸지 않는다.
    • 템플릿의 모든 필드를 채우며, 근거가 없으면 생략하지 말고 없음, 확인 불가, 확인 필요 중 하나로 명시한다.
    • 판단 근거에는 브랜치, 변경 파일, 로드맵 근거, 코드/테스트 근거를 각각 분리해 적는다.
    • 후보 우선순위에는 복수 후보일 때 1순위와 2순위를 적고, 단일 후보이면 단일 후보라고 적는다.
    • 남은 작업은 확인됨, 추정됨, 확인 필요 세 분류를 모두 유지한다.
    • 다음 행동에는 가장 우선해야 할 실행 또는 확인을 1~2개만 적는다.
    • 읽은 주요 파일에는 실제로 읽은 핵심 파일만 적는다.

실행 결과 검증

  • roadmap-position-report-template.md를 읽고 그 섹션 순서와 필드명을 유지했는가
  • 로드맵이 없는 프로젝트에서 ROADMAP.md, current.md, Phase, Milestone 문서를 읽으려 하지 않았는가
  • 로드맵이 있는 프로젝트에서 current.md만 근거로 현재 위치를 단정하지 않았는가
  • 로드맵이 있는 프로젝트에서 활성 Phase 문서의 목표와 Phase 경계를 확인했는가
  • 로드맵이 있는 프로젝트에서 활성 Milestone 문서의 목표와 범위 제외 항목을 확인했는가
  • 로드맵이 있는 프로젝트에서 [스케치] Phase/Milestone의 승격 조건과 구현 계획 금지 여부를 확인했는가
  • [계획] 이상 Milestone에 승격 조건 섹션이 없어도 템플릿 문제로 보고하지 않았는가
  • 로드맵이 있는 프로젝트에서 활성 Milestone 문서의 완료 리뷰 섹션과 [검토중] 상태 여부를 확인했는가
  • agent-ops/roadmap/archive/** 문서를 명시 요청 없이 읽지 않았는가
  • 로드맵이 있는 프로젝트에서 활성 Milestone 문서의 구현 잠금 섹션 존재 여부, 상태, 결정 필요 항목을 확인했는가
  • 로드맵이 있는 프로젝트에서 추정 Phase/Milestone마다 문서 링크를 출력했는가
  • 로드맵이 있는 프로젝트에서 Phase/Milestone 후보가 여럿이면 1순위와 2순위 추천 및 근거를 출력했는가
  • 로드맵이 있는 프로젝트에서 관련 Epic/Task id가 있으면 결과에 함께 표시했는가
  • 변경 파일 또는 사용자 요청과 Phase/Milestone 판단 근거가 연결되어 있는가
  • 남은 작업을 확인됨, 추정됨, 확인 필요로 구분했는가
  • 템플릿 필드를 근거 없이 생략하지 않고 없음, 확인 불가, 확인 필요로 채웠는가
  • 로드맵 파일을 수정하지 않았는가

출력 형식

  • 템플릿 경로: agent-ops/skills/common/_templates/roadmap-position-report-template.md
  • 템플릿을 그대로 복사해 placeholder를 채운다.
  • 섹션 제목과 필드명을 임의로 번역, 축약, 삭제하지 않는다.
  • 값이 없는 필드는 없음, 확인 불가, 확인 필요 중 하나로 채운다.
  • 로드맵이 없는 프로젝트에서는 추정 Phase, 추정 Milestone, Phase 링크, Milestone 링크, 로드맵 근거를 없음으로 채운다.

금지 사항

  • current.md만 읽고 현재 작업 위치를 확정하지 않는다.
  • 로드맵이 없는 프로젝트에서 로드맵 파일을 만들거나 읽는 것을 현재 작업 분석의 선행 조건으로 삼지 않는다.
  • 사용자가 명시하지 않은 상태에서 ROADMAP.md, current.md, Phase, Milestone 문서를 수정하지 않는다.
  • 사용자가 명시하지 않은 상태에서 agent-ops/roadmap/archive/**를 읽지 않는다.
  • evidence 없이 Phase, Milestone, Epic, Task를 [완료] 또는 [검토중]으로 처리하지 않는다.
  • 활성 Phase/Milestone 밖 작업을 임의로 새 항목으로 추가하지 않는다.