dev

dev-plugin

WBS 기반 TDD 개발 자동화 플러그인 — 설계→TDD구현→테스트→리팩토링 사이클과 팀 병렬 개발을 지원하는 Claude Code 플러그인

목차

• Features
• 설치
• 포함된 스킬
• 사용법
• 프로젝트 요구사항
• Architecture
• 관리
• 문제 해결

---

Features

• WBS-driven development — PRD/TRD에서 WBS를 생성하고, Task 단위로 전체 개발 사이클(DDTR)을 자동 수행
• TDD by default — 테스트를 먼저 작성하고 구현하여 통과시키는 TDD 워크플로우
• Team parallel execution — tmux 기반 다중 세션으로 Work Package 단위 병렬 개발
• Agent pool — tmux 없이도 서브에이전트 슬롯 풀 패턴으로 병렬 실행 가능

---

설치

Step 1. 마켓플레이스 등록

/plugin marketplace add jongik-sv/dev-plugin

Step 2. 플러그인 설치

# 사용자 레벨 (모든 프로젝트에서 사용)
/plugin install dev@dev-tools --scope user

# 또는 프로젝트 레벨 (현재 프로젝트에서만 사용)
/plugin install dev@dev-tools --scope project

Step 3. 설치 확인

# 플러그인 목록 확인
/plugin list

# 스킬 목록에서 dev: 네임스페이스 확인
/skills

10개 스킬이 표시되면 설치 완료: wbs, agent-pool, team-mode, dev-team, dev, dev-design, dev-build, dev-test, dev-refactor, dev-help

---

포함된 스킬

병렬 실행 엔진 (Layer 1) — WBS 의존성 없이 범용 사용 가능:

스킬	설명	사용법
agent-pool	N개의 서브에이전트를 슬롯 풀 방식으로 병렬 실행 (tmux 불필요)	/agent-pool [task-file] [--pool-size N]
team-mode	N개의 독립 claude 세션을 tmux pane으로 병렬 실행	/team-mode [manifest] [--team-size N]

개발 자동화 (Layer 2) — WBS Task 단위 개발 사이클:

스킬	설명	사용법
wbs	PRD/TRD로부터 WBS 생성 (규모별 3/4단계 자동 선택)	/wbs [--scale large|medium]
dev	전체 개발 사이클 오케스트레이터 (설계→TDD→테스트→리팩토링)	/dev TSK-00-01
dev-design	설계 단계 — design.md 생성	/dev-design TSK-00-01
dev-build	TDD 구현 — 테스트 먼저 작성 후 구현하여 통과	/dev-build TSK-00-01
dev-test	테스트 실행 — 실패 시 수정 반복 (최대 3회)	/dev-test TSK-00-01
dev-refactor	리팩토링 — 코드 품질 개선 후 테스트 확인	/dev-refactor TSK-00-01

팀 병렬 개발 (Layer 3) — Layer 1 + Layer 2 조합:

스킬	설명	사용법
dev-team	WP 단위로 하위 Task들을 팀원에게 분배하여 병렬 개발	/dev-team WP-04 [--team-size 5]
dev-help	전체 스킬 사용법 안내	/dev-help

---

사용법

단일 Task 개발 — /dev

하나의 Task를 설계부터 리팩토링까지 전체 사이클로 실행합니다.

# 전체 사이클 (설계 → TDD → 테스트 → 리팩토링)
/dev TSK-00-01

# 특정 단계만 실행
/dev TSK-00-01 --only design
/dev TSK-00-01 --only build
/dev TSK-00-01 --only test
/dev TSK-00-01 --only refactor

개발 사이클 흐름 (DDTR):

[ ] → [dd] 설계 → [im] TDD 구현 → 테스트 → [xx] 리팩토링 완료

개별 단계 실행

전체 사이클 대신 각 단계를 독립적으로 실행할 수 있습니다.

/dev-design TSK-00-01     # design.md 생성, status → [dd]
/dev-build TSK-00-01      # 테스트 작성 + 구현, status → [im]
/dev-test TSK-00-01       # 테스트 실행, test-report.md 생성
/dev-refactor TSK-00-01   # 코드 개선, status → [xx]

각 단계의 산출물은 docs/tasks/{TSK-ID}/ 하위에 생성됩니다:

docs/tasks/TSK-00-01/
├── design.md        # 설계 문서
├── test-report.md   # 테스트 결과
└── refactor.md      # 리팩토링 내역

팀 병렬 개발 — /dev-team

WP(Work Package) 단위로 하위 Task들을 팀원에게 분배하여 병렬 개발합니다. tmux 환경에서 WP 리더 + 팀원 pane 구조로 동작합니다.

# 단일 WP 실행
/dev-team WP-04

# 복수 WP 동시 실행
/dev-team WP-06 WP-07

# WP 자동 선정 (실행 가능한 WP 자동 탐색)
/dev-team

# 팀원 수 조절 (기본: 3명)
/dev-team WP-04 --team-size 5

아키텍처:

팀리더 (현재 세션)
 ├─ [tmux window: WP-04]
 │   ├─ [pane 0] WP 리더 (스케줄링)
 │   ├─ [pane 1] 팀원1 (Task 수행)
 │   ├─ [pane 2] 팀원2 (Task 수행)
 │   └─ [pane 3] 팀원3 (Task 수행)
 └─ [tmux window: WP-05]
     └─ ... (동일 구조)

---

프로젝트 요구사항

이 플러그인은 아래 구조를 갖춘 프로젝트에서 사용합니다.

필수 파일

파일	용도
docs/PRD.md	제품 요구사항 정의서
docs/TRD.md	기술 요구사항 정의서
docs/wbs.md	WBS 정의 (WP, Task, 의존성, 상태)

WBS Task 형식

docs/wbs.md에 아래 형식으로 Task가 정의되어야 합니다:

### TSK-00-01: Task 제목
- category: development
- domain: backend | frontend | sidecar | fullstack
- status: [ ] | [dd] | [im] | [xx]
- priority: critical | high | medium | low
- depends: TSK-XX-XX, TSK-YY-YY

#### PRD 요구사항
- requirements:
  - ...
- acceptance:
  - ...

#### 기술 스펙 (TRD)
- tech-spec:
  - ...

상태값 의미

상태	의미
[ ]	미착수
[dd]	설계 완료 (design done)
[im]	구현 완료 (implementation)
[xx]	전체 완료

domain별 테스트 프레임워크

domain	프레임워크	실행 명령
backend	RSpec	bundle exec rspec
frontend	Vitest	npm run test
sidecar	pytest	uv run pytest
fullstack	위 전부	순차 실행

dev-team 추가 요구사항

• tmux: 팀 병렬 개발 시 필수 (tmux 세션 내에서 실행)
• claude CLI: claude --dangerously-skip-permissions 실행 가능해야 함

---

Architecture