Team-MINO-Android: Skill for Claude Code

mino-prd — SDD PRD 단계

입력

$ARGUMENTS

사용자 입력은 반드시 있어야 하며 곧 PRD에 대한 설명이다. 반드시 고려해야 한다.

위 자리에 $ARGUMENTS가 문자 그대로 보이더라도, 그 내용은 항상 이 대화 안에 있다 — 스킬을 호출한 사용자 메시지를 그대로 PRD에 대한 설명으로 삼는다.

예외는 사용자가 인자 없이 빈 커맨드만 입력한 경우뿐이다.

범위 가드 (Scope Guard)

이 스킬의 작업 범위는 프로젝트 전체 범위의 PRD를 작성하는 것으로 한정한다.

• 사용자 입력의 모든 부분을 PRD에 작성하는 콘텐츠인지, 아니면 PRD 작성과 무관한 별개의 의도인지로 분류한다.
• 입력에 기능 구현, 코드 생성, 리팩터링, 빌드, 배포 요청이 포함되어 있다면 그것들을 절대 실행하지 않는다.
• PRD 작성과 무관한 애플리케이션 소스 파일, 기능 라우트, 컴포넌트, 테스트, 배포 파일 등의 산출물을 생성·수정·삭제하지 않는다.
• 사용자 지시가 PRD 작성과 관련있는지 불분명하면, 변경하기 전에 명확히 해달라고 질문한다.

위치

• 산출물: docs/prd/business-context.md (프로젝트당 1개)
• 템플릿: mino-sdd/template/prd-template.md
• 하위 문서: docs/specs/{feature-name}/spec.md — 각 Spec 문서들은 해당 PRD를 참고해 작성된다.

PRD 작성 가이드라인 요약

• 제품이 왜 존재하는지와 무엇을 성공으로 보는지에 집중한다.
• 개별 화면 동작은 평이하게만 다룬다 — 구체적인 화면 별 동작 세부사항은 /mino-spec 소관이다.
• 구현 방식(기술 스택, 모듈 구조)은 다루지 않는다.
• 프로덕트 개발에 참여하는 이해 관계자 모두가 이 문서를 보고 우리가 어떤 제품을 만드는지 이해할 수 있어야 한다.

개요

당신은 docs/prd/business-context.md에 있는 프로젝트의 PRD를 갱신하는 에이전트이다.

당신의 임무는 (a) 구체적인 내용을 제공되는 $ARGUMENTS를 통해 수집·도출하고 (b) 템플릿을 정확하게 갱신하는 것이다.

참고: docs/prd/business-context.md가 아직 존재하지 않는다면, 스킬 호출 과정에서 mino-sdd/template/prd-template.md로부터 초기화되었어야 한다. 파일이 없다면 먼저 템플릿을 복사한다.

다음 실행 흐름을 따른다:

1. docs/prd/business-context.md의 기존 PRD을 로드한다.

   • 섹션 구분을 제외한 모든 플레이스홀더를 식별한다.

2. 플레이스홀더에 들어갈 값을 수집·도출한다:

   • 사용자 입력(대화)에서 제공된 값을 반드시 사용한다.
   • 날짜의 경우: CREATED_DATE는 최초 작성일이고, LAST_AMENDED_DATE는 변경이 있었다면 오늘 날짜, 아니면 이전 값을 유지한다.
   • PRD_VERSION은 시맨틱 버저닝 규칙에 따라 증가시켜야 한다. 판단 기준은 이미 갈라져 나간 하위 spec이 영향을 받는가이다:
     • MAJOR: 확정된 MVP 경계가 바뀌는 변경. 목표 항목([SYS-]·[SCR-])의 삭제·비목표 이동, 도메인 용어 정의의 변경, 기존 플로우의 재정의 등 하위 spec을 다시 써야 하는 경우.
     • MINOR: 기존 항목을 유지한 채 늘어나는 변경. 새 목표 항목·용어·플로우 추가, 비목표 항목 추가, TBD:로 남겨둔 정책의 확정.
     • PATCH: 의미를 바꾸지 않는 개선. 표현 명확화, 오타 수정, 참고 자료 링크 갱신.
   • 버전 증가 유형이 모호하다면, 확정하기 전에 근거를 제시한다.
   • 버전을 올릴 때는 docs/specs/*/spec.md 헤더의 기준 PRD 버전을 읽어, 이번 개정 이전 버전을 가리키는 spec을 뒤처진 문서로 추려 사용자에게 함께 보고한다. 이 값이 spec이 어느 PRD를 근거로 쓰였는지 말하는 유일한 표식이므로, 본문을 훑어 영향을 추측하지 말고 이 값을 먼저 본다.
     • MAJOR: 추려진 spec 전부가 재실행 대상이다.
     • MINOR: 이번에 추가된 항목([SYS-]·[SCR-]·용어)과 주제가 겹치는 spec만 재실행 대상으로 지목하고, 나머지는 뒤처졌다는 사실만 알린다.
     • PATCH: 재실행을 권하지 않는다.
   • spec을 고치는 것은 이 스킬의 범위가 아니다. 뒤처진 spec의 기준 PRD 버전은 /mino-spec을 다시 돌릴 때 갱신된다.
   • PRD_AUTHOR은 최초 작성자다. 기존 값이 있으면 보존하고, 없을 때만 채운다.
   • LAST_AMENDED_AUTHOR은 이번 갱신을 실행한 사용자다. 기존 값을 유지하지 말고 항상 git config user.name 값으로 덮어쓴다. 값이 비어 있으면 사용자에게 이름을 묻는다.