# 구현 계획 작성 (writing-plans)

> 스펙이나 요구사항을 파일, 인터페이스, 테스트가 명시된 작은 작업 단위의 구현 계획으로 작성합니다.

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

## 핵심 규칙

모든 단계는 구현자가 합리적인 것 하나만 쓸 수 있어야 하며, 모호한 줄도 코드 전체를 대신 써 주는 것도 안 됩니다.

## 실행 단계

1. **범위 확인** — 스펙이 여러 독립 하위 시스템을 다루면 하위 시스템별로 계획을 나누도록 제안합니다.
2. **파일 구조 설계** — 생성하거나 수정할 파일과 각 파일의 책임을 먼저 정리하고, 기술 계층이 아닌 책임 단위로 나눕니다.
3. **작업 작성** — 정해진 헤더와 템플릿으로 각 작업의 파일, 인터페이스, TDD 단계(실패 테스트, 실행, 최소 구현, 재실행, 커밋)를 작성합니다.
4. **자체 검토** — 스펙과 대조해 범위, 단계의 명확성, 타입 일관성, Review Focus, 분량을 점검하고 바로 고칩니다.
5. **실행 인계** — docs/superpowers/plans/에 저장한 뒤 검토를 요청하고 Subagent-driven과 Native 중 실행 방식을 고르게 합니다.

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

| 기능 | 필요 여부 | 설명 |
|---|---|---|
| 파일 쓰기 | 일부 필요 | 계획 문서만 작성하며 기본 위치는 docs/superpowers/plans/입니다. 코드는 수정하지 않습니다. |
| 명령 실행 | 필요 없음 | 테스트와 커밋 명령은 계획에 적기만 하고 이 스킬이 직접 실행하지는 않습니다. |
| 네트워크 송신 | 필요 없음 | 로컬 스펙과 코드베이스만으로 작성하며 네트워크를 사용하지 않습니다. |

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

```yaml
---
name: writing-plans
description: Use when you have a spec or requirements for a multi-step task, before touching code
---
```

홈: https://www.myskills.tools/ko/ · URL: https://www.myskills.tools/ko/skills/writing-plans/