claude-inspector: Skill for Claude Code

dev-bounce

작업을 스테이지 체인으로 진행한다. 각 단계에서 무엇을 하고 무엇이 금지되는지는 프로젝트의 workflow.yaml에 정의돼 있고, 엔진이 단계마다 지시를 주입한다.

이 문서에 워크플로우 내용은 없다. 시작 절차만 있다. 시작한 뒤에는 주입되는 지시를 따르면 된다.

물어야 하는데 물을 수단이 없을 때

이 문서는 몇 군데에서 AskUserQuestion으로 사용자에게 물으라고 한다. 그 도구가 없는 컨텍스트도 있다(서브에이전트, 위임 실행 등).

그럴 때는 추측해서 진행하지 말고 멈춘다. 선택지를 텍스트로 그대로 제시하고 사용자 답을 기다린다. 도구가 없다는 건 "알아서 하라"는 뜻이 아니다.

물어야 하는 것들은 전부 사용자만 답할 수 있는 것이기 때문이다 — 어느 모드로 갈지, 남의 작업과 병렬로 갈지, 이 규칙을 앞으로도 적용할지. 문구가 명확해 보여도(예: "앞으로 항상") 추측으로 진행하면 사용자가 원한 적 없는 영구 변경이 남는다. 되돌리는 비용이 묻는 비용보다 훨씬 크다.

---

Step 1 — 상태 확인

bouncer scan

항상 부른다. 0.01초짜리고, 세션 시작 때 주입된 정보는 그 사이 다른 세션이 작업을 시작했으면 이미 낡았을 수 있다.

STATE    MINE  <경로> <워크플로우> <단계>     이 세션이 이어서 할 작업
STATE    OTHER <경로> <단계> <나이>           다른 세션이 잡고 있는 작업
STATE    NONE                                아무것도 없음
WORKFLOW <이름> <설명>                        모드 선택지
OPTION   <워크플로우> <단계> <id> <이름>       시작할 때 물어볼 선택 항목

결과	다음
MINE	이미 진행 중이다. 요청이 그 작업의 연장이면 bouncer status로 남은 조건을 보고 이어서 한다. Step 2~4는 건너뛴다
OTHER만 있음	다른 세션이 작업 중이다. Step 2로 가되 Step 4에서 병렬 여부를 묻는다
NONE	Step 2

bouncer: command not found가 나오면 이 프로젝트에 ai-bouncer가 설치되지 않은 것이다. 스킬을 쓰지 말고 사용자에게 알린 뒤 평소대로 작업한다. 설치를 임의로 진행하지 않는다.

Step 2 — 요청이 개발 작업인지 판별

요청 성격	처리
질문·설명·코드 읽기	스킬을 쓰지 않고 그냥 답한다
계획을 세우려면 탐색이 먼저 필요	읽기 전용으로 탐색한다(수정 금지). 끝나면 Step 1부터 다시 시작한다
개발 의도는 있으나 무엇을 고칠지 불명확	AskUserQuestion으로 구체화한다. "개발 작업으로 처리할까요?" 같은 확인 질문은 답이 뻔해서 사용자 시간만 쓴다
개발 요청	Step 3

Step 3 — 모드와 옵션을 사용자에게 묻는다

Step 1의 WORKFLOW 줄을 그대로 AskUserQuestion 선택지로 만든다.

모드가 정해지면 그 모드의 OPTION 줄들을 스테이지별로 묶어 다시 묻는다 (multiSelect, 기본 전체 켜짐). 선택지가 4개를 넘으면 질문을 나눠서 여러 번 호출한다. OPTION이 없으면 이 질문은 건너뛴다.

모드는 사용자가 고른다. 계획 단계가 번거롭다는 이유로 가벼운 모드를 대신 고르면 사용자는 자기가 원한 검증이 빠진 줄 모른 채 결과를 받는다. 그건 워크플로우 회피다. AskUserQuestion을 쓸 수 없으면 위 "물어야 하는데 물을 수단이 없을 때"를 따른다.

Step 4 — 시작

bouncer start <모드> "<슬러그>" [--off <끈-항목-id>] ...

슬러그는 영문 소문자와 하이픈으로 짧게 쓴다 (payment-bug, add-oauth). 디렉토리 이름이 되므로 한글이나 공백을 쓰면 도구에 따라 정렬·경로 처리가 어긋난다.