name: agile
description: 사용자와의 정기적인 체크인과 스프린트 관리를 담당하는 애자일 마스터입니다. /agile, /sprint, "스프린트 시작", "체크포인트" 트리거.
version: 2.6.0
updated: 2026-03-03

🏃 Agile Sprint Master

🔥 Heavy-Hitter (즉시 실행)
/agile auto | 초기 빌드: 전체 레이어 자동 실행 /agile iterate "변경사항" | 변경/추가: 영향받는 레이어만 실행 /agile status | 현재 스프린트 진행 상황

레이어: Skeleton (뼈대) → Muscles (근육) → Skin (피부)
목적: 1~3일 단위 스프린트 + 사용자 검토로 만족도 향상

v2.6.0: Long Context 최적화 - H2O 패턴으로 핵심 정보 상단 배치
v2.5.0: project-team 에이전트 팀 연동 (Project Manager, QA Manager)
v2.4.0: project-team Hook 시스템 연동 (task-sync, quality-gate)

⚡ Quick Start (최우선)

3-Stage Pipeline

1️⃣ 스프린트 계획   → Skeleton/Muscles/Skin 레이어 정의
2️⃣ 스프린트 수행   → 집중 개발 + 태스크 동기화
3️⃣ 체크포인트     → 스크린샷 캡처 + 사용자 승인

품질 게이트

🎯 핵심 원칙 (INVEST)

• Independent: 각 태스크는 독립적 완료/검토 가능
• Negotiable: 요구사항은 사용자와 협의 가능
• Valuable: 각 스프린트 결과물은 실질적 가치 제공
• Estimatable: 작업 규모 예측 가능
• Small: 1~3일 내 완료 가능
• Testable: 완료 여부 명확히 검증 가능

🏗️ 실행 프로세스

1. 스프린트 계획 (점진적 전체 완성 - Horizontal Slicing)

• 철학: 기능을 하나씩 완성하는 것이 아니라, 전체 시스템의 모습(Whole)을 유지하며 수준을 높여가는 방식을 취합니다.
• 레이어 별 스프린트 정의:
• Skeleton (뼈대): 전체 레이아웃, 더미 데이터, 주요 네비게이션 구조화. (Review 목표: "전체적인 틀이 맞는가?")
• Muscles (근육): 실제 데이터 연동, 핵심 비즈니스 로직, 인터랙션 구현. (Review 목표: "실제로 잘 작동하는가?")
• Skin & Polish (피부): 디자인 시스템 정밀 적용, 애니메이션, 예외 처리, 프리미엄 감성 추가. (Review 목표: "사용감이 훌륭한가?")
• 요구사항 재기술(Restatement): "이번 스프린트에서는 [전체 페이지]의 [Skeleton/Muscles/Skin] 레이어를 완성하여 [어떤 가치]를 보여드릴 예정입니다."

2. 스프린트 수행 (Execution)

• 정해진 스프린트 범위 내에서 집중적으로 개발을 진행합니다.
• 작업 중 발견된 새로운 아이디어나 변경 사항은 즉시 스프린트 백로그에 기록하고 사용자에게 공유합니다.
• [필수] 태스크 동기화: 매 태스크 실행 시 TASKS 파일(TASKS.md 우선, 없으면 docs/planning/06-tasks.md)을 즉시 업데이트합니다. (TEAM-CHARTER 준수)
• [필수] 문서 동기화: 코드 변경 시 관련 기획 문서를 즉시 최신화합니다.

3. 체크포인트 (Sprint Review)

• 시각적 현황 캡처 (Visual Status): notify_user 호출 전, chrome-browser 스킬(또는 agent-browser)을 사용하여 현재 구현된 기능의 화면을 캡처합니다.
• agent-browser open -> agent-browser wait -> agent-browser screenshot
• 반드시 notify_user 호출: 각 스프린트 목표 달성 시 또는 마일스톤 종료 시, 코드와 함께 시각적 결과물(캡처 이미지)을 제공하고 승인을 요청합니다.
• 사용자의 피드백을 수집하여 즉시 다음 작업에 반영합니다.

4. 품질 게이트 (Quality Gate) - v2.4.0

각 레이어 완료 시 품질 검증을 수행합니다:

┌─────────────────────────────────────────────────────────────┐
│  레이어 완료 → 품질 게이트 체크                              │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  🦴 Skeleton 완료 시:                                       │
│  └── 린트 통과 + 빌드 성공 확인                             │
│                                                             │
│  💪 Muscles 완료 시:                                        │
│  └── 린트 + 빌드 + 단위 테스트 통과                         │
│  └── /checkpoint (2단계 리뷰) ← v2.4.0 NEW                 │
│                                                             │
│  ✨ Skin 완료 시:                                           │
│  └── 전체 테스트 + /trinity → /audit 실행                   │
│  └── /verification-before-completion 필수                   │
│                                                             │
└─────────────────────────────────────────────────────────────┘

🎯 핵심 원칙 (INVEST)

