dev-pipeline

Plugin dev-pipeline from marketplace claude-toolkit in HiSoo38/claude-toolkit. Commands read from the repo's manifest — today.

Skills (8)

• init-pipeline

  프로젝트의 기술 스택을 감지(또는 사용자에게 선택받아)하고 dev-pipeline 템플릿(CLAUDE.md, AGENTS.md, docs/ 계약 문서)을 프로젝트에 설치한다. 파이프라인을 처음 쓰는 프로젝트, 또는 CLAUDE.md 에 "기술 스택" 섹션이 없을 때 실행한다.

• pipeline-workflow

  dev-pipeline 의 진행 규칙 (계약 문서 우선, 작업 하나 = worktree 하나 = 에이전트 하나, 구현·리뷰 분리, 완료 조건). 이 프로젝트에서 기능 구현을 시작하거나 작업을 나누거나 계약 문서(docs/requirements, 스키마, api-spec)를 바꾸려 할 때, 또는 병렬 에이전트 개발 순서를 물을 때 사용한다.

• plan-tasks

  docs/ 의 계약 문서(requirements, 스키마, api-spec)를 읽고 구현 계획서(docs/tasks/plan.md), 구현 체크리스트(docs/tasks/checklist.md), 작업 카드(docs/tasks/T<번호>.md)를 만든다. 작업은 파일 범위가 겹치지 않는 기능 단위로 나누고 의존 관계로 웨이브를 정한다. 끝에 계획 리뷰(/review-plan)를 돌리고, 승인하면 GitHub 이슈로도 만든다.

• review-diff

  현재 브랜치와 기준 브랜치(기본 main)의 변경을 리뷰어에게 넘겨 리뷰를 받는다. 리뷰어는 Claude(dev-pipeline:reviewer 에이전트), Codex(Codex CLI), 둘 다 중에서 고른다. 결과는 블로커/권장/사소함으로 정리된다. 사용자가 직접 실행하거나 /dev-pipeline:work-task 가 구현 뒤에 실행한다.

• review-plan

  구현 전에 계획(계약 문서와 docs/tasks/ 의 계획서 · 구현 체크리스트 · 작업 카드)이 목적에 맞게 짜였는지, 체크리스트대로 하면 구현이 끝나는지 리뷰한다. 리뷰어는 Claude(plan-reviewer 에이전트), Codex, 둘 다 중에서 고른다. 결과와 검사한 문서의 지문을 docs/tasks/plan-review.md 에 남기며, /run-wave 는 이 리뷰가 통과하고 그 뒤 문서가 바뀌지 않았을 때만 작업을 띄운다. /plan-tasks 가 끝에 자동으로 실행하며, 계획을 고친 뒤 직접 다시 실행한다.

• run-wave

  docs/tasks/ 의 작업 카드에서 다음 웨이브(의존 작업이 모두 머지된 작업들)를 골라, 작업마다 Orca worktree 를 만들고 Claude 를 띄워 동시에 진행시킨다. 각 Claude 는 /dev-pipeline:work-task 로 구현 → 테스트 → 리뷰 → 블로커 수정까지 하고 Orca 카드 상태로 결과를 알린다.

• wave-status

  docs/tasks/ 의 작업들이 지금 어디까지 왔는지 한 표로 보여준다. 작업마다 웨이브, 브랜치, Orca 카드 상태·코멘트(구현 중 / 리뷰 통과 / 중단 / 블로커 남음), 머지 여부를 모으고 사람이 할 일과 다음 웨이브를 띄울 수 있는지 알려 준다.

• work-task

  작업 worktree 안에서 작업 카드(docs/tasks/T<번호>.md) 하나를 끝까지 진행한다. implementer 에이전트에게 구현·테스트를 맡기고, /dev-pipeline:review-diff 로 리뷰받고, 블로커가 있으면 고쳐서 다시 리뷰받고, 통과하면 사용자의 커밋 규칙대로 작업 브랜치에 커밋한 뒤 push 는 사용자에게 묻는다. 진행 상태는 Orca 카드(상태·코멘트)로 알린다. /run-wave 가 각 worktree 에서 자동으로 실행하며, 직접 실행해도 된다.

Subagents (6)

• api-designer

  docs/requirements.md 와 스키마 파일을 입력으로 docs/api-spec.md 를 작성·갱신한다. URL, 메서드, 요청/응답 예시, 에러 코드를 정의한다. 요구사항과 스키마가 정리된 뒤 API 계약이 필요할 때 사용한다. docs/ 문서만 쓴다.

• db-designer

  docs/requirements.md 만 입력으로 docs/ 의 스키마 파일을 작성·갱신한다. CLAUDE.md 에 기록된 DB 문법으로 테이블(엔티티)·컬럼 설명, 인덱스, 제약조건, 생성·수정 시각 컨벤션을 포함한다. 요구사항이 정리된 뒤 DB 설계가 필요할 때 사용한다. docs/ 문서만 쓴다.

• implementer

  /plan-tasks 로 나눈 작업 하나를 구현한다. 할당된 파일 범위만 수정하고, 테스트를 작성한 뒤 CLAUDE.md 의 빌드·테스트 명령이 통과해야 완료로 본다. docs/ 계약 문서는 바꾸지 않으며, 계약과 맞지 않으면 멈추고 보고한다. 코드를 수정하는 유일한 dev-pipeline 에이전트.

• plan-reviewer

  구현 전에 계획(계약 문서 requirements · 스키마 · api-spec 과 docs/tasks/ 의 계획서 · 구현 체크리스트 · 작업 카드)이 목적에 맞게 짜였는지 리뷰한다. 목표 → 기능 → 스키마 · API → 작업 카드 → 체크리스트로 빠짐없이 이어지는지, 체크리스트대로 하면 구현이 끝나는지, 문서끼리 어긋나지 않는지, 작업 분할이 안전한지 보고 블로커/권장/사소함으로 정리한다. 읽기 전용이며 /review-plan 이 호출한다.

• planner

  사용자의 요구를 정리해 docs/requirements.md 를 작성·갱신한다. 핵심 엔티티, 기능 목록, 비기능 요구사항, 미정 사항(질문 목록)을 구분한다. 새 기능이나 프로젝트 요구를 문서로 만들 때 사용한다. docs/ 문서만 쓰며 코드는 고치지 않는다.

• reviewer

  브랜치 변경을 작업 카드(계획)와 docs/ 계약 문서, CLAUDE.md 기준으로 리뷰한다. 계획 일치, 계약 일치, 변경이 다른 기능에 주는 영향과 에러 시나리오, 예외처리, 트랜잭션 범위, 보안, 성능, 테스트 누락을 보고 결과를 블로커/권장/사소함으로 정리한다. 읽기 전용이며 파일을 수정하지 않는다. /review-diff 가 호출한다.

Hooks (3)

• PreToolUse

  if python3 -c '' >/dev/null 2>&1; then py=python3; else py=python; fi; "$py" "${CLAUDE_PLUGIN_ROOT}/hooks/guard_paths.py"

• PreToolUse

  if python3 -c '' >/dev/null 2>&1; then py=python3; else py=python; fi; "$py" "${CLAUDE_PLUGIN_ROOT}/hooks/log_agents.py"

• SubagentStop

  if python3 -c '' >/dev/null 2>&1; then py=python3; else py=python; fi; "$py" "${CLAUDE_PLUGIN_ROOT}/hooks/log_agents.py"

Similar plugins