Table of Contents

빠른 시작 가이드

이 가이드는 Spec Mix를 사용하여 사양 주도 개발을 시작하는 데 도움이 됩니다.

새로운 기능: 모든 자동화 스크립트는 이제 Bash(.sh)와 PowerShell(.ps1) 버전을 모두 제공합니다. spec-mix CLI는 --script sh|ps를 전달하지 않는 한 OS를 기반으로 자동 선택합니다.

4단계 프로세스

1. Spec Mix 설치

사용 중인 코딩 에이전트에 따라 프로젝트를 초기화하세요:

uvx --from git+https://github.com/dan1901/spec-mix.git spec-mix init <PROJECT_NAME>

스크립트 유형을 명시적으로 선택 (선택 사항):

uvx --from git+https://github.com/dan1901/spec-mix.git spec-mix init <PROJECT_NAME> --script ps  # PowerShell 강제
uvx --from git+https://github.com/dan1901/spec-mix.git spec-mix init <PROJECT_NAME> --script sh  # POSIX shell 강제

2. 사양 생성

/spec-mix.specify 명령을 사용하여 구축하려는 것을 설명하세요. 기술 스택이 아닌 무엇을과 왜에 집중하세요.

/spec-mix.specify 사진을 별도의 사진 앨범으로 정리하는 데 도움이 되는 애플리케이션을 만들어주세요. 앨범은 날짜별로 그룹화되며 메인 페이지에서 드래그 앤 드롭으로 재정리할 수 있습니다. 앨범은 다른 중첩된 앨범에 있지 않습니다. 각 앨범 내에서 사진은 타일 형태의 인터페이스로 미리보기됩니다.

3. 기술 구현 계획 생성

/spec-mix.plan 명령을 사용하여 기술 스택과 아키텍처 선택을 제공하세요.

/spec-mix.plan 애플리케이션은 최소한의 라이브러리로 Vite를 사용합니다. 가능한 한 바닐라 HTML, CSS, JavaScript를 많이 사용하세요. 이미지는 어디에도 업로드되지 않으며 메타데이터는 로컬 SQLite 데이터베이스에 저장됩니다.

4. 분해 및 구현

/spec-mix.tasks를 사용하여 실행 가능한 작업 목록을 만든 다음 에이전트에게 기능을 구현하도록 요청하세요.

상세 예제: Taskify 구축

팀 생산성 플랫폼을 구축하는 완전한 예제입니다:

1단계: /spec-mix.specify로 요구사항 정의

팀 생산성 플랫폼인 Taskify를 개발하세요. 사용자가 프로젝트를 생성하고, 팀 멤버를 추가하고,
작업을 할당하고, 칸반 스타일로 보드 간에 작업을 댓글로 달고 이동할 수 있어야 합니다. 이 기능의 초기 단계에서,
"Taskify 생성"이라고 부르겠습니다. 여러 사용자가 있지만 사용자는 미리 선언되고 사전 정의됩니다.
두 가지 범주에 다섯 명의 사용자를 원합니다. 한 명의 제품 관리자와 네 명의 엔지니어입니다. 세 개의
다른 샘플 프로젝트를 만들겠습니다. 각 작업의 상태에 대한 표준 칸반 열이 있습니다. "할 일",
"진행 중", "검토 중", "완료"와 같습니다. 이 애플리케이션에는 로그인이 없습니다. 기본 기능이 설정되어 있는지
확인하기 위한 첫 번째 테스트일 뿐이기 때문입니다. 작업 카드의 UI에서 각 작업에 대해
칸반 작업 보드의 다른 열 사이에서 작업의 현재 상태를 변경할 수 있어야 합니다.
특정 카드에 무제한의 댓글을 남길 수 있어야 합니다. 해당 작업 카드에서
유효한 사용자 중 한 명을 할당할 수 있어야 합니다. Taskify를 처음 시작하면 선택할 다섯 명의 사용자 목록이 표시됩니다.
비밀번호는 필요하지 않습니다. 사용자를 클릭하면 프로젝트 목록을 표시하는 메인 뷰로 이동합니다.
프로젝트를 클릭하면 해당 프로젝트의 칸반 보드가 열립니다. 열이 표시됩니다.
다른 열 사이에서 카드를 앞뒤로 드래그 앤 드롭할 수 있습니다. 현재 로그인한 사용자인 당신에게
할당된 카드를 다른 모든 카드와 다른 색상으로 볼 수 있으므로 빠르게 당신의 카드를
확인할 수 있습니다. 자신이 만든 댓글은 편집할 수 있지만 다른 사람이 만든 댓글은 편집할 수 없습니다.
자신이 만든 댓글은 삭제할 수 있지만 다른 사람이 만든 댓글은 삭제할 수 없습니다.

