사용자 입력
$ARGUMENTS
진행하기 전에 사용자 입력을 반드시 고려해야 합니다 (비어 있지 않은 경우).
실행 전 검사
작업 생성 전 확장 후크 확인:
- 프로젝트 루트에
.specify/extensions.yml파일이 있는지 확인합니다. - 파일이 있으면 읽고
hooks.before_tasks키 아래의 항목을 찾습니다. - YAML을 구문 분석할 수 없거나 유효하지 않은 경우, 조용히 넘어가지 말고 사용자에게
.specify/extensions.yml파일을 읽을 수 없다고 알리고(파서 오류 포함) 해당 파일에 등록된 필수(optional: false) 후크를 포함한 모든 후크가 확인되지 않았음을 알린 후 정상적으로 계속 진행합니다. enabled가 명시적으로false인 후크는 필터링합니다.enabled필드가 없는 후크는 기본적으로 활성화된 것으로 간주합니다.- 나머지 각 후크에 대해 후크
condition표현식을 해석하거나 평가하려고 시도하지 마십시오:- 후크에
condition필드가 없거나 null/비어 있으면 후크를 실행 가능한 것으로 간주합니다. - 후크에 비어 있지 않은
condition이 정의되어 있으면 후크를 건너뛰고 조건 평가를 HookExecutor 구현에 맡깁니다.
- 후크에
- 후크 명령 이름으로 명령 호출을 구성할 때는 점(
.)을 하이픈(-)으로 바꿉니다. 예:speckit.git.commit→/speckit-git-commit. - 실행 가능한 각 후크에 대해
optional플래그에 따라 다음을 출력합니다:- 선택적 후크(
optional: true):## 확장 후크 **선택적 사전 후크**: {ext} 명령: `/{command}` 설명: {description} 프롬프트: {prompt} 실행하려면: `/{command}` - 필수 후크(
optional: false):
위 블록을 출력한 후에는 반드시 실제로 후크를 호출하고 완료될 때까지 기다려야 합니다. 이 세션/에이전트에서 직접 명령을 실행하는 것과 동일한 방식으로 실행하십시오(호출 방식은 위에 표시된 리터럴## 확장 후크 **자동 사전 후크**: {ext} 실행 중: `/{command}` EXECUTE_COMMAND: {command} 개요로 진행하기 전에 후크 명령의 결과를 기다리십시오.{command}ID와 다를 수 있습니다. 예를 들어 스킬 모드 에이전트는/skill:speckit-...또는$speckit-...로 실행합니다). 블록만 출력하는 것으로는 후크가 실행되지 않습니다.
- 선택적 후크(
- 등록된 후크가 없거나
.specify/extensions.yml이 존재하지 않으면 조용히 건너뜁니다.
개요
-
설정: 리포지토리 루트에서
.specify/scripts/bash/setup-tasks.sh --json을 실행하고 FEATURE_DIR, TASKS_TEMPLATE_CONTENT, TASKS_TEMPLATE 및 AVAILABLE_DOCS 목록을 구문 분석합니다.FEATURE_DIR과TASKS_TEMPLATE는 제공될 때 절대 경로여야 합니다.AVAILABLE_DOCS는FEATURE_DIR아래에 있는 문서 이름/상대 경로 목록입니다(예:research.md또는contracts/). "I'm Groot"와 같은 인수에 작은따옴표가 있는 경우 이스케이프 구문을 사용하십시오. 예: 'I'''m Groot' (또는 가능하면 큰따옴표 사용: "I'm Groot"). -
디자인 문서 로드: FEATURE_DIR에서 읽기:
- 필수: plan.md(기술 스택, 라이브러리, 구조), spec.md(우선순위가 있는 사용자 스토리)
- 선택 사항: data-model.md(엔티티), contracts/(인터페이스 계약), research.md(결정 사항), quickstart.md(테스트 시나리오)
- 존재하는 경우:
.specify/memory/constitution.md를 로드하여 프로젝트 원칙 및 거버넌스 제약 조건 확인 - 참고: 모든 프로젝트에 모든 문서가 있는 것은 아닙니다. 사용 가능한 것을 기반으로 작업을 생성하십시오.
-
작업 생성 워크플로우 실행:
- plan.md를 로드하고 기술 스택, 라이브러리, 프로젝트 구조 추출
- spec.md를 로드하고 우선순위(P1, P2, P3 등)와 함께 사용자 스토리 추출
- data-model.md가 있으면: 엔티티를 추출하고 사용자 스토리에 매핑
- contracts/가 있으면: 인터페이스 계약을 사용자 스토리에 매핑
- research.md가 있으면: 설정 작업에 대한 결정 사항 추출
- 사용자 스토리별로 구성된 작업 생성(아래 작업 생성 규칙 참조)
- 사용자 스토리 완료 순서를 보여주는 종속성 그래프 생성
- 사용자 스토리별 병렬 실행 예제 생성
- 작업 완전성 검증(각 사용자 스토리에 필요한 모든 작업이 있고 독립적으로 테스트 가능한지 확인)
-
tasks.md 생성: 위 JSON 출력의 TASKS_TEMPLATE_CONTENT를 구조로 사용합니다. TASKS_TEMPLATE_CONTENT를 생략하는 이전 버전의 설정 스크립트와의 호환성을 위해 대신 TASKS_TEMPLATE를 읽습니다. 다음으로 채웁니다:
- plan.md의 올바른 기능 이름
- 1단계: 설정 작업(프로젝트 초기화)
- 2단계: 기본 작업(모든 사용자 스토리의 차단 전제 조건)
- 3단계+: 사용자 스토리당 하나의 단계(spec.md의 우선순위 순서)
- 각 단계에는 다음이 포함됩니다: 스토리 목표, 독립적 테스트 기준, 테스트(요청된 경우), 구현 작업
- 최종 단계: 마무리 및 교차 관심사
- 모든 작업은 엄격한 체크리스트 형식을 따라야 합니다(아래 작업 생성 규칙 참조)
- 각 작업에 대한 명확한 파일 경로
- 스토리 완료 순서를 보여주는 종속성 섹션
- 스토리별 병렬 실행 예제
- 구현 전략 섹션(MVP 우선, 점진적 전달)
필수 사후 실행 후크
완료를 사용자에게 보고하기 전에 이 섹션을 반드시 완료해야 합니다.
프로젝트 루트에 .specify/extensions.yml 파일이 있는지 확인합니다.
- 파일이 없거나
hooks.after_tasks키 아래에 등록된 후크가 없으면 완료 보고서로 건너뜁니다. - 파일이 있으면 읽고
hooks.after_tasks키 아래의 항목을 찾습니다. - YAML을 구문 분석할 수 없거나 유효하지 않은 경우, 조용히 넘어가지 말고 사용자에게
.specify/extensions.yml파일을 읽을 수 없다고 알리고(파서 오류 포함) 해당 파일에 등록된 필수(optional: false) 후크를 포함한 모든 후크가 확인되지 않았음을 알린 후 완료 보고서로 계속 진행합니다. enabled가 명시적으로false인 후크는 필터링합니다.enabled필드가 없는 후크는 기본적으로 활성화된 것으로 간주합니다.- 나머지 각 후크에 대해 후크
condition표현식을 해석하거나 평가하려고 시도하지 마십시오:- 후크에
condition필드가 없거나 null/비어 있으면 후크를 실행 가능한 것으로 간주합니다. - 후크에 비어 있지 않은
condition이 정의되어 있으면 후크를 건너뛰고 조건 평가를 HookExecutor 구현에 맡깁니다.
- 후크에
- 후크 명령 이름으로 명령 호출을 구성할 때는 점(
.)을 하이픈(-)으로 바꿉니다. 예:speckit.git.commit→/speckit-git-commit. - 실행 가능한 각 후크에 대해
optional플래그에 따라 다음을 출력합니다:- 필수 후크(
optional: false) — 각 필수 후크에 대해EXECUTE_COMMAND:를 반드시 출력해야 합니다:
위 블록을 출력한 후에는 반드시 실제로 후크를 호출하고 완료될 때까지 기다려야 합니다. 이 세션/에이전트에서 직접 명령을 실행하는 것과 동일한 방식으로 실행하십시오(호출 방식은 위에 표시된 리터럴## 확장 후크 **자동 후크**: {ext} 실행 중: `/{command}` EXECUTE_COMMAND: {command}{command}ID와 다를 수 있습니다. 예를 들어 스킬 모드 에이전트는/skill:speckit-...또는$speckit-...로 실행합니다). 블록만 출력하는 것으로는 후크가 실행되지 않습니다. - 선택적 후크(
optional: true):## 확장 후크 **선택적 후크**: {ext} 명령: `/{command}` 설명: {description} 프롬프트: {prompt} 실행하려면: `/{command}`
- 필수 후크(
완료 보고서
생성된 tasks.md의 경로와 요약을 출력합니다:
- 총 작업 수
- 사용자 스토리별 작업 수
- 식별된 병렬 실행 기회
- 각 스토리에 대한 독립적 테스트 기준
- 제안된 MVP 범위(일반적으로 사용자 스토리 1만)
- 형식 검증: 모든 작업이 체크리스트 형식(체크박스, ID, 레이블, 파일 경로)을 따르는지 확인
작업 생성 컨텍스트: $ARGUMENTS
tasks.md는 즉시 실행 가능해야 합니다. 각 작업은 LLM이 추가 컨텍스트 없이 완료할 수 있을 만큼 구체적이어야 합니다.
작업 생성 규칙
중요: 작업은 독립적인 구현 및 테스트를 가능하게 하기 위해 반드시 사용자 스토리별로 구성되어야 합니다.
테스트는 선택 사항입니다: 기능 사양에서 명시적으로 요청하거나 사용자가 TDD 접근 방식을 요청하는 경우에만 테스트 작업을 생성하십시오.
체크리스트 형식 (필수)
모든 작업은 반드시 다음 형식을 엄격히 따라야 합니다:
- [ ] [TaskID] [P?] [Story?] 설명 및 파일 경로
형식 구성 요소:
- 체크박스: 항상
- [ ](마크다운 체크박스)로 시작 - 작업 ID: 실행 순서에 따른 일련 번호(T001, T002, T003...)
- [P] 표시: 작업이 병렬화 가능한 경우에만 포함(다른 파일, 완료되지 않은 작업에 대한 종속성 없음)
- [Story] 레이블: 사용자 스토리 단계 작업에만 필수
- 형식: [US1], [US2], [US3] 등 (spec.md의 사용자 스토리 매핑)
- 설정 단계: 스토리 레이블 없음
- 기본 단계: 스토리 레이블 없음
- 사용자 스토리 단계: 스토리 레이블 필수
- 마무리 단계: 스토리 레이블 없음
- 설명: 정확한 파일 경로가 포함된 명확한 작업
예시:
- ✅ 올바름:
- [ ] T001 구현 계획에 따라 프로젝트 구조 생성 - ✅ 올바름:
- [ ] T005 [P] src/middleware/auth.py에 인증 미들웨어 구현 - ✅ 올바름:
- [ ] T012 [P] [US1] src/models/user.py에 User 모델 생성 - ✅ 올바름:
- [ ] T014 [US1] src/services/user_service.py에 UserService 구현 - ❌ 틀림:
- [ ] User 모델 생성(ID 및 스토리 레이블 누락) - ❌ 틀림:
T001 [US1] 모델 생성(체크박스 누락) - ❌ 틀림:
- [ ] [US1] User 모델 생성(작업 ID 누락) - ❌ 틀림:
- [ ] T001 [US1] 모델 생성(파일 경로 누락)
작업 구성
-
사용자 스토리(spec.md) 기준 - 기본 구성:
- 각 사용자 스토리(P1, P2, P3...)는 고유한 단계를 가짐
- 관련된 모든 구성 요소를 해당 스토리에 매핑:
- 해당 스토리에 필요한 모델
- 해당 스토리에 필요한 서비스
- 해당 스토리에 필요한 인터페이스/UI
- 테스트가 요청된 경우: 해당 스토리별 테스트
- 스토리 종속성 표시(대부분의 스토리는 독립적이어야 함)
-
계약(Contracts) 기준:
- 각 인터페이스 계약을 해당하는 사용자 스토리에 매핑
- 테스트가 요청된 경우: 각 인터페이스 계약 → 해당 스토리 단계에서 구현 전 계약 테스트 작업 [P]
-
데이터 모델(Data Model) 기준:
- 각 엔티티를 이를 필요로 하는 사용자 스토리에 매핑
- 엔티티가 여러 스토리에 사용되는 경우: 가장 이른 스토리 또는 설정 단계에 배치
- 관계 → 적절한 스토리 단계의 서비스 계층 작업
- data-model.md에 필드 제약 조건(최대 길이, nullable/필수, 열거형 값, 유효성 검사 규칙)이 있는 경우, 작업 설명에 제약 조건을 그대로 인용하여 구현 시 재량에 맡기지 않도록 합니다.
-
설정/인프라 기준:
- 공유 인프라 → 설정 단계(1단계)
- 기본/차단 작업 → 기본 단계(2단계)
- 스토리별 설정 → 해당 스토리 단계 내
단계 구조
- 1단계: 설정(프로젝트 초기화)
- 2단계: 기본(차단 전제 조건 - 사용자 스토리 전에 반드시 완료)
- 3단계+: 사용자 스토리 우선순위 순서(P1, P2, P3...)
- 각 스토리 내: 테스트(요청된 경우) → 모델 → 서비스 → 엔드포인트 → 통합
- 각 단계는 완전하고 독립적으로 테스트 가능한 증분이어야 함
- 최종 단계: 마무리 및 교차 관심사
완료 조건
- 모든 단계, 작업 ID 및 파일 경로가 포함된 tasks.md 생성됨
- 위의 필수 사후 실행 후크 규칙에 따라 확장 후크가 실행되거나 건너뛰어짐
- 작업 수, 스토리 분석 및 MVP 범위와 함께 완료가 사용자에게 보고됨