Analyze Project Status

User Input

$ARGUMENTS

You MUST consider the user input before proceeding (if not empty).

⚠️ 커맨드 구분: 이것은 플러그인 커맨드 (/spec-kit:analyze)입니다. 정보 수집과 사용자 논의를 담당합니다. 실제 파일 생성/업데이트는 GitHub Spec-Kit CLI 커맨드 (/speckit.analyze)가 수행합니다.

🌐 언어 지시사항: 이 명령어를 실행할 때는 사용자의 시스템 언어를 자동으로 감지하여 해당 언어로 모든 안내, 질문, 분석 리포트, 출력을 제공해야 합니다. 시스템 환경 변수(LANG, LC_ALL 등)나 사용자의 이전 대화 패턴을 분석하여 언어를 판단하세요.

spec-kit 프로젝트의 전체 상태를 분석하고 진행 상황을 리포트합니다.

Purpose

다음을 파악합니다:

• 명세-계획-작업의 정합성
• 구현 진행률
• 헌법 준수 여부
• 차단 요소
• 다음 액션

Step 1: Gather Status

모든 spec-kit 파일 읽기:

# 현재 브랜치 확인
CURRENT_BRANCH=$(git branch --show-current)

# 헌법 (전역)
cat .specify/memory/constitution.md

# 기능별 파일들 (브랜치별)
cat "specs/$CURRENT_BRANCH/spec.md"
cat "specs/$CURRENT_BRANCH/plan.md"
cat "specs/$CURRENT_BRANCH/tasks.md"

Step 2: Analyze Completeness

각 문서의 완성도 평가:

Constitution

• ✅ 존재 / ❌ 없음
• Status: Draft / Approved
• 원칙 개수: [N]개
• 품질 게이트: [N]개

Specification

• ✅ 존재 / ❌ 없음
• Status: Draft / In Review / Approved
• User Stories: [N]개
• Acceptance Criteria: [N]개
• Open Questions: [N]개 (⚠️ 해결 필요)

Plan

• ✅ 존재 / ❌ 없음
• Status: Draft / Approved
• Phases: [N]개
• Open Technical Questions: [N]개 (⚠️ 해결 필요)

Tasks

• ✅ 존재 / ❌ 없음
• Total Tasks: [N]개
• Completed: [N]개 ([%]%)
• In Progress: [N]개
• Pending: [N]개

Step 3: Check Alignment

문서 간 정합성 확인:

Specification → Plan:

• 명세의 모든 요구사항이 계획에 반영되었는가?
• 계획의 기술 선택이 명세 제약사항을 만족하는가?

Plan → Tasks:

• 계획의 모든 Phase가 작업으로 분해되었는가?
• 작업 예상 시간의 합이 현실적인가?

Constitution → All:

• 명세가 헌법 원칙을 준수하는가?
• 계획이 기술 표준을 따르는가?
• 작업이 품질 게이트를 포함하는가?

Step 4: Identify Blockers

진행을 막는 요소 식별:

High Priority:

• 🔴 Open Questions 미해결
• 🔴 상충되는 요구사항
• 🔴 누락된 의존성
• 🔴 차단된 작업 (의존성 미완료)

Medium Priority:

• 🟡 명확하지 않은 요구사항
• 🟡 기술 스택 미결정
• 🟡 테스트 전략 없음

Low Priority:

• 🟢 문서 포맷팅
• 🟢 예제 부족

Step 5: Save Draft and Execute Spec-Kit Command

5.1 수집된 정보를 Draft 파일로 저장

먼저 현재 기능의 drafts 디렉토리 생성:

# drafts 디렉토리 생성
mkdir -p "specs/$CURRENT_BRANCH/drafts"

Write 도구를 사용하여 수집된 정보를 specs/$CURRENT_BRANCH/drafts/analyze-draft.md 파일로 저장합니다:

# Analyze Draft

## Document Status

### Constitution
- Status: [Step 2에서 확인한 상태]
- Principles: [N]개
- Quality Gates: [N]개
- Issues: [식별된 이슈들]

### Specification
- Status: [Step 2에서 확인한 상태]
- User Stories: [N]개
- Acceptance Criteria: [N]개
- Open Questions: [N]개
- Issues: [식별된 이슈들]

### Plan
- Status: [Step 2에서 확인한 상태]
- Phases: [N]개
- Open Technical Questions: [N]개
- Issues: [식별된 이슈들]

### Tasks
- Total: [N]개
- Completed: [N]개 ([%]%)
- In Progress: [N]개
- Pending: [N]개

## Alignment Check

### Spec ↔ Plan
[Step 3에서 확인한 정합성 상태와 이슈...]

### Plan ↔ Tasks
[Step 3에서 확인한 정합성 상태와 이슈...]

### Constitution ↔ All
[Step 3에서 확인한 준수 여부...]

## Identified Blockers

### High Priority (🔴)
[Step 4에서 식별한 고우선순위 차단 요소들...]

### Medium Priority (🟡)
[Step 4에서 식별한 중우선순위 이슈들...]

### Low Priority (🟢)
[Step 4에서 식별한 저우선순위 이슈들...]

## Current Status
- Current Phase: [Phase 번호] - [Phase Name]
- Estimated Remaining: [N] hours

5.2 Spec-Kit 명령 실행

⚠️ CRITICAL - MUST USE SLASHCOMMAND TOOL:

