name	milestone-execute
description	마일스톤 다음 단계 실행. milestone.md의 미완료 Phase를 plan.md 기반으로 구현. "다음 작업", "마일스톤 실행", "Phase 진행" 등의 요청 시 사용
disable-model-invocation	false
argument-hint	[Phase 번호] (생략 시 다음 미완료 Phase 자동 선택)

워크플로우: 마일스톤 Phase 실행

목표: milestone.md에서 다음 미완료 Phase를 식별하고, plan.md의 구현 상세를 참고하여 실제 코드를 구현합니다.

1단계: 컨텍스트 로드

프로젝트 루트에서 다음 4개 파일을 읽습니다:

SPEC.md — 요구사항 (기능/비기능 요구사항, 제약조건, 사용자 시나리오)
milestone.md — 작업 목록 및 진행 상태
plan.md — 구현 상세 (아키텍처, 디렉토리 구조, 데이터 흐름 등)
survey.md — 아키텍처 결정 사항

SPEC.md가 없으면 /spec을 먼저 실행하도록 안내합니다.
milestone.md가 없으면 /milestone을 먼저 실행하도록 안내합니다.
plan.md가 없으면 /planner를 먼저 실행하도록 안내합니다.
survey.md가 없으면 /survey를 먼저 실행하도록 안내합니다.

2단계: 대상 Phase 판별

인자로 Phase 번호가 주어진 경우: 해당 Phase를 대상으로 선택합니다.
인자가 없는 경우: milestone.md에서 첫 번째 미완료([ ]) 항목이 포함된 Phase를 자동 선택합니다.
모든 Phase가 완료된 경우: 사용자에게 "모든 마일스톤이 완료되었습니다"를 알리고 종료합니다.

선택된 Phase와 포함된 작업 항목들을 사용자에게 보여주고 진행 여부를 확인합니다.

3단계: 태스크 리스트 생성

해당 Phase의 미완료 체크박스 항목들을 TaskCreate로 태스크 리스트에 등록합니다.

subject: 체크박스의 볼드 텍스트 (작업 제목)
description: 해당 항목의 목표, 포함 내용, 검증 기준 + plan.md에서 관련 구현 상세
activeForm: 작업 제목의 현재진행형 (예: "조건부 서식 데이터 모델 구현" → "조건부 서식 데이터 모델 구현 중")

이미 완료([x])된 항목은 건너뜁니다.

4단계: 구현 실행 (병렬+순차 하이브리드)

4-A: 의존성 분석

Phase의 모든 미완료 태스크를 검토하여 실행 그래프(Layer)를 생성합니다.

의존 관계 판정 기준:

관계	판정	근거
같은 파일 수정	순차	동시 수정 시 충돌
export → import 관계	순차	선행 타입/함수가 있어야 후행 구현 가능
다른 디렉토리, 독립 기능	병렬	충돌 없음
공통 컨텍스트만 참조 (읽기 전용)	병렬	충돌 없음

Layer 생성 예시:

Layer 1: [Task A, Task B]  ← 독립적, 병렬 실행
Layer 2: [Task C]           ← Task A의 export를 import
Layer 3: [Task D, Task E]  ← Task C 완료 후 독립적, 병렬 실행

TaskUpdate로 의존 관계를 addBlockedBy/addBlocks에 등록합니다.

4-B: 에이전트 타입 매핑

각 태스크의 성격에 따라 최적의 에이전트를 선택합니다:

태스크 성격	subagent_type	model	판단 기준
React 컴포넌트 UI 구현	frontend-developer	sonnet	JSX, 스타일, 이벤트 핸들링
타입 정의, 제네릭, 유틸리티 타입	typescript-pro	sonnet	type, interface, 제네릭 제약
API 로직, 비즈니스 로직, 훅	general-purpose	sonnet	데이터 처리, 상태 관리
복잡한 아키텍처 결정 포함	general-purpose	opus	설계 판단이 필요한 경우
보일러플레이트, 설정 파일	general-purpose	haiku	단순 반복 작업

4-C: 병렬+순차 하이브리드 실행

Layer별로 실행합니다:

Layer 내 (병렬):

독립 태스크들은 Task tool로 동시 실행 (run_in_background: true)
각 Task sub-agent에게 전달할 정보:
- 해당 태스크의 description (목표, 구현 상세, 검증 기준)
- SPEC.md, plan.md, survey.md의 관련 섹션 요약
- 준수 사항 (CLAUDE.md 패턴, FSD 원칙, 기존 코드 컨벤션)

Layer 간 (순차):

선행 Layer의 모든 태스크 완료 확인 후 다음 Layer 실행
각 Layer 완료 시 중간 검증 실행:
```
pnpm typecheck
```
typecheck 실패 시: 오류를 분석하고 수정한 후 다음 Layer로 진행

단일 태스크 또는 순차 의존만 있는 경우:

sub-agent 없이 오케스트레이터가 직접 순차 구현 (기존 방식 유지)

