cc-dev
개발 사이클 자동화 (이슈 사이클, 버그 사이클, 세션, ZenHub, Agent Teams)
개발 사이클 자동화 (이슈 사이클, 버그 사이클, 세션, ZenHub, Agent Teams)
개발 사이클 자동화 플러그인 (Issue Cycle, Bug Cycle, Session, ZenHub, PR Preflight)
진입점: /dev-cycle (마스터 허브 — 상황→커맨드 결정 테이블). 이슈 하나의 전체 사이클은 /cc-dev:run.
Skills#
| 이름 | 설명 |
|---|---|
| HANDOFF-RESULT — 엔티티 보고서와 기록 형식 | SKILL.md §6~§8 의 형식이다. |
| agent-teams | 여러 에이전트로 개발·리뷰·테스트를 나눠 진행할 때 사용합니다. 작업 간 의존성과 파일 충돌을 고려해 팀 역할과 병렬 실행 방식을 정합니다. |
| agent-working-agreement | 에이전트에게 작업을 지시하거나 범위 이탈·불필요한 중단·장황한 응답을 줄일 때 사용합니다. 증상과 기대 결과를 명확히 쓰고 변경 범위, 자율 진행과 결과 보고 기준을 정리합니다. |
| branch-hierarchy | 이슈 단계에 맞는 개발 브랜치와 병합 대상을 정할 때 사용합니다. Initiative부터 Sub-task까지의 브랜치 계층, 이름 규칙과 CI 실행 조건을 안내합니다. |
| browser-tool-selection | 웹 탐색, 로그인된 사이트 조작이나 화면 검증에 쓸 브라우저 도구를 선택할 때 사용합니다. ego-browser를 기본으로 사용하고 필요한 기능과 격리 조건에 따라 대체 도구를 판 |
| ci-receipts | 이미 통과한 검증을 CI에서 불필요하게 반복할 때 사용합니다. Git 트리 해시에 검증 결과를 기록해 재사용하고, 기록을 확인할 수 없으면 검증을 다시 실행하도록 구성합니다. |
| ci-runner-isolation | 여러 자체 운영 CI 러너가 같은 호스트에서 충돌하거나 의존성 설치가 느릴 때 사용합니다. 캐시·Git 설정·메모리 사용을 격리하고 격리를 유지하면서 다운로드를 줄이는 방법을 안내 |
| claude-review-automation | PR에서 Claude Code Review와 자동 수정을 운영할 때 사용합니다. 리뷰 실행 조건, 수정 흐름과 GitHub Actions 연동 규칙을 확인합니다. |
| dev | 이슈 접수부터 구현·검증·PR·머지까지 개발 작업을 이어서 처리할 때 사용합니다. /cc-dev:run을 중심으로 ZenHub 이슈와 Git 브랜치를 연결해 작업을 진행합니다. |
| dev-env-sync | CoUI 의존성과 Flutter SDK 버전이 맞지 않아 개발 환경에 문제가 생겼을 때 사용합니다. Git 의존성·서브모듈과 FVM 설정을 확인하고 프로젝트 기준에 맞게 동기화합니 |
| dev-machine-disk-hygiene | 개발 장비나 자체 운영 러너의 디스크 여유가 부족할 때 사용합니다. 사용 중인 파일과 오래된 임시 파일·캐시를 구분하고 실행 중인 작업을 확인한 뒤 정리합니다. |
| discovery-audit | 발견한 버그와 같은 패턴이 코드 다른 곳에도 있는지 조사할 때 사용합니다. 후보를 수집·검증한 뒤 실제 결함을 분류하고 격리된 Git worktree에서 수정하는 흐름을 안내합니다 |
| github-actions-hygiene | GitHub Actions 워크플로를 만들거나 CI 실패·실행 낭비를 줄일 때 사용합니다. YAML 문법, 시간 제한, 의존성·권한과 실행 조건을 점검해 실패 원인과 병목을 찾습니 |
| grok-bot-handoff | API로 처리할 수 없는 웹 콘솔 작업을 Grok Bot에 맡길 때 사용합니다. 작업 요청서, 승인과 전달 절차를 정리하고 봇의 결과를 별도로 검증합니다. 로그인과 2단계 인증은 |
| incremental-build | 코드 생성이나 빌드가 매번 전체 실행되어 느릴 때 사용합니다. 변경 패키지와 영향을 받는 패키지를 기준으로 로컬·CI의 증분 실행 범위와 전체 실행 조건을 정합니다. |
| internal-package-registry | 새 기능을 직접 구현하기 전에 재사용할 사내 패키지를 찾을 때 사용합니다. 용도별 패키지, 저장소·경로와 버전 확인 방법을 제공해 기존 구현을 선택하도록 돕습니다. |
| jev-reflex | 작업 분류나 오류 재시도 같은 짧은 판단에 Jev 모델을 연결할 때 사용합니다. 질문과 신뢰도 기준을 설정하고 답을 신뢰하기 어려우면 기존 판단 방식으로 돌아가도록 구성합니다. |
| job-timeout-budget | CI 작업의 실행 시간 제한을 정하거나 멈춘 러너를 처리할 때 사용합니다. GitHub Actions의 잡·단계별 시간 제한과 초기 설치 시간을 고려해 상한을 설정합니다. |
| merge-conflict-resolution | 오래 유지한 PR이나 브랜치에서 머지 충돌을 해결할 때 사용합니다. 파일 유형에 맞는 해결 방법을 선택하고 병합 후 코드와 생성 파일의 일관성을 확인합니다. |
| orca-worktree-lifecycle | 병렬 개발에 사용한 Orca 워크트리와 관련 자원을 정리할 때 사용합니다. 머지·미저장 작업·실행 상태를 확인하고 생성 주체가 데이터베이스, 포트와 체크아웃을 회수하도록 안내합니다 |
| parallel-session-collision | 여러 개발 세션의 중복 작업이나 같은 브랜치에 대한 충돌을 예방할 때 사용합니다. 기존 이슈·PR·브랜치를 확인하고 겹치는 작업의 담당 범위와 병합 순서를 정합니다. |
| parallel-test-env | 여러 앱 개발 세션을 서로 다른 기기·브라우저에서 동시에 검증할 때 사용합니다. 브랜치나 워크트리별로 시뮬레이터, 에뮬레이터, 포트와 브라우저 프로필을 배정합니다. |
| pr | PR을 만들기 전에 변경한 코드의 테스트 통과 여부를 확인할 때 사용합니다. 영향받는 패키지의 단위·위젯·통합 테스트를 실행하고 실패가 남아 있으면 먼저 해결하도록 안내합니다. |
| pr-work-artifact | PR 리뷰어가 읽을 작업내역 문서를 함께 남길 때 사용합니다. 변경 내용과 검증 결과를 자체 열람 가능한 HTML로 작성해 브랜치에 저장하고 PR 본문에서 연결합니다. |
| self-hosted-runner-warming | 자체 운영 CI 러너의 SDK 버전을 올리거나 첫 설치가 시간 초과될 때 사용합니다. 러너별 다운로드·캐시 상태를 확인하고 설치 시간 여유와 사전 준비 실행을 구성합니다. |
| session | 개발 세션을 마치며 결정 사항과 후속 작업을 남길 때 사용합니다. 작업 중 배운 내용과 프로젝트 규칙을 .claude 문서에 정리해 다음 세션에서 이어갈 수 있게 합니다. |
| stacked-prs | 순서대로 의존하는 작업을 GitHub Stacked PR로 관리할 때 사용합니다. 기존 브랜치 계층과 비교해 적용 여부를 정하고 gh stack의 생성·리베이스·머지와 충돌 해결을 |
| zenhub-conventions | ZenHub에서 이슈·PR과 작업 상태를 관리할 때 사용합니다. 이슈 구성, 파이프라인 이동과 GitHub 연동에 필요한 팀 규칙을 확인합니다. |
| 모듈 작업자 브리프 — 체크리스트와 템플릿 | 오케스트레이터가 병렬 모듈 작업자(Agent Teams teammate, Orca 워커, 서브에이전트)에게 줄 지시문을 쓸 때 |
| 브리프 틀 | SKILL.md §2 의 틀이다. 등급은 미검증 — 이 틀로 실행한 기록은 아직 없다. 드라이런에서 먼저 쓴다. |
| 저장소 빠른 판단 조사표 (2026-10-01) |
plugins/
의 스킬·커맨드·에이전트·규칙 문서와 인덱싱된 Python/Dart 스크립트에서
입력을 유한한 답으로 분류·라우팅·매칭
하는 지점을 조사했다. 키워드 검색은
|
Commands#
| 이름 | 설명 |
|---|---|
| /cc-dev:batch — 계층 전체를 한 방에 자동 처리 | ZenHub 이슈 계층(Initiative/Project/Epic/Story/Sub-task) 5레벨을 재귀적으로 자동 처리합니다 — 어느 레벨에서 시작해도 그 서브트리 전체를 O |
| /cc-dev:bugfix — 버그 입력을 공통 실행기로 연결 | 버그 번호나 신규 신고를 공통 개발 실행기에 연결해 재현·수정·검증·PR을 처리합니다. 버그 전용 입력과 기기 옵션으로 시작할 때 사용합니다. |
| /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#
| 이름 | 설명 |
|---|---|
| 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 — 사전 테스트 게이트 정책 | 기능 작업의 작성·소유·등재·증거 정본은 |
| Work Doc Publishing — 저장소 HTML 작업 문서 규약 | PR 작업내역과 이슈 상세 기획을 대상 저장소의 자기완결 HTML 로 남기는 방법 — 경로·커밋·링크·민감정보·폴백 — 을 정한다. |
| ZenHub Conventions | Issue management rules using ZenHub. |
References#
| 이름 | 설명 |
|---|---|
| Bug Diagnosis — 공통 버그 재현·회귀 계약 | run의 버그 모드와 bugfix 연결 명령이 사용하는 단일 원본입니다. |
| LATERAL_PERSONAS | 5 Lateral-Thinking Personas — shared definition for stuck-loop reframing (HACKER / RESEARCHER / SIMP |
| ZenHub Pipeline Registry | --- |
| 실행 연결 계약 | run은 단일 이슈, batch는 자식 작업을 가진 컨테이너의 실행 원본입니다. |
관련 플러그인#
| 플러그인 | 설명 |
|---|---|
| cc-aws | AWS 인프라 관리 (Terraform, Route53, RDS, Lambda, CloudFront, CodeDeploy) — Serverpod 백엔드 인프라 운영 |
| cc-blueprint | 피그마 디자인·화면 개발 워크플로우 — CoUI Figma 라이브러리로 페이지 저작(/design), 프레젠테이션 온리 화면 개발 + 위젯북(/build), Figma↔Widget |
| cc-bricks | cob(co-bricks) 기반 브릭 생성 가이드. kobic Clean Architecture feature 모듈 11종 + 그린필드 프로젝트 초기 세팅(project-init |
| cc-compass | 코코드 스킬 저장소 나침반 — 작업 유형(워크플로우/도구/규칙/레퍼런스)에 따라 알맞은 플러그인·커맨드·스킬로 안내 |
| cc-coui | CoUI 컴포넌트 라이브러리 (크로스플랫폼 컴포넌트 128종) + 조합/확장 가이드 |
| cc-coui-upgrade | 앱이 참조하는 coui 버전 올리기(Flutter 앱·Jaspr 웹 앱) — 형제 패키지를 한 커밋으로 고정하는 핀 계산·검사(coui_pin.py), 홉 계획, 시각 회귀 게이트 |
| cc-deeplink | 딥링크 & Universal Links 설정 관리 (AASA, assetlinks.json, GoRouter 연동, 도메인 마이그레이션) |
| cc-designer | 디자인 실무 레퍼런스 + 의사결정 스킬 (UI 디자인, 인터랙션 디자인, 정보 구조, 디자인 시스템, 디자인 옵스, 비주얼 크리틱). owl-listener/designer-ski |
| 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-mcp-toolkit | mcp_flutter / mcp_toolkit 래퍼 (Arenukvern) — Dynamic Tools Registration 기반 앱 내부 MCP. 실행 중인 Flutter 앱이 |
| 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-product-auto | 서비스 채팅·기획 파일을 HTML PRD → CoUI Figma → cob 조립 → 화면 개발 → app·console·widgetbook GitHub Pages 배포로 연결하는 |
| cc-quality | 코드 품질 (코드 리뷰, 체크리스트, 버그 리포트, QA Health Score) |
| cc-security | 보안 통합 — API/앱 보안, 보안 감사, CI 시크릿, 결제/IAP 엔드포인트 보안, 도서 PDF DRM (구 cc-uiux-security 확장) |
| cc-serverpod | Serverpod 백엔드 — 모델/엔드포인트 생성, 마이그레이션 + 심화 패턴(아키텍처, 인증, 캐싱, DB, IAP, 테스트; 구 cc-backend 통합) |
| cc-spec | Jev 판정 게이트 — Seed spec 을 쓰고 TypeSafe Jev(판정 전용 모델)로 모호성·3관점 패널·드리프트를 보정 확률로 판정해 잠금 |
| cc-webrecon | 실행 중인 웹 앱을 브라우저 자동화로 관찰해 실제 API 호출 패턴과 클라이언트 로직을 역산하는 플러그인 |
설치#
curl -fsSL https://skills.cocode.im/install.sh | bash -s -- --plugin cc-dev