커맨드(Command)와 워크플로우

커맨드의 역할

커맨드는 트리거 버튼이다. 사용자가 커맨드를 입력하면, 정해진 에이전트를 호출하고, 그 에이전트가 스킬을 실행한다. Command → Agent → Skill 체인이 자동으로 작동한다.

현재 Claude Code는 skills 기반 구성을 권장하지만, .claude/commands/ 방식도 여전히 호환된다. 이 문서의 /sdd.* 흐름은 SDD 실습을 설명하기 위한 커스텀 명령 체계로 이해하면 된다.

커맨드 파일 구조

전통적인 커맨드 방식은 .claude/commands/sdd.{이름}.md 파일로 정의한다. 다만 신규 구성을 만들 때는 같은 워크플로우를 skills 중심으로 구성하는 편이 현재 Claude Code 문서와 더 잘 맞는다.

Front Matter 예시

---
description: Planner 에이전트를 호출하여 PRD를 작성. 기획, 요구사항 정의, PRD 작성 요청 시 사용.
allowed-tools: Read, Write, Edit
---

필드	설명
description	설명 + 트리거 키워드
allowed-tools	커맨드 실행 중 사용할 수 있는 도구

category, complexity 같은 추가 메타데이터는 SDD 강의 규약 예시로는 쓸 수 있지만, Claude Code의 기본 필수 필드는 아니다.

6개 커맨드 상세

sdd.init — 프로젝트 초기화

• 에이전트: 없음 (직접 실행)
• 전제 조건: 없음
• 출력: 기본 폴더 구조 + 빈 문서 파일

sdd.plan — PRD 작성

• 에이전트: Planner (10년차 PM)
• 전제 조건: 없음
• 동작: 사용자에게 질문 → 답변 기반으로 PRD 작성

sdd.design — Tech Spec 작성

• 에이전트: Architect (시스템 아키텍트)
• 전제 조건: PRD 필요
• 동작: PRD 읽기 → 기술 스택 결정 → Tech Spec 작성

sdd.build — 코드 구현

• 에이전트: Developer (시니어 풀스택 개발자)
• 전제 조건: PRD + Tech Spec 모두 필요
• 동작: 두 문서를 읽고 → Spec에 명시된 구조대로 코드 구현

sdd.review — 스펙 검증

• 에이전트: Reviewer (QA 엔지니어)
• 전제 조건: 모든 문서 필요 (PRD + Spec + 코드)
• 동작: 3단계 검증 (PRD 일치 → Spec 일치 → 코드 품질)

sdd.auto — 자동 라우팅 (다음 문서에서 상세 설명)

• 에이전트: 자동 결정
• 전제 조건: 자동 판단
• 동작: 자연어 분석 → 적절한 단계로 자동 라우팅

전제 조건 체인 전체 도식

핵심: 각 단계에 전제 조건이 있어서 순서를 건너뛸 수 없다. 전제 조건이 미충족이면 자동으로 이전 단계로 유도된다. 이것이 "문서 없이 코드를 만드는 상황"을 시스템적으로 방지한다.