요구사항 조율부터 PR (Pull Request) 머지 (Merge)까지, 전체 소프트웨어 개발 워크플로우를 통해 Claude를 여러 AI 워커 에이전트 (Worker Agents)를 조율하는 **테크 리드 (Tech Lead)**로 변모시키는 Claude Code용 커스텀 스킬입니다.

대부분의 AI 코딩 도구는 스마트한 자동 완성 기능을 제공합니다. /dev는

**엔지니어링 프로세스 (Engineering Process)**를 제공합니다.

/dev 미사용 시	/dev 사용 시
Claude가 채팅창에서 직접 코드를 작성함	Claude가 테크 리드 (Tech Lead) 역할을 수행하며, 직접 코드를 작성하지 않음
...	```
You: /dev 사용자 인증과 작업 관리가 포함된 Todo 앱을 만들고 싶어
Claude (Tech Lead)
│
...

`/dev`는 다음과 같은 내용을 포함하는 **멀티 에이전트 소프트웨어 개발 SOP (Standard Operating Procedure)**입니다:

**Phase 0**— 요청 분류 및 라우팅 (신규 프로젝트 / 신규 기능 / 버그 수정 / 긴급 핫픽스 / 아키텍처 변경 / 리팩토링 (Refactoring))
**Phase 1**— 제품 정렬 (기존 PRD (Product Requirements Document)를 사용하거나, 두 단계에 걸쳐 생성)
**Phase 2**— 아키텍처 결정 + 작업 분해 + GitHub 이슈 (Issue) 생성
**Phase 3**— 여러 워커 에이전트 (Worker Agents)가 **병렬로** 개발 (각각 격리된 워크트리 (Worktree)에서 수행)
**Phase 3.5**— QA 에이전트 (QA Agent)의 정적 검증
**Phase 4**— 코드 리뷰 (Code Review) + 머지 (Merge) (거부권(Veto) 조건이 포함된 7개 항목의 구조화된 체크리스트)
**Phase 5**— 회고 (Retro) + 다음 반복 (Iteration) 루프

**테크 리드 (Tech Lead) 철칙**: 메인 대화에서는 절대 코드를 직접 작성하지 않습니다 — 모든 변경 사항은 워커 에이전트 (Worker Agent) → PR → 리뷰 (Review) 과정을 거칩니다.
**6개 카테고리 반례 셀프 체크 (6-category counterexample self-check)**: 워커 에이전트 (Worker Agents)는 제출 전 Null / Empty / 경계값 (Boundary) / 외부 실패 (External failure) / 동시성 (Concurrency) / 악의적 입력 (Malicious input)을 반드시 검토해야 합니다.
**코딩 전 충돌 확인 (Pre-coding conflict check)**: 워커 에이전트 (Worker Agents)는 시작 전 파일 중복 여부를 확인하기 위해 열려 있는 다른 이슈 (Issues)들을 스캔합니다.
**머지 후 PR 조율 (Post-merge PR coordination)**: 모든 머지 (Merge) 후, 열려 있는 PR (Pull Requests)을 스캔하고 리베이스 (Rebase)가 필요한 브랜치에 알림을 보냅니다.
**보안 게이트 (Security gate)**: 리뷰 (Review) 전 `bandit` + `pip-audit` / `npm audit`을 의무적으로 실행합니다.
**데이터베이스 마이그레이션 가드 (Database migration guard)**: 직접적인 DDL 작업 (ALTER TABLE / DROP COLUMN)은 의무적인 거부권 (Veto)을 트리거합니다.

| 도구 (Tool) | 비고 (Notes) |
|---|---|
| Claude Code | Anthropic 공식 CLI, 로그인 필요 |
| GitHub CLI (`gh`) | Issues, PRs, repos를 위해 — 먼저 `gh auth login`을 실행하세요 |
| Git | 버전 관리 (Version control) |

**옵션 1: 스크립트 (권장)**

macOS / Linux — 영어 버전

bash install.sh --lang en

macOS / Linux — 중국어 버전

...

**옵션 2: 수동 (Manual)**

`en/commands/` (또는 `zh/commands/`)의 모든 파일을 디렉토리 구조를 유지한 채 `~/.claude/commands/`로 복사하세요:

~/.claude/commands/
dev.md
dev/
...

Claude Code에서 다음과 같이 입력하세요:

/dev [선택적 설명]

예시:

/dev 사용자 등록 및 작업 관리가 포함된 Todo 앱을 만들고 싶어
/dev

Claude는 요청 유형을 자동으로 분류하고 그에 해당하는 흐름 (flow)으로 진입합니다.

claude-dev-skill/
├── README.md # 이 파일 (영어)
├── README.zh.md # 중국어 버전
...

**가장 적합한 경우:**

- 새로운 중소규모 웹 백엔드 (web backend) / API 프로젝트
- 체계적인 개발이 필요한 기존 PRD (제품 요구 사항 문서)가 있는 기능 모듈
- 병합 충돌 (merge conflicts)을 피하고 싶은 병렬 다중 기능 개발

**적합하지 않은 경우:**

- 운영 환경 배포 (production deployment)가 필요한 프로젝트 (DevOps/배포 기능 없음)
- 대량의 기존 데이터가 포함된 복잡한 데이터베이스 마이그레이션 (database migrations)
- 높은 컴플라이언스 보안 요구 사항 (금융, 의료)

이슈 (Issues)와 PR (Pull Requests)은 언제나 환영합니다. 새로운 단계, 에이전트 역할 (agent roles), 또는 언어 지원에 대한 아이디어가 있다면 먼저 이슈 (Issue)를 열어 논의해 주세요.

MIT — LICENSE 참조