Team-MINO-Android: Skill for Claude Code

mino-analyze — SDD Analyze 단계

입력

$ARGUMENTS

진행하기 전에 사용자 입력을 반드시 고려해야 한다(비어 있지 않은 경우).

위 자리에 $ARGUMENTS가 문자 그대로 보이더라도, 그 내용은 항상 이 대화 안에 있다 — 스킬을 호출한 사용자 메시지를 그대로 대상 지목으로 삼는다. 인자가 없으면 docs/specs/ 하위 디렉터리 목록을 제시해 대상을 고르게 한다(AskUserQuestion).

목표(Goal)

구현 전에 세 가지 핵심 산출물(spec.md, plan.md, tasks.md) 전반의 불일치, 중복, 모호성, 명세 부족 항목을 식별한다.

본문 대조에 앞서 문서 간 버전 체인을 먼저 확인하고, 하위 문서가 크게 뒤처져 있으면 거기서 멈춘다. 옛 버전을 근거로 쓰인 문서를 최신 문서와 맞대 봐야 나오는 것은 재실행하면 사라질 허수이기 때문이다.

이 스킬은 /mino-task가 완전한 tasks.md를 성공적으로 생성한 이후에만 실행해야 한다.

동작 제약(Operating Constraints)

엄격한 읽기 전용: 어떤 파일도 수정해서는 안 된다. 구조화된 분석 보고서를 출력한다. 선택적 개선 계획을 제안할 수 있다(후속 편집 커맨드를 수동으로 호출하기 전에 사용자가 명시적으로 승인해야 한다).

헌법의 권위: 프로젝트 헌법(docs/constitution.md)은 이 분석 범위 안에서 타협 불가하다. 헌법 충돌은 자동으로 CRITICAL이며, 원칙을 희석하거나 재해석하거나 조용히 무시하는 것이 아니라 spec, plan, tasks를 조정해야 한다. 원칙 자체를 바꿔야 한다면, 그것은 /mino-analyze 밖에서 별도의 명시적인 헌법 갱신으로 이루어져야 한다.

실행 단계(Execution Steps)

1. 분석 컨텍스트 초기화

아래 세 가지 핵심 산출물을 반드시 얻는다.

• SPEC = {SPEC_DIR}/spec.md
• PLAN = {SPEC_DIR}/plan.md
• TASKS = {SPEC_DIR}/tasks.md

필수 산출물이 하나라도 없으면 오류 메시지와 함께 중단한다(누락된 선행 커맨드를 실행하도록 사용자에게 안내한다).

버전 대조에만 쓰는 선택 산출물도 확인한다(없으면 없는 대로 진행한다. 헤더만 읽는다).

• PRD = docs/prd/business-context.md
• CHECKLIST = {SPEC_DIR}/quality/spec-checklist.md

2. 버전 체인 대조

각 문서의 헤더만 읽어 상위 문서의 버전과 하위 문서가 적어 둔 기준 버전을 맞춰 본다. 본문 대조에 들어가기 전에 먼저 수행한다 — 하위 문서가 뒤처져 있으면 이후 단계에서 나오는 불일치 상당수가 "잘못 쓴 것"이 아니라 "옛 버전을 근거로 쓴 것"이고, 처방이 달라지기 때문이다.

대조할 짝(상위 문서 버전 → 하위 문서의 기준 버전 필드):

상위	하위	하위의 필드
docs/prd/business-context.md 버전	spec.md	기준 PRD 버전 (PRD가 없는 프로젝트면 없음이 정상)
spec.md 버전	plan.md	기준 spec 버전
plan.md 버전	tasks.md	기준 plan 버전
spec.md 버전	{SPEC_DIR}/quality/spec-checklist.md	대상 스펙의 버전 (파일이 있는 경우)

research.md·data-model.md·contracts/·quickstart.md는 독자 버전을 갖지 않는 plan.md 부속 문서이므로 대조 대상이 아니다.

PRD 행은 보고하되 게이트로 삼지 않는다. PRD는 프로젝트 전체 범위라 다른 feature의 개정으로도 버전이 오르고, 그 개정이 이 feature와 관련 있는지는 버전 숫자만으로 판정할 수 없다. 등급은 갭 크기와 무관하게 LOW 고정이며, 처방은 "이 개정이 이 feature와 관련 있는지 확인하려면 /mino-spec 재실행" 한 줄이다. spec 헤더의 기준 PRD 버전은 /mino-spec이 실행할 때마다 갱신하므로, 이 값이 뒤처졌다는 것은 내용이 어긋난다는 뜻이 아니라 PRD 개정 후 /mino-spec을 돌린 적이 없다는 뜻이다.