AI사용팁

[허들링 클럽] 기획서 1페이지 해독 가이드 (spec-decode)

2026. 11. 8.

🐧 장황한 AI 기획서, 1장으로 줄이기

"AI가 다 정리해 줬는데요?" 하며 던진 수백장의 기획서, 버디가 1장으로 줄이고 칼퇴한 방법을 그대로 나눠드려요.

spec-decode는 허들링 클럽에서 만든 Claude 스킬이에요. 긴 기획서를 디자이너 관점에서 읽고, 바로 디자인을 시작할 수 있는 1페이지 요구사항 문서로 정리해 줘요. 내 팀 상황에 맞게 고쳐 쓰는 스타터 스킬이에요.

🤔 이럴 때 쓰세요

팀원 혹은 협업자가 AI로 뽑은 긴 문서를 제공했을 때

다 읽었는데도 "그래서 내가 뭘 만들면 되지?" 싶을 때

물어보면 "그거 AI가 정리한 거라서요"라는 답이 돌아올 것 같을 때

📄 이렇게 나와요

기획서와 같은 폴더에 요구사항_1p.md가 생겨요. 릴스 속 친구 초대 이벤트 기획서를 넣으면 이런 모양이에요.

markdown

# 요구사항 1페이지 — 친구 초대 이벤트 페이지
원본: AI기획서_최종_진짜최종.docx, 123페이지 → 1페이지 · 화면 3개

## 📌 한 줄 요약
친구를 초대하면 나와 친구가 둘 다 포인트를 받는 이벤트

## 🗂 화면별 요구사항
### 1. 이벤트 메인 — 혜택을 보여주고 초대를 유도
- 혜택 카드: 나 / 친구 금액 나란히 (8.2-1)
- 참여 방법 3단계, 내 초대 현황 요약 (8.2-1)
- [친구 초대하기] → 2번 화면 (8.1)
### 2. 공유 바텀시트 — 초대 링크 보내기
- 카카오톡, 링크 복사 두 가지만 (7.2)
### 3. 내 초대 현황 — 결과 확인
- 초대한 친구 수, 받은 포인트 (7.4)

## 🎨 공통 규칙
- 흰 배경, 혜택 카드는 라이트그레이 (8.2-1)
- 검정은 주요 버튼에만, 이모지·배지 없음 (8.2-1)

## ⚠️ 확인 필요
- 참여 대상 충돌: 신규 30일 vs 전체 (5.1, 7.1) (가정: 전체 회원)
- 포인트 금액 미확정 (7.3) (가정: 3,000P)
- 오픈일 2개: 11월 말 vs 12월 첫째 주 (12장)
- 빈 화면·에러 상태 정의 없음

## 💬 기획자 공유 메시지
해피님, 참여 대상과 포인트 금액, 오픈일만 정해주시면 바로 디자인 들어갈게요!

결과는 Claude가 만들 때마다 조금씩 달라져요. 구조(요약 → 화면별 → 공통 규칙 → 확인 필요 → 공유 메시지)는 항상 같아요.

⚡ 2단계로 시작하기

1️⃣ 스킬 등록

아래 '📦 스킬 파일'의 내용을 SKILL.md 파일로 저장해 spec-decode 폴더에 넣어요.

Claude 앱 (웹·데스크톱)

spec-decode 폴더를 zip으로 압축해요

설정 → Customize → Skills → + → Create skill → Upload a skill

같은 계정으로 로그인한 Claude Code에서도 바로 쓸 수 있어요

Claude Code만 쓴다면

~/.claude/skills/spec-decode/ 폴더에 SKILL.md를 넣어요

Claude Code를 다시 열어요

2️⃣ 실행

기획서를 첨부하고 입력해요.

plain text

/spec-decode 첨부한 기획안 요약해줘

근거까지 보고 싶으면 "자세히"를, 내 시안과 비교하고 싶으면 "시안이랑 비교해줘"를 덧붙이면 돼요.

🎨 그다음: 바로 화면 만들기

정리된 1페이지를 그대로 넘기면 첫 화면까지 바로 뽑을 수 있어요.

plain text

요구사항_1p.md 이 문서대로 화면 직접 만들어줘.

문서가 기준이 돼서, 대화 기억에 기대는 것보다 결과가 덜 흔들려요. 화면이 여러 개면 "1번 화면부터"처럼 번호를 짚어 주면 더 깔끔해요. 피그마에 바로 그리는 법은 『피그마 디자인 10분 레시피』 개정판에 담았어요.

📋 스킬이 어렵다면: 프롬프트 버전

설치 없이 기획서와 함께 붙여 넣으면 비슷한 결과가 나와요.

plain text

첨부한 기획서를 디자이너 관점에서 1페이지로 정리해줘.
화면이 여러 개면 화면별로 나눠줘.

📌 한 줄 요약
🗂 화면별 요구사항 (꼭 들어갈 정보·버튼, 다음 화면, 근거 장·섹션)
🎨 공통 규칙 (브랜드·디자인 가이드)
⚠️ 확인 필요 (충돌하거나 비어 있는 것, 일단 쓸 가정값)
💬 기획자 공유 메시지 (한두 문장)

규칙: 한 줄은 30자 안팎, 문서에 없는 내용은 지어내지 말고 '문서에 없음'으로.

❓ 자주 묻는 질문

Q. 화면이 여러 개인 기획서도 되나요? A. 네. 화면을 먼저 다 찾고 화면별로 나눠 정리해요. 화면이 많을수록 화면당 줄 수를 줄여서 1페이지를 지켜요.

Q. 문서에 없는 내용을 지어내진 않나요? A. 없는 내용은 '문서에 없음'으로 적게 되어 있어요. 항목마다 근거 장·섹션도 적어서, 원문을 바로 확인할 수 있어요. 그래도 중요한 결정은 꼭 원문과 기획자에게 확인하세요.

Q. PDF나 노션 기획서도 되나요? A. PDF·Word·마크다운은 파일로 첨부하면 돼요. 노션은 페이지를 마크다운이나 PDF로 내보낸 뒤 첨부하는 게 가장 확실해요.

📦 스킬 파일

zip을 받아 Claude 앱에 바로 업로드하거나, 아래 토글에서 SKILL.md 내용을 복사해 쓰세요.

spec-decode.zip

🐧 허들링 클럽

이 가이드는 허들링 클럽 릴스 〈해피 사원의 123장 기획서〉 편과 함께 만들었어요.

칼퇴한 버디의 자리를 마카 부장이 지켜보고 있었는데… 다음 편에서 만나요!

이런 AI 활용법을 더 배우고 싶다면, 허들링 클럽 4기 대기 신청을 남겨주세요.