태스크를 정의하거나 스프린트를 쪼갤 때 항상 다음 원칙을 준수합니다.

• Independent: 각 태스크는 다른 태스크와 독립적으로 완료/검토될 수 있어야 합니다.
• Negotiable: 요구사항은 고정된 것이 아니며 사용자와 협의 가능합니다.
• Valuable: 각 스프린트 결과물은 사용자에게 실질적인 가치를 제공해야 합니다.
• Estimatable: 작업 규모를 예측할 수 있을 만큼 작아야 합니다.
• Small: 1~3일 내에 완료될 수 있는 크기여야 합니다.
• Testable: 완료 여부를 명확하게 검증할 수 있어야 합니다.

🛠️ 주요 명령어 대응

🔄 반복 작업 모드 (/agile iterate)

목적: 이미 완성된 코드베이스에서 디자인 변경, 새 기능 추가, 업무 로직 수정 등을 처리합니다.

사용 예시

# 디자인 변경
/agile iterate "메인 페이지 디자인 리뉴얼"

# 새 기능 추가
/agile iterate "결제 시스템 추가"

# 업무 로직 변경
/agile iterate "할인 로직 변경: 쿠폰 중복 적용 허용"

실행 흐름

/agile iterate "변경사항 설명" 실행
    ↓
┌─────────────────────────────────────────────────────────────┐
│  1️⃣ 변경 범위 분석                                           │
│  - 변경 요청 해석                                             │
│  - 기존 코드베이스 스캔 (영향받는 파일 파악)                   │
│  - 영향받는 레이어 자동 판별                                  │
├─────────────────────────────────────────────────────────────┤
│  📋 분석 결과 → 사용자 확인                                   │
│  "이 변경은 [Muscles], [Skin] 레이어에 영향을 줍니다.         │
│   영향받는 파일: 5개. 진행할까요?"                            │
│  [승인] → 실행 / [조정] → 범위 수정                           │
└─────────────────────────────────────────────────────────────┘
    ↓ (사용자 승인)
┌─────────────────────────────────────────────────────────────┐
│  2️⃣ 영향받는 레이어만 선택적 실행                             │
│                                                             │
│  [건너뜀] 🦴 Skeleton (영향 없음)                             │
│                                                             │
│  💪 MUSCLES 레이어 실행 → 완료 시 사용자 확인                 │
│  ✨ SKIN 레이어 실행 → 완료 시 사용자 확인                    │
└─────────────────────────────────────────────────────────────┘
    ↓
┌─────────────────────────────────────────────────────────────┐
│  3️⃣ 최종 검증 및 보고                                        │
│  - 변경 전/후 비교 (가능 시 스크린샷)                         │
│  - 테스트 실행 결과                                          │
│  - Git diff 요약                                             │
└─────────────────────────────────────────────────────────────┘

변경 유형별 영향 레이어 자동 판별

/agile auto vs /agile iterate 비교

🤖 레이어별 자동 실행 (/agile auto)

목적: 뼈대 → 근육 → 스킨 각 레이어를 자동으로 실행하되, 각 레이어 완료 시 반드시 사용자 확인을 받아 수정 사항을 즉시 반영합니다.

실행 흐름

/agile auto 실행
    ↓
┌─────────────────────────────────────────────────────────────┐
│  🦴 SKELETON (뼈대) 레이어                                   │
│  - 전체 레이아웃, 더미 데이터, 네비게이션 구조                 │
│  - 관련 태스크 자동 실행                                      │
├─────────────────────────────────────────────────────────────┤
│  ✅ 레이어 완료 → 스크린샷 캡처 → notify_user                 │
│  "뼈대가 완성되었습니다. 전체적인 틀이 맞는지 확인해주세요."   │
│  [승인] → 다음 레이어 / [수정 요청] → 즉시 반영 후 재확인      │
└─────────────────────────────────────────────────────────────┘
    ↓ (사용자 승인)
┌─────────────────────────────────────────────────────────────┐
│  💪 MUSCLES (근육) 레이어                                    │
│  - 실제 데이터 연동, 핵심 비즈니스 로직, 인터랙션              │
│  - 관련 태스크 자동 실행                                      │
├─────────────────────────────────────────────────────────────┤
│  ✅ 레이어 완료 → 스크린샷 캡처 → notify_user                 │
│  "기능이 구현되었습니다. 실제로 잘 작동하는지 확인해주세요."   │
│  [승인] → 다음 레이어 / [수정 요청] → 즉시 반영 후 재확인      │
└─────────────────────────────────────────────────────────────┘
    ↓ (사용자 승인)
┌─────────────────────────────────────────────────────────────┐
│  ✨ SKIN (스킨) 레이어                                       │
│  - 디자인 시스템 정밀 적용, 애니메이션, 예외 처리              │
│  - 관련 태스크 자동 실행                                      │
├─────────────────────────────────────────────────────────────┤
│  ✅ 레이어 완료 → 스크린샷 캡처 → notify_user                 │
│  "완성되었습니다. 사용감이 훌륭한지 최종 확인해주세요."        │
└─────────────────────────────────────────────────────────────┘

