compass

저장소 나침반 — 작업 유형(워크플로우/런타임 도구/규칙·가이드/레퍼런스)을 물어 알맞은 플러그인·커맨드로 라우팅합니다

항목	내용
실행 명령	`/cc-compass:compass`
난이도	●○○ 간단

한마디로#

이 저장소의 수백 개 스킬·커맨드 중에서 지금 작업에 맞는 진입점을 찾아주는 나침반입니다.

누가·언제 쓰나요#

설치된 플러그인이 많은데 어떤 커맨드부터 불러야 할지 모를 때
새 팀원이 저장소 도구 지형을 처음 파악할 때

어떻게 쓰나요#

/compass                 # 결정 트리와 계층별 테이블 표시
/compass 앱이 이상해요    # 의도를 말하면 바로 안내 (→ /cc-inspector:inspector) — 키가 있으면 확신할 때 한 줄 추천

의도를 말하면 — 한 줄 추천#

/compass 앱이 이상해요 처럼 하고 싶은 일을 말하면 가장 맞는 진입점을 안내합니다. TypeSafe API 키가 있고 cc-dev 플러그인이 설치돼 있으면, 표를 읽기 전에 빠른 판정 모델(TypeSafe Jev)에 먼저 물어 확신이 있을 때만 진입점 하나를 한 줄로 추천합니다. 확신이 없으면 추천하지 않고 예전처럼 요청을 읽어 안내합니다 — 틀린 추천은 추천이 없는 것보다 나쁘기 때문입니다. 추천은 힌트일 뿐이라, 다른 것을 원하면 무시하고 표에서 고르면 됩니다.

이때 요청 문장이 TypeSafe 로 전송됩니다. 보내면 안 되는 내용(비밀번호·고객 정보 등)은 요청에 넣지 마세요.
키가 없거나 cc-dev 가 없으면 이 추천만 빠지고, 나머지 안내는 예전과 같습니다.

⚙️ 의도 라우팅 상세 (AI 에이전트용)

두 번 묻는다(cc-dev:jev-reflex 클라이언트, 합쳐 1초 안팎, 최대 30초) — 1단계는 나침반이 안내하는 플러그인 전체를 넓게 순위 매기고 "일·지식을 원하는가(잡담이 아닌가)" 도 함께 본다. 2단계는 1단계 확률 상위 3개만 더 긴 설명(키워드·명령 목록)으로 다시 판정하고, 대표 명령이 여럿인 플러그인은 어느 명령인지도 묻는다. 후보와 설명은 ${CLAUDE_PLUGIN_ROOT}/skills/cocode-compass/jev/route.json — taxonomy.json·마켓플레이스 설명·명령 파일에서 생성되는 세트다(손으로 고치지 않는다, 원본 저장소의 scripts/sync_taxonomy.py --write).

cc-dev:jev-reflex 스킬을 불러 그 스킬 디렉터리를 얻는다. 없으면(cc-dev 미설치) 아래 unavailable 과 같다.
요청 문장은 셸 문자열에 넣지 않고 파일로 넘긴다 — 백틱·$ 가 섞인 요청이 실행되지 않게.

REQ="$(mktemp)"; cat > "$REQ" <<'EOF'
{사용자 요청 그대로}
EOF
python3 "${CLAUDE_PLUGIN_ROOT}/skills/cocode-compass/scripts/compass_route.py" route \
  --jr "<cc-dev:jev-reflex 스킬 디렉터리>/scripts/jev_reflex.py" --request-file "$REQ"