각 태스크 완료 시 TaskUpdate로 상태를 completed로 변경합니다.

구현 시 준수 사항

CLAUDE.md의 아키텍처 패턴 및 디렉토리 구조를 따릅니다.
FSD 원칙을 준수합니다.
기존 코드베이스의 패턴과 컨벤션을 따릅니다.
보안 취약점을 도입하지 않습니다.

5단계: 검증

각 작업 항목의 "검증" 기준에 따라 검증을 수행합니다.

pnpm run typecheck — 타입 검사
pnpm run lint — 린트 검사
pnpm run test:unit — 관련 단위 테스트 실행 (테스트가 있는 경우)

검증 실패 시:

오류를 분석하고 수정합니다.
수정 후 다시 검증합니다.
반복적으로 실패하면 사용자에게 보고하고 판단을 요청합니다.

6단계: 마일스톤 업데이트

모든 작업이 완료되면 /milestone-update 스킬을 호출하여:

완료된 체크박스를 [x]로 업데이트합니다.
세션 노트에 구현 요약을 추가합니다.

7단계: 결과 보고

실행 결과를 사용자에게 보고합니다:

완료된 Phase 번호 및 제목
구현된 작업 항목 목록
실행 방식 요약 (병렬 Layer 수, 사용된 에이전트 타입)
검증 결과
다음 미완료 Phase 안내 (있는 경우)

Más de este repositorio

mismo repositorio

clean-code-inspector

gihwan-dev/claude-code-gui

React 코드 품질 분석. git diff 기반으로 변경된 코드의 클린 코드 점수 평가. "코드 리뷰", "품질 검사" 등의 요청 시 사용

2026-02-081

unused-code-cleaner

gihwan-dev/claude-code-gui

AI 코드 생성 후 불필요한 코드 정리 스킬. git diff로 변경된 TS/JS 파일을 분석하여 사용되지 않는 코드를 자동 제거한다. 트리거: unused 코드 정리, 불필요한 코드 삭제, dead code 제거, 코드 클린업, AI 작업 후 정리 요청 시

2026-02-081

complexity-refactor

gihwan-dev/claude-code-gui

순환 복잡도(Cyclomatic Complexity)가 높은 함수를 인간의 논리적 사고 흐름에 맞게 재구성하는 스킬. "복잡한 함수 정리해줘", "이 함수 읽기 어려워", "순환 복잡도 낮춰줘", "리팩토링 해줘" 등의 요청에 사용. 단순 코드 추출이 아닌 논리적 재구성을 수행하며, 성능보다 가독성과 수정 용이성을 우선시함.

2026-02-081

component-screenshot

gihwan-dev/claude-code-gui

Story 파일에서 컴포넌트 스크린샷 캡처. "/screenshot", "스크린샷 캡처" 등의 요청 시 사용

2026-02-081

deep-think

gihwan-dev/claude-code-gui

Deep reasoning skill using Claude Code's Agent Teams. Spawns multiple personas with enforced minimum depth, includes a challenge round where teammates critique each other, and iterates on low-confidence answers. Use when the user prefixes with "deep think", "딥씽크", "깊게 생각해", or requests thorough analysis. Best for complex architecture, debugging, algorithmic, or multi-domain problems. NOT for simple lookups. Requires: CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

2026-02-081

design-check

gihwan-dev/claude-code-gui

디자인 검증 자동화. Figma vs 구현 비교 리포트 생성. "/design-check", "디자인 검증" 등의 요청 시 사용

2026-02-081

name	milestone-execute
description	마일스톤 다음 단계 실행. milestone.md의 미완료 Phase를 plan.md 기반으로 구현. "다음 작업", "마일스톤 실행", "Phase 진행" 등의 요청 시 사용
disable-model-invocation	false
argument-hint	[Phase 번호] (생략 시 다음 미완료 Phase 자동 선택)

워크플로우: 마일스톤 Phase 실행

목표: milestone.md에서 다음 미완료 Phase를 식별하고, plan.md의 구현 상세를 참고하여 실제 코드를 구현합니다.

1단계: 컨텍스트 로드

프로젝트 루트에서 다음 4개 파일을 읽습니다:

SPEC.md — 요구사항 (기능/비기능 요구사항, 제약조건, 사용자 시나리오)
milestone.md — 작업 목록 및 진행 상태
plan.md — 구현 상세 (아키텍처, 디렉토리 구조, 데이터 흐름 등)
survey.md — 아키텍처 결정 사항

SPEC.md가 없으면 /spec을 먼저 실행하도록 안내합니다.
milestone.md가 없으면 /milestone을 먼저 실행하도록 안내합니다.
plan.md가 없으면 /planner를 먼저 실행하도록 안내합니다.
survey.md가 없으면 /survey를 먼저 실행하도록 안내합니다.

2단계: 대상 Phase 판별

