reborn-spec — 코드 전에 명세

클로드에게 「이거 만들어줘」 하면 자신 있게 만들어 오는데, 원한 것과 다른 것이 섞여 온다. 이 스킬은 코드를 쓰기 전에 명세 → 계획 → 조각 → 코드 순서로 가게 하고, 단계마다 사람이 확인하기 전에는 다음으로 안 간다. 순서와 칸 이름은 GitHub 의 오픈소스 spec-kit(MIT · github.com/github/spec-kit)을 한국어로 옮겼다.

npx --yes reborn-spec

무엇이 깔리나

| 스킬 | 하는 일 | 자리 | |---|---|---| | spec | 명세 → 계획 → 조각 → 코드 절차 + 한국어 템플릿 3장(명세.md · 계획.md · 조각.md) + 이 폴더 점검. 「명세부터 잡자」 라고 말하면 뜬다 | ~/.claude/skills/spec/ | | spec-ko-guide | 한국어 안내 — spec-kit 본체가 무엇이고 uv 로 어떻게 까나 · 우리 스킬과 본체의 관계 · 하지 않는 것 | ~/.claude/skills/spec-ko-guide/ |

깔고 나면 클로드 코드에 그냥 말하면 된다.

명세부터 잡자: 사진을 날짜별 앨범으로 묶고 드래그로 순서를 바꾸는 웹앱
계획 짜줘
조각으로 나눠줘
1번 조각 만들어줘

※ 새 스킬은 클로드 코드를 한 번 다시 켜야 잡힌다.

네 단계

| # | 단계 | 무엇 | 다음으로 가는 조건 | |---|---|---|---| | 1 | 명세 specs/<기능>/명세.md | 무엇을·왜 — 사용자 이야기(P1·P2·P3) · 인수 시나리오 · 요구사항 · 재는 성공 기준 · 미결 질문. 「어떻게」는 안 적는다 | 미결 질문 0 + 사용자 「맞다」 | | 2 | 계획 계획.md | 여기서 처음 「어떻게」 — 언어 · 의존성 · 저장 · 구조 · 검증 | 사용자 확인 | | 3 | 조각 조각.md | 한 번에 확인할 크기로 쪼갠다 — 조각마다 끝났다는 증거 · P1 부터 통째로 | 사용자 확인 | | 4 | 코드 | 조각 순서대로 · 한 조각마다 증거를 보이고 멈춘다 · 건너뛰지 않는다 | 조각마다 |

spec-kit 본체와의 관계

이 패키지에 본체는 들어 있지 않다. 본체는 Python 3.11+ 와 uv 로 따로 깐다:

uv tool install specify-cli
specify init 내프로젝트 --integration claude      # 프로젝트 .claude/skills 에 /speckit-* 스킬 10종

같은 폴더에 본체가 깔려 있으면(.claude/skills/speckit-specify/) 우리 spec 스킬은 물러나고 /speckit-specify 부터 하라고 안내한다. 본체가 없으면 우리 스킬이 같은 순서를 직접 밟는다. 본체의 헌법(constitution) · 수렴(converge) · 확장(버그 수정 · 아이디어 평가)은 본체에서만 된다.

먼저 본다

npx --yes reborn-spec --check

깔지 않고 이 폴더에 spec-kit 본체 · uv · specs/ 가 있는지만 본다.

| 플래그 | | |---|---| | --check | 보기만 한다 | | --dry-run | 무엇이 어디로 갈지 보여주기만 한다 | | --local | 현재 폴더 .claude/skills 에 놓는다 | | --force | 이미 있어도 덮어쓴다 | | --self-test | 자기시험 (네트워크 안 씀) |

사실 (2026-09-22 확인)

• github/spec-kit — MIT · 별 138,253 · 최신 v1.0.9 (2026-09-21). 클로드 코드 통합은 프로젝트 .claude/skills 에 스킬을 깐다.
• 우리 템플릿의 칸 이름·순서는 본체 spec-template.md · plan-template.md · tasks-template.md 를 옮긴 것이고, 각 파일 첫 줄에 출처를 적었다.

하지 않는 것

• spec-kit 본체를 대신한다고 말하지 않는다. 같은 순서를 밟는 한국어 절차다.
• 미결 질문을 그럴듯한 값으로 채우지 않는다 — 묻는다.
• 「명세를 쓰면 틀린 코드가 사라진다」 고 말하지 않는다. 추측할 자리가 줄어드는 것뿐이다.
• 별 수·비율을 오늘 잰 값 밖에서 말하지 않는다.

라이선스

이 패키지(설치기 · 한국어 스킬 · 안내): 단일 사용자 / 단일 회사. 재판매·재배포하지 않는다. 템플릿 칸 이름·순서의 원본 spec-kit 은 MIT (Copyright GitHub, Inc.).