cc-dev

개발 사이클 자동화 (이슈 사이클, 버그 사이클, 세션, ZenHub, Agent Teams)

cc-dev#

개발 사이클 자동화 (이슈 사이클, 버그 사이클, 세션, ZenHub, Agent Teams)

개발 사이클 자동화 플러그인 (Issue Cycle, Bug Cycle, Session, ZenHub, PR Preflight)

진입점: /dev-cycle (마스터 허브 — 상황→커맨드 결정 테이블). 이슈 하나의 전체 사이클은 /cc-dev:run.

Skills#

이름	설명
agent-teams	Agent Teams 사용 가이드 — 병렬 개발, 리뷰, 테스트를 위한 5가지 전략. 여러 Claude Code 팀원에 걸쳐 스토리, 리뷰, 테스트를 병렬화할 때 사용합니다.
branch-hierarchy	브랜치 계층 구조와 CI 게이팅(Initiative/Project/Epic/Story/Sub-task 베이스 브랜치). 5레벨 어느 이슈든 베이스 브랜치/prefix를 선택하거나
ci-runner-isolation	self-hosted 러너 fleet 에서 한 호스트에 여러 러너 인스턴스가 등록돼 machine-global 자원을 공유할 때 생기는 4종 사고와 방어 — PUB_CACHE 인스
claude-review-automation	Claude Code Review/Auto-Fix 워크플로우 운영 컨벤션. PR에서 Claude Code Review/Auto-Fix를 운영할 때 사용합니다.
dev	이슈 생성부터 머지까지 전체 개발 사이클을 자동화합니다. /cc-dev:run을 실행하거나, ZenHub 이슈를 end-to-end로 처리하거나, 브랜치-PR-머지 워크플로우를 자
dev-env-sync	개발 환경 동기화(submodule + FVM) 트러블슈팅. submodule/FVM을 동기화하거나 개발 환경 drift를 수정할 때 사용합니다.
dev-machine-disk-hygiene	개발 워크스테이션이 동시에 self-hosted 러너 호스트일 때 디스크가 고갈되는 구조와 안전한 회수 절차 — 비정상 종료한 dart test 가 $TMPDIR 에 남기는 고아(
discovery-audit	Triage 후 Verify 방식의 코드베이스 전체 버그 패턴 감사 + git worktree로 격리된 병렬 수정(Fix-Fanout) 워크플로우. 한 번 발견된 특정 버그 패턴이
incremental-build	증분 빌드 규칙 — 로컬은 변경 패키지 + 역의존만 빌드하고, CI 는 마커 기반 skip/incremental/full 3-모드로 코드 생성을 증분화합니다. 생성 파일 추적 정책
job-timeout-budget	GitHub Actions 잡의 점유 시간 상한 규약 — 모든 잡에 job-level timeout-minutes, step-level 값과의 역전 금지, cold 러너를 흡수하는
merge-conflict-resolution	파일 유형별로 정리한, 오래 유지되는 PR의 머지 충돌 해결 전략입니다. 오래 유지되는 PR에서 머지 충돌을 해결할 때 사용합니다.
orca-worktree-lifecycle	머지가 끝난 Orca 워크트리를 안전하게 회수하는 규약 — 만든 쪽이 회수하고 워커는 자기 워크트리를 절대 지우지 않으며, PR MERGED · 미머지 커밋 0 · 워킹트리 cle
parallel-session-collision	여러 세션(터미널 탭·worktree)이 같은 작업을 각자 완주하는 낭비를 막는 규약 — 착수 전 조회 3회(열린 PR·내 이슈 번호가 박힌 원격 브랜치·부모 Epic/Projec
parallel-test-env	디바이스 충돌 없이 여러 앱 세션을 병렬로 실행합니다 — iOS 시뮬레이터에 이름을 붙이고 주소를 지정하며(xcrun simctl rename/clone, flutter -d <n
pr	Pre-PR 테스트 게이트 — PR 생성 직전에 변경된 패키지 범위로 unit + widget + integration 테스트를 자동 실행하고, 실패 시 PR을 막습니다. PR을
pr-work-artifact	PR 생성 시점에 작업내역 아티팩트를 발행해 PR 본문에 링크를 심습니다 — 이슈 본문 아티팩트 계약과 동일한 패턴. CI 결과가 나오면 같은 URL 로 갱신(코멘트 없음). /c
self-hosted-runner-warming	self-hosted 러너 fleet 에서 SDK 버전을 bump 할 때 cold 다운로드 타임아웃·플레이크를 방지하는 운영 규칙 — tool 캐시는 버전별·러너별이라 첫 도입 때
session	세션 종료 시 .claude/ 문서를 자동으로 업데이트합니다. 세션을 마무리하며 학습 내용, 규칙, 후속 작업을 프로젝트 문서에 저장할 때 사용합니다.
stacked-prs	GitHub 네이티브 Stacked PR(gh-stack) 선택형 실행 모드 (public preview) — 기본값은 branch-hierarchy 의 5레벨 수동 계층이고, 순
zenhub-conventions	ZenHub 이슈/PR 관리 컨벤션. ZenHub 이슈/PR과 파이프라인을 생성하거나 관리할 때 사용합니다.

Commands#

이름	설명
/cc-dev:batch — 계층 전체를 한 방에 자동 처리	ZenHub 이슈 계층(Initiative/Project/Epic/Story/Sub-task) 5레벨을 재귀적으로 자동 처리합니다 — 어느 레벨에서 시작해도 그 서브트리 전체를 O
/cc-dev:bugfix — 버그 하나를 끝까지 책임지는 "수리 자동화"	이 워크플로우는 버그 이슈 수정 사이클 전체를 자동화합니다:
/cc-dev:debrief — 사고 복기 리포트	인시던트 이후 비난 없는(blameless) 분석 — 근본 원인, 영향 범위, 게이트 갭 분석, 액션 아이템
/cc-dev:go — 말만 하면 머지까지, 원스톱 파이프라인	원스톱 파이프라인 — 자연어 요청 하나로 브레인스토밍→이슈 계층 생성(Initiative/Project/Epic/Story)→계획 승인(단일 게이트)→구현→PR 머지까지 자동 진행
/cc-dev:run — 작업 한 줄이면 끝까지 굴려주는 "개발 자동 컨베이어"	이슈 생성부터 머지까지 전체 개발 사이클을 자동화합니다.
/cc-dev:unstuck — 막혔을 때 시각을 바꿔주는 "관점 전환 회의"	5가지 측면 사고 페르소나로 막힌 루프를 벗어납니다 — 단독 재구성 또는 병렬 토론(정답이 아닌 옵션을 반환합니다)
dev-cycle	개발 사이클 마스터 허브 — 이슈 처리(dev)·ZenHub 보드(zenhub)·PR 게이트(pr)·세션 마무리(session)·OpenAPI(openapi) 네임스페이스의 커맨드
openapi-mapper	OpenAPI Response를 Domain Entity Mapper로 자동 생성합니다.
pr-preflight	변경된 패키지에 대해 unit + widget + integration 테스트를 실행하고 실패 시 PR 생성을 막는 Pre-PR 게이트입니다.
pr-review-processor	PR 에 달린 AI 리뷰(Claude·Gemini) 지적을 타당한 것은 코드로 고쳐 커밋·push 하고, 타당하지 않은 것은 `CLAUDE.md` 억제 규칙으로 남겨 같은 지적이
session-wrap	세션에서 새로 확인된 규칙·패턴을 `CLAUDE.md` · `.claude/rules/` · `.claude/commands/` 에 반영하고, 자동화할 만한 반복 작업과 후속 작업을 함께
zenhub-breakdown	ZenHub Initiative/Project/Epic/Feature-Bug-Task/Sub-task 생성(요구사항에서 규모 자동 추론), 우선순위 검토 및 파이프라인 정렬 포함
zenhub-changelog	ZenHub의 종료된 이슈로부터 릴리스 노트/체인지로그를 생성합니다(태그 또는 스프린트 기간 기준).
zenhub-init-workspace	ZenHub 보드를 표준 6칸(New Issues→Review/QA)으로 정리하고 Done 칸을 비우며, 저장소·칸 ID 를 모은 `zenhub-conventions.yaml` 을
zenhub-manage	PR 과 이슈를 연결하고 보드 칸을 옮기며, 머지 후 안 닫힌 이슈를 닫고 자식이 남았는데 닫힌 상위 이슈를 다시 엽니다( `sync-closed` ) — 파이프라인 밖에서 머지했을
zenhub-rerank	Epic 전체를 아우르는 전역 백로그 리랭크: 하나의 우선순위 랭킹을 만들어 보드를 재정렬합니다.
zenhub-sprint-rollover	진행 중인 스프린트의 미완료 이슈를 다음 스프린트로 이월합니다.
zenhub-team-align	스프린트 내 인당 작업량, 미할당된 고우선순위 이슈, Epic 간 우선순위 충돌을 드러냅니다 — 읽기 전용 리포트이며 승인 게이트가 있는 재분배 옵션을 제공합니다.
zenhub-triage	외부 피드백(고객지원/Slack/리뷰/스토어)을 중복 제거된, 형식이 정리된 ZenHub 이슈로 변환해 New Issues에 스테이징합니다.

Agents#

이름	설명
implementation-agent	이 에이전트는 ZenHub/GitHub 이슈 내용을 분석해 코드를 구현하고 커밋을 생성합니다.
issue-branch-agent	이 에이전트는 ZenHub/GitHub 이슈를 기반으로 Git 브랜치를 생성하고 체크아웃합니다.
issue-state-agent	이 에이전트는 ZenHub 이슈 상태를 관리합니다.
lateral-thinker	Wears one of the 5 lateral personas to reframe a stuck loop — takes a persona + stuck context, retur
mcp-debug	MCP connection troubleshooting specialist. Use for mcp_toolkit initialization and port configuration
pm-spec-agent	이 에이전트는 ZenHub 이슈가 생성되기 전에, 한 줄짜리 작업 요청(선택적으로 Figma 디자인 링크 포함)을 기능 요구사항, 수락 기준, 범위 포함/제외, Fibonacci
pr-lifecycle-agent	이 에이전트는 Pull Request의 전체 라이프사이클을 관리합니다.
pr-readiness-agent	Pre-PR mechanical readiness check — debug artifacts, commit hygiene, secrets, merge markers. Fast an
pr-review-processor-agent	PR에 게시된 AI 코드 리뷰를 자동으로 검토하고 반영하는 에이전트입니다.
sequential-workflow	Supporting reference module for /cc-dev:batch — per-issue cycle detail, Stall Budget ladder, and err
session-automation-scout	자동화 가능한 반복 패턴을 감지합니다. 새로운 skill/agent 생성을 제안할 때 사용합니다.
session-doc-updater	세션 내용을 기반으로 문서 업데이트를 분석합니다. CLAUDE.md와 규칙 파일을 업데이트할 때 사용합니다.
session-duplicate-checker	중복되거나 충돌하는 문서 업데이트를 확인하고 해결합니다. Phase 2의 최종 정리 작업에 사용합니다.
session-followup-suggester	세션 분석 후 후속 작업을 제안합니다. 미완료 TODO와 기술 부채를 식별할 때 사용합니다.
session-learning-extractor	세션 중에 학습한 규칙/패턴을 추출합니다. 프로젝트 고유 규칙을 문서화할 때 사용합니다.
test-quality-agent	Test quality and anti-pattern analysis — tautological assertions, missing async waits, over-mocking,
test-runner-agent	이 에이전트는 Feature에 대한 테스트를 검증하고 실행합니다.
zenhub-integration-agent	ZenHub 통합 전문가입니다. 요청 규모를 자동으로 추론해 Initiative/Project/Epic/Feature-Bug-Task/Sub-task 계층 구조 중 알맞은 단위를

Rules#

이름	설명
Artifact Publishing — 표면 중립 발행 규약
Deployment-Gated Issue Status	For trackers where issue status is tied to release/deployment rather than to PR/merge
Orchestration Graph — 흐름 선언 규약 (substrate-neutral)	흐름을 프로즈로 네 번 적는 대신, ```flow 블록 하나를 규범으로 두고 나머지는 그것의 파생 뷰로
PR Preflight Policy — 사전 테스트 게이트 정책	1. 모든 PR 은 `/cc-dev:pr:preflight` PASS 필수 — 자동( `/cc-dev:run` ) 또는 수동 실행
ZenHub Conventions	Issue management rules using ZenHub.

References#

이름	설명
ZenHub Pipeline Registry	---

플러그인	설명
cc-aws	AWS 인프라 관리 (Terraform, Route53, RDS, Lambda, CloudFront, CodeDeploy) — Serverpod 백엔드 인프라 운영
cc-bricks	cob(co-bricks) 기반 브릭 생성 가이드. kobic Clean Architecture feature 모듈 11종 + 그린필드 프로젝트 초기 세팅(project-init
cc-compass	코코드 스킬 저장소 나침반 — 작업 유형(워크플로우/도구/규칙/레퍼런스)에 따라 알맞은 플러그인·커맨드·스킬로 안내
cc-dcm	DCM(Dart Code Metrics) 코드 품질 분석 및 자동 수정 툴킷
cc-designer	디자인 실무 레퍼런스 + 의사결정 스킬 (UI 디자인, 인터랙션 디자인, 디자인 시스템, 디자인 옵스, 비주얼 크리틱). owl-listener/designer-skills에서 v
cc-e2e	flutter-skill 탐색 → Gherkin 초안 → Patrol 박제로 이어지는 E2E 시나리오 저작 파이프라인
cc-flutter	Flutter 개발 핵심 (UI 패턴, Feature 생성, BLoC, 테스트)
cc-inspector	Flutter Inspector 디버깅 (Master + 9 전문 Inspectors)
cc-jaspr-web	Jaspr Web 자동화 + Flutter Web 임베드 검증. CoUI Web 페이지를 점검하고, Web↔Flutter 듀얼 라이브 프리뷰를 구동하며, VM Service를 통해
cc-marionette	Marionette MCP 래퍼 — CoUI 컴포넌트에 맞춘 위젯 트리 단위 Flutter 자동화 (Widgetbook 회귀 테스트, 커스텀 인터랙티브 위젯 감지, 인프로세스 탭/
cc-pixel-loop	Figma + Marionette + Dart MCP를 활용한 픽셀 퍼펙트 Flutter UI 에이전틱 루프 (Read → Write → Reload → Capture → Comp
cc-product	통합 제품개발 파이프라인 (Discovery → Specification → Planning → Design → Scaffold → Epic → Development → Launc
cc-quality	코드 품질 (코드 리뷰, 체크리스트, 버그 리포트, QA Health Score)
cc-security	보안 통합 — API/앱 보안, 보안 감사, CI 시크릿, 결제/IAP 엔드포인트 보안, 도서 PDF DRM (구 cc-uiux-security 확장)
cc-serverpod	Serverpod 백엔드 — 모델/엔드포인트 생성, 마이그레이션 + 심화 패턴(아키텍처, 인증, 캐싱, DB, IAP, 테스트; 구 cc-backend 통합)
cc-spec	스펙 명확성 검증 (소크라테스식 인터뷰, Seed spec, 모호성 스코어링, contrarian/simplifier 에이전트, 3단계 평가)

설치#

claude plugins install coco-de/skills/plugins/cc-dev