인자로 Phase 번호가 주어진 경우: 해당 Phase를 대상으로 선택합니다.
인자가 없는 경우: milestone.md에서 첫 번째 미완료([ ]) 항목이 포함된 Phase를 자동 선택합니다.
모든 Phase가 완료된 경우: 사용자에게 "모든 마일스톤이 완료되었습니다"를 알리고 종료합니다.

선택된 Phase와 포함된 작업 항목들을 사용자에게 보여주고 진행 여부를 확인합니다.

3단계: 태스크 리스트 생성

해당 Phase의 미완료 체크박스 항목들을 TaskCreate로 태스크 리스트에 등록합니다.

subject: 체크박스의 볼드 텍스트 (작업 제목)
description: 해당 항목의 목표, 포함 내용, 검증 기준 + plan.md에서 관련 구현 상세
activeForm: 작업 제목의 현재진행형 (예: "조건부 서식 데이터 모델 구현" → "조건부 서식 데이터 모델 구현 중")

이미 완료([x])된 항목은 건너뜁니다.

4단계: 구현 실행 (병렬+순차 하이브리드)

4-A: 의존성 분석

Phase의 모든 미완료 태스크를 검토하여 실행 그래프(Layer)를 생성합니다.

의존 관계 판정 기준:

관계	판정	근거
같은 파일 수정	순차	동시 수정 시 충돌
export → import 관계	순차	선행 타입/함수가 있어야 후행 구현 가능
다른 디렉토리, 독립 기능	병렬	충돌 없음
공통 컨텍스트만 참조 (읽기 전용)	병렬	충돌 없음

Layer 생성 예시:

Layer 1: [Task A, Task B]  ← 독립적, 병렬 실행
Layer 2: [Task C]           ← Task A의 export를 import
Layer 3: [Task D, Task E]  ← Task C 완료 후 독립적, 병렬 실행

TaskUpdate로 의존 관계를 addBlockedBy/addBlocks에 등록합니다.

4-B: 에이전트 타입 매핑

각 태스크의 성격에 따라 최적의 에이전트를 선택합니다:

태스크 성격	subagent_type	model	판단 기준
React 컴포넌트 UI 구현	frontend-developer	sonnet	JSX, 스타일, 이벤트 핸들링
타입 정의, 제네릭, 유틸리티 타입	typescript-pro	sonnet	type, interface, 제네릭 제약
API 로직, 비즈니스 로직, 훅	general-purpose	sonnet	데이터 처리, 상태 관리
복잡한 아키텍처 결정 포함	general-purpose	opus	설계 판단이 필요한 경우
보일러플레이트, 설정 파일	general-purpose	haiku	단순 반복 작업

4-C: 병렬+순차 하이브리드 실행

Layer별로 실행합니다:

Layer 내 (병렬):

독립 태스크들은 Task tool로 동시 실행 (run_in_background: true)
각 Task sub-agent에게 전달할 정보:
- 해당 태스크의 description (목표, 구현 상세, 검증 기준)
- SPEC.md, plan.md, survey.md의 관련 섹션 요약
- 준수 사항 (CLAUDE.md 패턴, FSD 원칙, 기존 코드 컨벤션)

Layer 간 (순차):

선행 Layer의 모든 태스크 완료 확인 후 다음 Layer 실행
각 Layer 완료 시 중간 검증 실행:
```
pnpm typecheck
```
typecheck 실패 시: 오류를 분석하고 수정한 후 다음 Layer로 진행

단일 태스크 또는 순차 의존만 있는 경우:

sub-agent 없이 오케스트레이터가 직접 순차 구현 (기존 방식 유지)

각 태스크 완료 시 TaskUpdate로 상태를 completed로 변경합니다.

구현 시 준수 사항

CLAUDE.md의 아키텍처 패턴 및 디렉토리 구조를 따릅니다.
FSD 원칙을 준수합니다.
기존 코드베이스의 패턴과 컨벤션을 따릅니다.
보안 취약점을 도입하지 않습니다.

5단계: 검증

각 작업 항목의 "검증" 기준에 따라 검증을 수행합니다.

pnpm run typecheck — 타입 검사
pnpm run lint — 린트 검사
pnpm run test:unit — 관련 단위 테스트 실행 (테스트가 있는 경우)

검증 실패 시:

오류를 분석하고 수정합니다.
수정 후 다시 검증합니다.
반복적으로 실패하면 사용자에게 보고하고 판단을 요청합니다.

6단계: 마일스톤 업데이트

모든 작업이 완료되면 /milestone-update 스킬을 호출하여:

완료된 체크박스를 [x]로 업데이트합니다.
세션 노트에 구현 요약을 추가합니다.

7단계: 결과 보고

실행 결과를 사용자에게 보고합니다:

완료된 Phase 번호 및 제목
구현된 작업 항목 목록
실행 방식 요약 (병렬 Layer 수, 사용된 에이전트 타입)
검증 결과
다음 미완료 Phase 안내 (있는 경우)