사용자 입력
$ARGUMENTS
계속 진행하기 전에 사용자 입력을 반드시 고려해야 합니다(비어 있지 않은 경우).
사전 실행 검사
확장 훅 확인 (계획 수립 전):
- 프로젝트 루트에
.specify/extensions.yml파일이 있는지 확인합니다. - 파일이 존재하면 읽고
hooks.before_plan키 아래의 항목을 찾습니다. - YAML을 구문 분석할 수 없거나 유효하지 않은 경우, 조용히 넘어가지 말고 사용자에게
.specify/extensions.yml파일을 읽을 수 없다고 알리고(구문 분석 오류 포함) 해당 파일에 등록된 필수(optional: false) 훅을 포함한 모든 훅이 확인되지 않았음을 알린 후 정상적으로 계속 진행합니다. enabled가 명시적으로false인 훅은 필터링합니다.enabled필드가 없는 훅은 기본적으로 활성화된 것으로 간주합니다.- 나머지 각 훅에 대해 훅
condition표현식을 해석하거나 평가하려고 시도하지 마십시오:- 훅에
condition필드가 없거나 null/비어 있으면 해당 훅을 실행 가능한 것으로 간주합니다. - 훅이 비어 있지 않은
condition을 정의하면 해당 훅을 건너뛰고 조건 평가는 HookExecutor 구현에 맡깁니다.
- 훅에
- 훅 명령 이름에서 명령 호출을 구성할 때 점(
.)을 하이픈(-)으로 바꿉니다. 예:speckit.git.commit→/speckit-git-commit. - 실행 가능한 각 훅에 대해
optional플래그에 따라 다음을 출력합니다:- 선택적 훅 (
optional: true):## 확장 훅 **선택적 사전 훅**: {extension} 명령: `/{command}` 설명: {description} 프롬프트: {prompt} 실행하려면: `/{command}` - 필수 훅 (
optional: false):
위 블록을 출력한 후 실제로 훅을 호출하고 완료될 때까지 기다려야 합니다. 이 에이전트/세션에서 직접 명령을 실행하는 것과 동일한 방식으로 실행합니다(호출 방식은 위에 표시된 리터럴## 확장 훅 **자동 사전 훅**: {extension} 실행 중: `/{command}` EXECUTE_COMMAND: {command} 훅 명령의 결과를 기다린 후 개요(Outline)로 진행합니다.{command}ID와 다를 수 있습니다. 예를 들어, 스킬 모드 에이전트는/skill:speckit-...또는$speckit-...로 실행합니다). 블록만 출력한다고 해서 훅이 실행되는 것은 아닙니다.
- 선택적 훅 (
- 등록된 훅이 없거나
.specify/extensions.yml파일이 없으면 조용히 건너뜁니다.
개요
-
설정: 저장소 루트에서
.specify/scripts/bash/setup-plan.sh --json을 실행하고 JSON을 구문 분석하여 FEATURE_SPEC, IMPL_PLAN, FEATURE_DIR, BRANCH를 가져옵니다. "I'm Groot"와 같은 인수에 작은따옴표가 있는 경우 이스케이프 구문을 사용하세요: 예: 'I'''m Groot'(또는 가능하면 큰따옴표 사용: "I'm Groot"). -
컨텍스트 로드: FEATURE_SPEC과
.specify/memory/constitution.md를 읽습니다. IMPL_PLAN 템플릿을 로드합니다(이미 복사됨). -
계획 워크플로우 실행: IMPL_PLAN 템플릿의 구조를 따라 다음을 수행합니다:
- 기술 컨텍스트 채우기 (알 수 없는 항목은 "NEEDS CLARIFICATION"으로 표시)
- constitution에서 헌법 확인(Constitution Check) 섹션 채우기
- 게이트 평가 (부당한 위반 사항이 있으면 ERROR)
- 0단계: research.md 생성 (모든 NEEDS CLARIFICATION 해결)
- 1단계: data-model.md, contracts/, quickstart.md 생성
- 설계 후 헌법 확인 재평가
필수 사후 실행 훅
사용자에게 완료를 보고하기 전에 이 섹션을 반드시 완료해야 합니다.
프로젝트 루트에 .specify/extensions.yml 파일이 있는지 확인합니다.
- 파일이 없거나
hooks.after_plan아래에 등록된 훅이 없으면 완료 보고서(Completion Report)로 건너뜁니다. - 파일이 존재하면 읽고
hooks.after_plan키 아래의 항목을 찾습니다. - 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:를 반드시 출력해야 합니다:
위 블록을 출력한 후 실제로 훅을 호출하고 완료될 때까지 기다려야 합니다. 이 에이전트/세션에서 직접 명령을 실행하는 것과 동일한 방식으로 실행합니다(호출 방식은 위에 표시된 리터럴## 확장 훅 **자동 훅**: {extension} 실행 중: `/{command}` EXECUTE_COMMAND: {command}{command}ID와 다를 수 있습니다. 예를 들어, 스킬 모드 에이전트는/skill:speckit-...또는$speckit-...로 실행합니다). 블록만 출력한다고 해서 훅이 실행되는 것은 아닙니다. - 선택적 훅 (
optional: true):## 확장 훅 **선택적 훅**: {extension} 명령: `/{command}` 설명: {description} 프롬프트: {prompt} 실행하려면: `/{command}`
- 필수 훅 (
완료 보고서
명령은 1단계 설계 후 종료됩니다. 브랜치, IMPL_PLAN 경로 및 생성된 산출물을 보고합니다.
단계
0단계: 개요 및 리서치
-
위 기술 컨텍스트에서 알 수 없는 항목 추출:
- 각 NEEDS CLARIFICATION → 리서치 작업
- 각 종속성 → 모범 사례 작업
- 각 통합 → 패턴 작업
-
리서치 에이전트 생성 및 전달:
기술 컨텍스트의 각 알 수 없는 항목에 대해: 작업: "{feature context}에서 {unknown} 리서치" 각 기술 선택에 대해: 작업: "{domain}에서 {tech}에 대한 모범 사례 찾기" -
결과 취합 후
research.md에 다음 형식으로 저장:- 결정: [선택된 사항]
- 근거: [선택 이유]
- 고려된 대안: [평가된 다른 옵션]
출력: 모든 NEEDS CLARIFICATION이 해결된 research.md
1단계: 설계 및 계약
전제 조건: research.md 완료
-
기능 명세에서 엔터티 추출 →
data-model.md:- 엔터티 이름, 필드, 관계
- 요구사항의 유효성 검사 규칙
- 해당하는 경우 상태 전이
-
인터페이스 계약 정의 (프로젝트에 외부 인터페이스가 있는 경우) →
/contracts/:- 프로젝트가 사용자나 다른 시스템에 노출하는 인터페이스를 식별합니다.
- 프로젝트 유형에 적합한 계약 형식을 문서화합니다.
- 예: 라이브러리의 공개 API, CLI 도구의 명령 스키마, 웹 서비스의 엔드포인트, 파서의 문법, 애플리케이션의 UI 계약
- 프로젝트가 순수 내부용(빌드 스크립트, 일회성 도구 등)인 경우 건너뜁니다.
-
퀵스타트 검증 가이드 생성 →
quickstart.md:- 기능이 종단 간 작동함을 증명하는 실행 가능한 검증 시나리오를 문서화합니다.
- 전제 조건, 설정 명령, 테스트/실행 명령 및 예상 결과를 포함합니다.
- 콘텐츠를 중복하지 않도록 계약 및 데이터 모델 세부 정보에 대한 링크나 참조를 사용합니다.
- 전체 구현 코드, 모델/서비스/컨트롤러 본문, 마이그레이션 또는 완전한 테스트 스위트는 포함하지 마십시오.
- 이 산출물을 검증/실행 가이드로 유지하십시오. 구현 세부 정보는
tasks.md및 구현 단계에 속합니다.
출력: data-model.md, /contracts/*, quickstart.md
주요 규칙
- 파일 시스템 작업에는 절대 경로를 사용하고, 문서의 참조에는 프로젝트 상대 경로를 사용합니다.
- 게이트 실패 또는 해결되지 않은 명확화 요청 시 ERROR를 발생시킵니다.
완료 조건
- 계획 워크플로우 실행 및 설계 산출물 생성됨
- 확장 훅이 위 '필수 사후 실행 훅'의 규칙에 따라 전달되거나 건너뛰어짐
- 브랜치, 계획 경로 및 생성된 산출물과 함께 완료가 사용자에게 보고됨