이 포스트는 다음 패키지에 관한 것입니다: https://www.npmjs.com/package/oh-my-sdd

**명세 기반 개발 (Spec-Driven Development, SDD)**을 엄격하게 강제하는 Claude Code용 글로벌 스킬 세트입니다. 어떤 작업을 구현하기 전에, Claude는 프로젝트를 분석하고 constitution.md → spec.md → plan.md → tasks.md를 생성하며, 구현을 시작하기 전에 반드시 인간의 검증을 거쳐야 합니다.

📖 문서 (Documentation): https://slpascoal.github.io/oh-my-sdd/

설치 (Installation)

npx oh-my-sdd install

이 명령은 6개의 스킬을 ~/.claude/skills/에 전역적으로 설치하며, Claude Code에서 열린 모든 프로젝트에서 사용할 수 있습니다. 설치는 명령이 실행되는 디렉토리에 의존하지 않습니다.

아키텍처 (Architecture)

오케스트레이터(Orchestrator) 스킬(oh-my-sdd)이 활성화되면, SDD 단계별로 특화된 5개의 스킬을 순차적으로 실행합니다:

1. /oh-my-sdd: 흐름을 조율하고, 입력(자유 텍스트 또는 Jira)을 식별하며, 다른 스킬들을 순서대로 활성화합니다.
2. /oh-my-sdd-constitution: 프로젝트(스택, 컨벤션, 린트)를 분석하고 .oh-my-sdd/constitution.md를 생성/확인하며, 추론할 수 없는 내용에 대해서만 사용자에게 질문합니다.
3. /oh-my-sdd-specify: EARS/GEARS 방식으로 spec.md를 생성합니다 — 첫 번째 인간 검증 지점 (human checkpoint #1).
4. /oh-my-sdd-plan: 검증된 명세를 기술적 결정 사항(plan.md)으로 변환합니다.
5. /oh-my-sdd-tasks: 계획을 원자적 작업(tasks.md)으로 변환합니다 — 두 번째 인간 검증 지점 (human checkpoint #2).
6. /oh-my-sdd-implement: 두 검증 지점이 모두 확인된 후에만 작업별로 구현을 진행합니다.

설치된 각 스킬은 독립적입니다. 각 스킬은 각 단계가 문서를 생성하는 근간이 되는 SDD 지식 베이스(성숙도 단계, EARS/GEARS 구문, 아티팩트 계층 구조, 실무 예시)인 knowledge/의 자체 복사본을 가집니다.

사용법 (Usage)

설치가 완료되면, 구현 전에 명세가 정의되어야 하는 작업이 있을 때마다 Claude Code가 자동으로 흐름을 감지합니다. 또한 직접 호출할 수도 있습니다:

/oh-my-sdd "리프레시 토큰 (refresh token)을 무효화하는 로그아웃 엔드포인트 (endpoint)를 추가해줘"
/oh-my-sdd PROJ-123
/oh-my-sdd https://company.atlassian.net/browse/PROJ-123

기타 명령어 (Other commands)

npx oh-my-sdd status      # 6개의 스킬 중 어떤 것이 설치되어 있는지, 그리고 파일이 수동으로 수정되었는지 여부를 보여줍니다.
npx oh-my-sdd uninstall   # ~/.claude/skills/ 디렉토리에서 6개의 스킬을 제거합니다.

지식 베이스 (Knowledge base)

knowledge/ 폴더에는 모든 스킬에서 사용되는 SDD의 기본 원칙들이 문서화되어 있습니다: 성숙도 단계 (spec-first, spec-anchored, spec-as-source), 명세서 (spec) 및 헌법 (constitution) 작성을 위한 베스트 프랙티스 (best practices), EARS/GEARS 구문, 그리고 완전한 실무 예시들이 포함되어 있습니다.