`route`	안내
`recommend`	`recommend.entry` 를 한 줄 힌트로 먼저 제시하고 "다른 것을 원하시면 아래에서 고르세요" 를 붙인다. `recommend.alternatives` 가 있으면(명령을 확정하지 못함) 같은 플러그인의 다른 대표 명령으로 함께 적는다. `plugin:skill` 모양의 진입점은 그 스킬을 불러 쓰라는 뜻이다
`candidates`	적합이 확인된 후보(`candidates`)만 "혹시 이것?" 으로 보여 주고, 요청을 읽어 안내를 이어 간다
`none`	힌트만 내지 않는다 — 잡담이거나 맞는 플러그인이 없다. 안내는 예전처럼 Claude 가 요청을 읽어 한다
`unavailable` · 종료 코드 0 이 아님	반사 판정 없이 예전처럼 Claude 가 요청을 읽어 안내한다 — 키 없음·cc-dev 미설치·오류·시간 초과

추천은 2단계의 선택(후보끼리 비교)과 그 후보의 적합(그 플러그인으로 가면 되는가)이 둘 다 확정일 때만 나온다. 적합이 확인된 후보가 하나도 없으면 후보 목록도 내지 않는다.
compass_route.py eval --jr … 가 jev/route.fixtures.jsonl 로 실호출 평가한다 — 추천이 맞아야 할 요청, 헷갈리기 쉬운 쌍, 추천하지 않아야 할 요청(잡담과 이 저장소가 다루지 않는 소프트웨어 일)을 함께 둔다.
실측(jev-1.13.0, 2026-09-28, 두 번 실행): 추천해야 할 29건 중 25~26건을 정확히 추천(대표 명령까지 4/4), 오추천 0, 추천하지 않아야 할 8건 모두 추천 안 함. 1단계 단독: 플러그인 35/37(위임 2) · 잡담 판별 36/36.

결정 트리#

먼저 아래 대표 명령에서 고르세요. 더 세부적인 작업은 계층별 라우팅 표로 이어갑니다.

정식 명령	할 수 있는 일	OpenCode
`/cc-compass:compass`	저장소 나침반 — 작업 유형(워크플로우/런타임 도구/규칙·가이드/레퍼런스)을 물어 알맞은 플러그인·커맨드로 라우팅합니다	`/cc-compass-compass`
`/cc-dev:go`	원스톱 파이프라인 — 자연어 요청 하나로 브레인스토밍→이슈 계층 생성(Initiative/Project/Epic/Story)→계획 승인(단일 게이트)→구현→PR 머지까지 자동 진행	`/cc-dev-go`
`/cc-product-auto:run`	채팅 요구사항과 기획 파일을 HTML PRD·CoUI Figma·cob 프로젝트·화면 코드·사이트·앱·콘솔·Widgetbook의 네 GitHub Pages URL로 연결하고 단계별 증거를 남깁니다. 새 제품을 원스톱으로 제작할 때 사용합니다.	`/cc-product-auto-run`
`/cc-product:plan`	3단계: Planning — 조사 결과를 `docs/prd-.md` (무엇을 만들지)· `docs/tech-spec-.md` (어떻게 만들지)· `docs/bdd-*.md` (무엇이 합격인지) 최대 세 문서로 확정합니다.	`/cc-product-plan`
`/cc-product:status`	pipeline/BMAD 기록과 실제 산출물을 대조해 현재 단계·막힌 원인·다음 명령을 보여줍니다. 제품 진행 상태를 한 곳에서 확인할 때 쓰는 읽기 전용 명령입니다.	`/cc-product-status`
`/cc-quality:review`	변경된 코드를 아키텍처·보안·성능·테스트 등 9개 항목으로 점검해 별점 요약표와 심각도별(치명/개선/제안) 문제 목록을 냅니다 — 흔한 오탐은 억제 규칙으로 걸러 따로 보여줍니다.	`/cc-quality-review`
`/cc-flutter:feature:create`	feature/ 번들에 Serverpod 모듈과 Flutter app·console을 생성합니다. 풀스택 기능을 한 번에 만들 때 사용합니다.	`/cc-flutter-feature-create`
`/cc-flutter:test`	요청한 종류의 테스트 코드를 만듭니다 — UseCase 단위·BLoC·Widget·BDD( `.feature` →Patrol E2E)·Patrol E2E 중 선택하며, 커버리지 80%+ (핵심 UseCase 100%) 기준을 함께 안내합니다.	`/cc-flutter-test`
`/cc-blueprint:design`	스펙/PRD를 CoUI Figma 라이브러리 인스턴스만으로 제품 페이지 프레임으로 저작해, 프레임 node URL 목록·화면 레지스트리 등재 행·DDR(디자인 결정 기록)·self-check L0/L1/L2 판정표를 남깁니다. PRD는 확정됐는데 Figma 시안이 아직 없을 때, 또는 기존 화면에 상태·플랫폼 프레임을 작업규칙대로 추가할 때 사용합니다.	`/cc-blueprint-design`
`/cc-blueprint:build`	레지스트리에 등재된 Figma 프레임을 데이터레이어 없는 기능모듈(Page·Widget·BLoC + 도메인 계약 인터페이스 + mock 주입)로 구현해, 위젯북 use_case 등재·상태 4종 골든 스냅샷·상태 프레임마다 라이트 · 다크 Figma 대조(결정적 픽셀 비교)·검증 체크리스트 통과 기록을 남깁니다. 백엔드가 아직 없는 화면을 기획·디자인 검증 가능한 형태로 먼저 완성할 때, 시안(Figma)이 있고 화면 코드가 없을 때 사용합니다.	`/cc-blueprint-build`
`/cc-blueprint:sync`	Figma 화면 레지스트리와 Widgetbook use_case 를 집합 대조해 L0(PR 차단)/L1(경고)/L2(위생) 판정과 '디자인만 있음/코드만 있음/어긋남' 3분류 재작업 목록, 항목별 이슈화 제안을 남깁니다. 디자인이 바뀌어 어느 화면을 다시 봐야 하는지 세야 할 때, PR 전 정렬 게이트를 돌릴 때, 기획·디자인 피드백을 작업 목록으로 바꿀 때 사용합니다.	`/cc-blueprint-sync`
`/cc-inspector:inspector`	실행 중인 Flutter 앱을 진단하는 9개 서브 인스펙터(nav·bloc·auth·network·log·ui·config·form·image)로 라우팅하는 허브 — 증상만 말하면 맞는 인스펙터를 골라 실시간 상태를 보여줍니다.	`/cc-inspector-inspector`

