# 계획과 작업 분해 (planning-and-task-breakdown)

> 작업을 의존 순서로 정렬된 작은 작업으로 나누고, 인수 기준과 검증 단계를 담은 계획 문서와 작업 목록을 만듭니다.

- 카테고리: [작업 분해](https://www.myskills.tools/ko/categories/task-breakdown/)
- 출처: 커뮤니티 · Addy Osmani
- 저장소: https://github.com/addyosmani/agent-skills/tree/main/skills/planning-and-task-breakdown (commit 8300e1b)
- SKILL.md: https://github.com/addyosmani/agent-skills/blob/main/skills/planning-and-task-breakdown/SKILL.md
- 설치 명령: `npx skills add addyosmani/agent-skills --skill planning-and-task-breakdown`
- 라이선스: MIT
- 호환 도구: Claude Code, Codex, Cursor, Copilot, Gemini CLI
- 권한: read-repo ✓, write-files ✓, shell ✗, network ✓
- 상태: 스캔 통과
- 규칙 스캔으로 모든 위험을 찾을 수는 없습니다. 설치 전에 이 스킬의 SKILL.md를 읽고 권한을 확인하세요.

## 핵심 규칙

모든 작업은 한 번의 집중 세션에서 구현, 테스트, 검증까지 끝낼 수 있을 만큼 작아야 하며 명확한 인수 기준을 가져야 합니다.

## 실행 단계

1. **계획 모드 진입** — 읽기 전용으로 스펙과 관련 코드를 읽고 기존 패턴, 의존성, 위험, 미지수를 파악하며, 이때 코드는 쓰지 않습니다.
2. **의존성과 수직 분할** — 의존성 그래프를 그려 기반부터 순서를 정하고, DB·API·UI 계층별이 아닌 기능 경로 단위로 수직 분할합니다.
3. **작업 작성** — 각 작업에 설명, 인수 기준, 검증, 의존성, 관련 파일, 규모를 적고 L 이상이면 더 나눕니다.
4. **순서와 체크포인트** — 의존성을 지키고 위험한 작업을 앞에 두며, 2~3개 작업마다 검증 체크포인트를 둡니다.
5. **저장과 확인** — tasks/plan.md와 tasks/todo.md(또는 지정된 트래커)에 저장하되 미완료 계획은 덮어쓰지 않고 사용자 승인을 받습니다.

## 권한 설명 (SKILL.md 기준)

| 기능 | 필요 여부 | 설명 |
|---|---|---|
| 파일 쓰기 | 일부 필요 | tasks/plan.md와 작업 목록(기본 tasks/todo.md)만 쓰며 계획 중에는 코드를 쓰지 않습니다. |
| 명령 실행 | 필요 없음 | 테스트와 빌드 명령은 작업의 검증 항목에 적기만 하고 계획 단계에서 실행하지 않습니다. |
| 네트워크 송신 | 일부 필요 | 프로젝트나 사용자가 외부 트래커(GitHub Issues, Jira, Linear 등)를 지정한 경우에만 그곳에 항목을 만듭니다. |

## SKILL.md 프런트매터(YAML)

```yaml
---
name: planning-and-task-breakdown
description: Breaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.
---
```

홈: https://www.myskills.tools/ko/ · URL: https://www.myskills.tools/ko/skills/planning-and-task-breakdown/