Writing Plans 스킬
승인 설계를 인터페이스와 검증이 있는 검토 가능한 작업으로 전환합니다.
커뮤니티 · Jesse Vincent / Prime Radiant| 작성자 | Jesse Vincent / Prime Radiant |
|---|---|
| 라이선스 | MIT |
| 소스 | obra/superpowers · GitHub의 SKILL.md |
| 프로젝트 웹사이트 | primeradiant.com/superpowers |
| 작동 환경 | Claude Code · Codex, Gemini CLI, Cursor, Copilot |
| 소스 확인 날짜 |
writing-plans는 승인 명세를 이전 맥락이 없는 개발자용 구현 계획으로 만듭니다. 정확한 경로, 인터페이스, 제약, 검증 명령을 기록합니다.
계획은 인계 문서이며 구현 완료가 아닙니다. 일관된 변경 단위에 입출력을 명시해 별도 개발자를 조율합니다.
스킬의 SKILL.md에서: writing-plans
하는 일
- 승인 명세를 읽고 관련 코드를 확인합니다.
- 전체 제약, 인터페이스, 검토 가능한 작업을 정의합니다.
- 계획을 자체 검토하고 실행 방식을 합의합니다.
얻을 수 있는 결과물
- docs/superpowers/plans/YYYY-MM-DD-<feature>.md에 단계와 검증을 포함한 계획.
이럴 때 사용하세요
- 대화를 읽지 않은 개발자에게 다단계 변경을 인계할 때.
이럴 때는 맞지 않습니다
- 요구 사항이 미정이면 먼저 brainstorming을 쓰세요.
필요한 것
- 승인 명세, 파일 처리 에이전트, 프로젝트 접근.
- 실행·테스트·커밋은 프로젝트 도구와 권한이 필요합니다.
스킬에 들어 있는 파일
| 파일 또는 폴더 | 용도 |
|---|---|
SKILL.md | 계획 구조, 작업 크기, 인계 조건. |
2026-11-19 기준 저장소에 있는 라이선스: MIT.
예시 프롬프트
설치한 뒤 아래 중 하나를 입력해 보세요. 스킬 이름을 넣으면 그 스킬이 확실히 사용됩니다.
- 승인 설계를 명시적 인터페이스와 검증 명령이 있는 계획으로 바꾸세요.
- 파일당 한 작업이 아니라 일관된 변경 단위인지 확인하세요.
- 새 개발자용 마이그레이션 계획과 전체 제약을 작성하세요.
writing-plans 설치 방법
설치와 권한
전체 플러그인은 brainstorming·실행 스킬과 연결됩니다. 계획 폴더에는 SKILL.md만 있습니다.
원본 계획은 테스트 우선 단계와 커밋을 포함합니다. 저장소 규칙에 맞추세요. 계획 작성은 실행이 아닙니다.
스킬은 SKILL.md 파일이 든 폴더입니다. 한 번만 설치하면, 에이전트가 세션을 시작할 때마다 짧은 설명을 읽고 요청이 맞을 때만 전체 지침을 불러옵니다. 사용하는 곳을 고르세요.
Claude Code: 플러그인 마켓플레이스에서 설치
- 터미널에서
claude로 Claude Code를 시작합니다. - 이 플러그인은 Anthropic의 공식 마켓플레이스에 있으며, Claude Code를 처음 시작할 때 자동으로 추가됩니다.
- 플러그인을 설치합니다. Claude Code가 먼저 세부 정보를 보여 줍니다. 무엇이 추가되는지(스킬, 훅, MCP 서버) 확인한 다음, 나만 쓸지, 이 저장소의 모든 사람이 쓸지, 이 저장소에서 나만 쓸지 고르세요.
/plugin install superpowers@claude-plugins-official - /를 입력해
/superpowers:writing-plans가 있는지 확인하거나, 그냥 작업을 요청하세요.
세션 대신 셸에서 설치하려면:
claude plugin install superpowers@claude-plugins-officialClaude Code: 스킬 폴더에 복사
이 컴퓨터의 모든 프로젝트에서 쓰려면 스킬 폴더를 ~/.claude/skills/에 넣고, 저장소에서 함께 작업하는 모든 사람과 공유하려면 저장소 안의 .claude/skills/에 넣으세요(커밋하세요).
git clone --depth 1 https://github.com/obra/superpowers.git
mkdir -p ~/.claude/skills
cp -R superpowers/skills/writing-plans ~/.claude/skills/Claude Code는 세션 중에도 이 폴더의 새 스킬이나 변경된 스킬을 알아챕니다. 세션을 시작할 때 skills 폴더가 없었다면 /reload-skills를 한 번 실행하세요. 그런 다음 /writing-plans를 입력하거나 작업을 설명하면 됩니다.
Windows에서는 Git Bash나 WSL에서 명령어를 실행하거나, 파일 탐색기로 같은 위치에 폴더를 복사하세요.
Codex, Gemini CLI, Cursor, GitHub Copilot
이 에이전트들은 같은 SKILL.md 폴더를 읽습니다. 네 가지 모두가 프로젝트 안에서 인식하는 폴더는 .agents/skills/이므로, 아래 명령은 스킬을 그곳에 복사합니다.
git clone --depth 1 https://github.com/obra/superpowers.git
mkdir -p .agents/skills
cp -R superpowers/skills/writing-plans .agents/skills/| 에이전트 | 프로젝트 폴더 | 사용자 폴더 | 참고 |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | $를 입력하거나 /skills를 실행해 스킬을 고르세요. 작업이 맞으면 Codex가 스스로 스킬을 고르기도 합니다. |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | 또는 gemini skills install <git URL> --path <folder> --consent로 Git에서 설치하세요. Google은 2026년 6월 18일 무료 등급과 Google One 사용자의 Gemini CLI를 Antigravity CLI로 대체했습니다. Antigravity는 프로젝트에서는 .agents/skills/를, 사용자용으로는 ~/.gemini/config/skills/를 사용합니다. |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | Agent 채팅에서 /를 입력해 스킬을 고르세요. Cursor는 Claude Code의 .claude/skills/ 폴더도 읽습니다. |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | Copilot CLI, 클라우드 에이전트, 그리고 VS Code, Visual Studio, JetBrains의 에이전트 모드에서 작동합니다(IDE 지원은 버전에 따라 다름). 또는 gh skill install OWNER/REPOSITORY SKILL를 실행하세요(공개 프리뷰, GitHub CLI 2.90.0 이상). |
이 단계의 출처
2026-11-14에 각 업체의 문서와 대조해 확인했습니다:
맥락 변경에도 남는 계획
전체 제약은 여러 작업에 적용됩니다. 인터페이스는 단계별 입출력을 명시해 인계 시 숨은 가정을 줄입니다.
실행 전 검토하세요. 자세한 명령도 실행하고 결과를 확인하기 전에는 제안일 뿐입니다.
writing-plans에 관한 질문
계획도 실행하나요?
아니요. 작성·검토 후 합의된 실행 방식으로 인계합니다.
작업에는 어떤 맥락이 필요한가요?
정확한 경로, 인터페이스, 제약, 구현 단계, 구체적인 검증 명령입니다.
파일마다 별도 작업인가요?
아니요. 일관되고 검토 가능한 변경이어야 하며 파일 경계만으로 나누지 않습니다.
유료 서비스가 필요한가요?
추가 서비스는 지정하지 않지만 에이전트 구독이나 API 비용은 발생할 수 있습니다.
더 많은 AI 스킬
관련 스킬
Brainstorming 스킬
커뮤니티 · Jesse Vincent / Prime Radiant구현 전에 초기 아이디어를 합의된 설계로 정리합니다.Subagent-Driven Development 스킬
커뮤니티 · Jesse Vincent / Prime Radiant새 구현자, 범위 제한 검토, 작업 기록으로 승인 계획을 실행합니다.planning-with-files 스킬
커뮤니티 · OthmanAdi긴 작업의 계획과 진행을 파일에 남기고 호스트별 훅을 활용합니다.To-Spec 스킬
커뮤니티 · Matt Pocock합의된 결정을 명세로 기록하고 설정된 이슈 도구에 게시합니다.To-Tickets 스킬
커뮤니티 · Matt Pocock명세를 시연 가능한 수직 단위로 나누고 차단 의존성을 명시합니다.n8n 자체 호스팅 스킬
커뮤니티 · Romuald CzłonkowskiDocker 기반 n8n을 배포·유지하며 Caddy HTTPS, 비공개 서비스와 검증된 백업을 구성합니다.