태스크-레이어 매핑 규칙

TASKS 파일(TASKS.md 우선, 없으면 docs/planning/06-tasks.md)에서 태스크를 레이어별로 분류합니다:

참고: 태스크에 [Skeleton], [Muscles], [Skin] 태그가 있으면 해당 태그를 우선 사용합니다.

체크포인트 메시지 형식

## 🦴 Skeleton 레이어 완료!

**완료된 태스크**: T0.1, T0.2, T1.1
**스크린샷**: [첨부]

### 확인 요청

> 전체적인 틀이 맞는지 확인해주세요.
>
> - 레이아웃이 의도한 대로인가요?
> - 네비게이션 구조가 올바른가요?

**다음 단계**: Muscles 레이어 (API 연동, 핵심 로직 구현)

[1] 승인하고 다음 레이어 진행
[2] 수정 요청 (피드백 입력)

📊 태스크 실행 추적 (Task Execution Tracking)

개별 태스크를 시작하고 완료할 때 자동으로 문서화하고 진행 상황을 추적합니다.

/agile run {task-id} - 태스크 시작

실행 시 수행할 작업:

1. TASKS 파일에서 해당 태스크 정보 추출 (TASKS.md 우선)
2. 실행 계획서 생성: docs/reports/{task-id}-plan.md

```markdown
# Execution Plan: {task-id}

시작 시각: {timestamp}
목표: {task 설명}

## 실행 단계

1. ...
2. ...

## 예상 산출물

• ...
  ```

• TASKS 파일 업데이트: 해당 태스크를 [/] (진행 중)로 표시

• 사용자에게 계획 보고 후 작업 시작

/agile done {task-id} - 태스크 완료

실행 시 수행할 작업:

1. 완료 보고서 생성: docs/reports/{task-id}-report.md

```markdown
# Completion Report: {task-id}

완료 시각: {timestamp}
소요 시간: {duration}

## 완료된 작업

• ...

## 생성된 파일

• path/to/file1.ts
• path/to/file2.tsx

## 테스트 결과

• ✅ 단위 테스트 통과
• ✅ 빌드 성공

## 다음 단계

• 다음 태스크: {next-task-id}
  ```

• TASKS 파일 업데이트: 해당 태스크를 [x] (완료)로 표시

• Git 커밋 제안 (선택적)

🔗 스킬 연동 (v2.6.0)

🪝 Hook 연동 (v1.9.2)

🤖 Agent Team 연동 (v2.5.0)

project-team 에이전트들과 협업하여 스프린트를 관리합니다.

스프린트 시작 시 에이전트 협업

/agile start 또는 /agile auto 실행 시:
    ↓
┌─────────────────────────────────────────────────────────────┐
│  1️⃣ Project Manager 에이전트에게 태스크 분배 요청           │
│  - Agent tool 사용: subagent_type="project-manager"         │
│  - 스프린트 범위와 일정 전달                                 │
│  - PM이 태스크를 도메인별로 분배                            │
├─────────────────────────────────────────────────────────────┤
│  2️⃣ Domain Specialist 에이전트들에게 병렬 할당              │
│  - backend-specialist: API/데이터 로직                      │
│  - frontend-specialist: UI/상태 관리                        │
│  - security-specialist: 보안 검증 (Muscles 완료 시)          │
├─────────────────────────────────────────────────────────────┤
│  3️⃣ 체크포인트 시 QA Manager에게 품질 검증 요청            │
│  - SendMessage tool로 승인 요청                             │
│  - 품질 게이트 통과 시 다음 레이어 진행                     │
└─────────────────────────────────────────────────────────────┘

에이전트 호출 패턴

1) Project Manager에게 스프린트 계획 요청:

// Agent tool로 PM 호출
Agent({
  subagent_type: "project-manager",
  prompt: `스프린트 계획을 수립해주세요:
  - 범위: ${레이어} 레이어
  - 태스크: ${태스크_목록}
  - 일정: ${예상_기간}`
})

2) QA Manager에게 품질 승인 요청:

// SendMessage tool로 승인 요청
SendMessage({
  type: "message",
  recipient: "qa-manager",
  content: `품질 검증 요청:
  - 레이어: ${레이어_명}
  - 완료 태스크: ${태스크_ID_목록}
  - 테스트 결과: ${결과_요약}`,
  summary: "Quality gate approval request"
})

에이전트별 역할 분담

project-team 연동 전제 조건

# project-team이 설치되어 있어야 합니다
ls project-team/agents/*.md

# governance-setup이 실행된 프로젝트여야 합니다
ls management/mini-prd.md

project-team 미설치 시 동작:
- 에이전트 호출을 스킵하고 standalone 모드로 동작
- 사용자에게 "project-team 설치 권장" 메시지 표시

⚠️ 실패 시 대응

Last Updated: 2026-03-03 (v2.5.0 - project-team 에이전트 팀 연동)