You MUST now use the SlashCommand tool to execute the /speckit.analyze command. This is a required step - do not skip it!

Call the SlashCommand tool with the following command parameter (replace $CURRENT_BRANCH with the actual branch name):

/speckit.analyze INSTRUCTION: This command is being called from /spec-kit:analyze plugin. Current branch is "$CURRENT_BRANCH" and draft at "specs/$CURRENT_BRANCH/drafts/analyze-draft.md". Read draft. Draft contains ALL analysis results including document status, alignment checks, and identified blockers. Skip all data gathering and analysis steps (Step 1-4) and proceed directly to generating comprehensive analysis report. **CRITICAL - MUST FOLLOW:** 1. LANGUAGE: Process ALL content in user's system language. 2. ASKUSERQUESTION: Use AskUserQuestion tool if clarification needed. 3. REPORT GENERATION: Generate report from draft only, do NOT re-analyze documents.

The spec-kit command will read the draft file and generate a comprehensive analysis report in the user's system language.

토큰 절약 효과:

• 긴 텍스트를 명령어 인자로 전달하지 않음
• 파일 경로만 전달하여 효율적
• Draft 파일로 디버깅 및 재사용 가능

# Project Analysis Report

**Date**: [현재 날짜]

## Overall Status

📊 **Progress**: [완료된 작업] / [전체 작업] ([%]%)

🎯 **Current Phase**: Phase [N] - [Phase Name]

⏱️ **Estimated Remaining**: [N] hours

## Document Status

| Document | Status | Completeness | Issues |
|----------|--------|--------------|--------|
| Constitution | ✅ | 100% | 0 |
| Specification | ⚠️ | 85% | 2 open questions |
| Plan | ✅ | 100% | 0 |
| Tasks | 🔄 | 60% | 3/5 complete |

## Alignment Check

✅ Constitution ↔ Specification: Aligned
✅ Specification ↔ Plan: Aligned
⚠️ Plan ↔ Tasks: 1 phase not broken down

## Blockers

### High Priority (🔴)

1. **[Blocker Name]**
   - Impact: [영향 설명]
   - Action: [해결 방법]

### Medium Priority (🟡)

[...]

## Recommendations

1. **Immediate**: [즉시 해야 할 것]
2. **Next**: [다음 단계]
3. **Future**: [추후 고려사항]

## Next Actions

1. `/speckit:clarify` - Resolve open questions
2. `/speckit:implement` - Continue Task [N]
3. `/speckit:checklist` - Run quality gates

When to Use

• 스프린트 시작 시
• 중요 마일스톤 전
• 진행이 막혔다고 느낄 때
• 전체 상황 파악이 필요할 때

Next Steps

분석 결과에 따라:

• Open Questions 많음 → /spec-kit:clarify
• 작업 완료율 낮음 → /spec-kit:implement
• 품질 확인 필요 → /spec-kit:checklist
• 계획 수정 필요 → /spec-kit:plan

What's Next?

AskUserQuestion 도구를 사용하여 사용자에게 다음 작업을 물어봅니다:

{
  "questions": [{
    "question": "프로젝트 분석이 완료되었습니다. 분석 결과를 바탕으로 다음 단계로 무엇을 진행하시겠습니까?",
    "header": "다음 단계",
    "multiSelect": false,
    "options": [
      {
        "label": "구현 계속 (/spec-kit:implement)",
        "description": "분석 결과를 반영하여 남은 작업들을 계속 구현합니다. (권장)"
      },
      {
        "label": "모호한 부분 명확화 (/spec-kit:clarify)",
        "description": "분석에서 발견된 Open Questions를 해결합니다."
      },
      {
        "label": "명세 업데이트 (/spec-kit:specify)",
        "description": "분석 결과 명세를 수정해야 한다면 업데이트합니다."
      },
      {
        "label": "계획 업데이트 (/spec-kit:plan)",
        "description": "분석 결과 계획을 조정해야 한다면 업데이트합니다."
      },
      {
        "label": "품질 게이트 확인 (/spec-kit:checklist)",
        "description": "품질 기준을 확인하고 체크리스트를 실행합니다."
      },
      {
        "label": "다른 명령어 실행",
        "description": "위 선택지에 없는 다른 spec-kit 명령어를 직접 입력하여 실행합니다."
      },
      {
        "label": "작업 완료",
        "description": "지금은 여기까지만 작업하겠습니다."
      }
    ]
  }]
}

사용자 선택에 따라:

• 구현 계속 선택 시 → /spec-kit:implement 명령 실행 안내
• 모호한 부분 명확화 선택 시 → /spec-kit:clarify 명령 실행 안내
• 명세 업데이트 선택 시 → /spec-kit:specify 명령 실행 안내
• 계획 업데이트 선택 시 → /spec-kit:plan 명령 실행 안내
• 품질 게이트 확인 선택 시 → /spec-kit:checklist 명령 실행 안내
• 다른 명령어 실행 선택 시 → 사용자가 원하는 명령어 입력 요청
• 작업 완료 선택 시 → 세션 종료

---

참고:

• 정기적인 분석으로 프로젝트가 올바른 방향으로 가고 있는지 확인합니다
• 우리 플러그인(/spec-kit:analyze)은 분석 범위 및 초점 결정 역할
• 실제 상태 분석 및 리포트 생성은 spec-kit 명령어(/speckit.analyze)가 담당