무엇이 필요한가?
├─ 여러 단계를 자동으로 진행하는 파이프라인인가?         → [워크플로우]
├─ 실행 중인 앱·시스템을 조작/검사해야 하는가?           → [런타임 도구]
│    └─ Flutter 런타임 MCP 선택 고민 → cc-flutter:mcp-tool-selection
├─ 코드를 쓸 때 따라야 할 규칙·패턴이 필요한가?          → [규칙·가이드]
└─ 프레임워크·도메인 지식을 찾아봐야 하는가?             → [레퍼런스]

계층별 라우팅 테이블#

워크플로우 — 여러 단계를 자동으로 진행하는 파이프라인이 필요한가?

플러그인	진입점	설명
`cc-dev`	`/cc-dev:go`	개발 사이클 자동화
`cc-quality`	`/cc-quality:review`	코드 품질
`cc-spec`	`spec-clarity`	Jev 판정 게이트 — Seed spec 을 쓰고 TypeSafe Jev
`cc-product-auto`	`/cc-product-auto:run`	서비스 채팅·기획 파일을 HTML PRD → CoUI Figma → cob 조립 → 화면 개발 → app·console·widgetbook GitHub Pages 배포로 연결하는 원스톱 제품개발 자동화
`cc-product`	`/cc-product:product`	통합 제품개발 파이프라인
`cc-writing`	`/cc-writing:write`	제품 화면 문구와 공개 웹 콘텐츠를 고객 질문·검증된 근거·실제 행동에 맞춰 작성하고 코드까지 반영하는 라이팅 플러그인
`cc-coui-sync`	`/cc-coui-sync:status`	CoUI 디자인 시스템의 Figma↔코드 동기화 — 캔버스 드리프트 감지
`cc-e2e`	`/cc-e2e:explore`	flutter-skill 탐색 → Gherkin 초안 → Patrol 회귀 테스트 저작 파이프라인 + unit/widget/E2E 테스트 번들 오케스트레이션
`cc-settlement`	`settlement-invoice`	용역 정산 견적서 자동화 — 기간별 작업 이력을 청구/무상/계약범위 3갈래로 분류해 M/D·청구액을 산출하고 아티팩트·구글 시트 견적서를 만듭니다
`cc-blueprint`	`/cc-blueprint:design`	피그마 디자인·화면 개발 워크플로우 — CoUI Figma 라이브러리로 페이지 저작