2단계: 사양 개선

초기 사양이 생성된 후 누락된 요구사항을 명확히 하세요:

생성하는 각 샘플 프로젝트 또는 프로젝트에 대해 완료의 다른 상태로 무작위로 분산된 5개에서 15개 사이의
가변 개수의 작업이 있어야 합니다. 완료의 각 단계에 최소한 하나의 작업이 있는지 확인하세요.

또한 사양 체크리스트를 검증하세요:

검토 및 승인 체크리스트를 읽고 기능 사양이 기준을 충족하면 체크리스트의 각 항목을 체크하세요. 그렇지 않으면 비워두세요.

3단계: /spec-mix.plan으로 기술 계획 생성

기술 스택과 기술 요구사항에 대해 구체적으로 설명하세요:

Postgres를 데이터베이스로 사용하여 .NET Aspire를 사용하여 생성할 것입니다. 프론트엔드는
드래그 앤 드롭 작업 보드, 실시간 업데이트와 함께 Blazor 서버를 사용해야 합니다. 프로젝트 API,
작업 API 및 알림 API로 생성된 REST API가 있어야 합니다.

4단계: 검증 및 구현

AI 에이전트에게 구현 계획을 감사하도록 하세요:

이제 구현 계획과 구현 세부 파일을 감사하기를 원합니다.
이를 읽으면서 수행해야 하는 명확한 작업 순서가 있는지 판단하는 눈으로 읽어주세요.
여기에 충분한 내용이 있는지 모르겠습니다.

마지막으로 솔루션을 구현하세요:

implement specs/002-create-taskify/plan.md

제품 전략 예제: 6-Pager

전략 기획 및 제품 문서에는 product-strategy 미션을 사용하세요:

1단계: 제품 전략 미션으로 초기화

spec-mix init my-product --mission product-strategy --ai claude
cd my-product

2단계: /spec-mix.specify로 6-Pager 생성

/spec-mix.specify 자동 예산 분류 및 저축 추천 기능이 있는 밀레니얼 대상 AI 기반 개인 금융 앱

AI가 다음을 수행합니다:

  1. 제품 비전에 대한 명확화 질문
  2. 시장 데이터, 경쟁사, 트렌드에 대한 자동 웹 검색
  3. 출처가 인용된 14개 섹션의 6-Pager 문서 생성

3단계: /spec-mix.analyze로 심층 분석

# 전체 분석
/spec-mix.analyze

# 또는 특정 영역
/spec-mix.analyze market
/spec-mix.analyze competitor
/spec-mix.analyze customer

4단계: 피드백 기반 개선

/spec-mix.refine CFO가 CAC 상세 분석과 LTV 계산을 요청함

5단계: 리뷰 준비

/spec-mix.review stakeholder

자세한 6-Pager 사용법은 6-Pager 가이드를 참조하세요.

주요 원칙

  • 구축하려는 것과 이유에 대해 명확하게 설명하세요
  • 사양 단계에서 기술 스택에 집중하지 마세요
  • 구현 전에 사양을 반복하고 개선하세요
  • 코딩을 시작하기 전에 계획을 검증하세요
  • AI 에이전트가 구현 세부사항을 처리하도록 하세요

다음 단계

Edit this page