Communitygithub.com

jintomjose/미니-소프트웨어-팩토리

커밋된 intent.md를 spec.md(요구사항과 설계를 하나의 아티팩트로 통합)로 변환하며, 정책 문제와 미결정 사항을 인라인으로 표시합니다. capture-intent 이후, plan 모드 이전에 사용합니다.

미니-소프트웨어-팩토리란 무엇인가요?

이 스킬은 'intent.md' 파일을 상세한 'spec.md' 파일로 변환하는 정형화된 프로세스를 제공하여, 소프트웨어 개발에서 요구사항 명세 단계를 간소화합니다. 기존 코드베이스의 제약 조건을 고려하지 않아서 발생하는 일반적인 실수를 방지하기 위해, 'intent.md', 'CLAUDE.md', 그리고 변경이 영향을 미칠 코드베이스 부분을 먼저 읽도록 안내합니다. 이 스킬의 핵심은 우선순위(P1, P2, P3)가 지정된 사용자 스토리 작성, 안정적인 ID(FR-001, SC-001)를 사용한 기능 요구사항 및 성공 기준 정의, 그리고 'NEEDS CLARIFICATION' 및 'POLICY' 태그를 통해 미해결 결정과 정책 문제를 인라인으로 명시적으로 표시하는 데 있습니다. 설계 섹션은 계획 수립에 필요한 최소 수준으로 간결하게 유지하고, 명시적으로 범위를 벗어난 항목을 나열합니다. 모든 모호함을 해결한 후 최종 'spec.md'를 저장하면, 이것이 plan 모드 실행의 트리거가 됩니다. 이 스킬은 Claude Code, Cursor, Codex와 같은 AI 기반 코딩 도구와 함께 사용하도록 설계되었으며, 초기 의도 포착과 상세 계획 수립 사이의 격차를 해소하여 구조화된 요구사항 공학 워크플로를 보장합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jintomjose/mini-software-factory/tree/HEAD/.claude/skills/write-spec

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

명세서 작성

입력: work/<feature>/intent.md. 출력: work/<feature>/spec.md (factory/templates/spec.md 기반).

  1. intent.md, CLAUDE.md 및 변경이 영향을 미칠 코드베이스 부분을 읽습니다. 코드를 읽지 않고 작성된 명세는 제약 조건을 놓치기 마련이며, 이것이 가장 흔한 실패 원인입니다.
  2. 우선순위(P1, P2, P3) 순서로 사용자 스토리를 작성합니다. 각 P1 스토리는 독립적으로 출시 가능하고 테스트 가능해야 합니다.
  3. 모든 기능 요구사항에 안정적인 ID(FR-001)를 부여하고, 모든 성공 기준에도 안정적인 ID(SC-001)를 부여합니다. 리뷰와 테스트는 이 ID를 참조합니다.
  4. 절대 조용히 해결하지 말고, 인라인으로 표시합니다:
    • [NEEDS CLARIFICATION: ...] : 의도가 결정하지 못한 모든 결정 사항
    • [POLICY: privacy | security | legal | money | brand] : 규칙이 적용되는 모든 곳에 해당 규칙과 함께 표시
  5. 설계 섹션은 계획에 필요한 만큼만 깊게 작성합니다: 데이터 변경, 인터페이스, 상태, 오류 사례.
  6. 명시적으로 범위 밖인 항목을 나열합니다.
  7. 명세서를 보여주고, 모든 [NEEDS CLARIFICATION]을 사람과 함께 해결한 후 저장합니다. spec.md를 커밋하는 것이 plan 모드의 트리거입니다.

관련 스킬