런타임 도구 — 실행 중인 앱/서버/외부 시스템을 조작·검사해야 하는가?

플러그인	진입점	설명
`cc-inspector`	`/cc-inspector:inspector`	Flutter Inspector 디버깅
`cc-marionette`	`/cc-marionette:marionette`	Marionette MCP 래퍼 — CoUI 컴포넌트에 맞춘 위젯 트리 단위 Flutter 자동화
`cc-mcp-toolkit`	`/cc-mcp-toolkit:mcp-toolkit`	mcp_flutter / mcp_toolkit 래퍼
`cc-pixel-loop`	`/cc-pixel-loop:pixel-loop`	Figma + Marionette + Dart MCP를 활용한 픽셀 퍼펙트 Flutter UI 에이전틱 루프
`cc-jaspr-web`	`/cc-jaspr-web:jaspr-web`	Jaspr Web 자동화 + Flutter Web 임베드 검증
`cc-clickhouse`	`clickhouse`	ClickHouse 기반 BI 분석
`cc-notebooklm`	`notebooklm`	Google NotebookLM 자동화 및 세션 wrap-up
`cc-webrecon`	`webrecon-api-recon`	실행 중인 웹 앱을 브라우저 자동화로 관찰해 실제 API 호출 패턴과 클라이언트 로직을 역산하는 플러그인

규칙·가이드 — 코드를 직접 작성할 때 따라야 할 프로젝트 규칙·패턴이 필요한가?

플러그인	진입점	설명
`cc-flutter`	`/cc-flutter:flutter-dev`	Flutter 개발 핵심
`cc-coui`	`coui-index`	CoUI 컴포넌트 라이브러리
`cc-coui-upgrade`	`coui-app-upgrade`	앱이 참조하는 coui 버전 올리기
`cc-i18n`	`/cc-i18n:i18n`	국제화
`cc-deeplink`	`universal-links`	딥링크 & Universal Links 설정
`cc-bricks`	`/cc-bricks:create-project`	Feature Brick 생성 가이드
`cc-security`	`security-audit`	보안 통합 — API/앱 보안, 보안 감사, CI 시크릿, 결제/IAP 엔드포인트 보안, 도서 PDF DRM
`cc-serverpod`	`serverpod`	Serverpod 백엔드 — 모델/엔드포인트 생성, 마이그레이션 + 심화 패턴
`cc-aws`	`aws-infrastructure-rules`	AWS 인프라 관리

레퍼런스 — 프레임워크·도메인 지식을 찾아봐야 하는가?

플러그인	진입점	설명
`cc-designer`	`designer-index`	디자인 실무 레퍼런스 + 의사결정 스킬
`cc-flutter-docs`	`flutter-architecture`	Flutter 주제별 레퍼런스
`cc-serverpod-docs`	`serverpod-overview`	Serverpod 상세 레퍼런스

2차 라우팅 (전문 인덱스에 위임)#

상황	위임 대상
CoUI 컴포넌트 고르기	cc-coui `coui-index`
디자인 스킬 고르기	cc-designer `designer-index`
디자인 판단을 되묻지 않고 결정하기	`/cc-designer:decide` (`design-decision`)
Flutter 런타임 MCP 4종 중 선택	cc-flutter `mcp-tool-selection`
개발 사이클 커맨드 중 선택	`/dev-cycle`
Flutter 개발 커맨드 중 선택	`/flutter-dev`