| name | workspace-flow |
| description | 대규모·다단계 작업을 brainstorm → plan → execute → review → ship 순서로 일관되게
진행하는 얇은 오케스트레이터. 기존 superpowers 스킬 + Workflow 도구 + Codex 리뷰를
정해진 순서로 위임·조율한다. 각 단계 경계에서 사용자 승인을 받는다.
트리거: "workspace flow", "workspace workflow", "워크스페이스 플로우로 해줘",
"이 작업 정식 절차로 진행", "/workspace-flow" 등. 대규모 리뉴얼·기능 구현 요청 시.
|
| argument-hint | [작업 목표] |
Workspace Flow
대규모·다단계 작업을 brainstorm → plan → execute → review → ship 5단계로 진행하는
얇은 오케스트레이터다. 자체 로직은 최소화하고, 기존 superpowers 스킬 · Workflow 도구 ·
Codex 리뷰를 정해진 순서로 위임한다.
원칙
- Interactive by default: 각 단계 경계에서 사용자 승인을 받고 다음으로 넘어간다.
- 이상 상황(테스트 실패·예상치 못한 파일 상태·권한 오류)은 멈추고 상황 + 선택지를 보고한다.
- spec/plan은
docs/superpowers/에 두고 대상 repo에서 gitignore한다.
- Chromium 개발 시 worktree를 절대 사용하지 않는다. 저장소 규모가 너무 커서 worktree 생성 비용이 과도하기 때문이다.
superpowers:using-git-worktrees 등으로 worktree를 만들려 해도 chromium 대상에서는 예외 없이 금지하고, 현재 워크스페이스에서 직접 진행한다.
- 범위 밖: Scale Gate, 세션 로깅, advisor 매트릭스, 훅 경계(필요해지면 후속 확장).
0단계: 사전 점검
- 대상 repo의
.gitignore에 docs/superpowers/ 규칙이 없으면 추가한다(spec/plan을 로컬에만 보관).
- 작업 목표가 인자로 주어졌으면 1단계 brainstorming에 전달한다.
1단계: Brainstorm
superpowers:brainstorming 스킬을 호출한다.
- 산출물 spec은
docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md.
- 게이트: 사용자가 spec을 승인해야 2단계로 넘어간다.
2단계: Plan
superpowers:writing-plans 스킬을 호출한다.
- 산출물 plan은
docs/superpowers/plans/YYYY-MM-DD-<feature>.md.
- 게이트: 사용자가 plan을 승인해야 3단계로 넘어간다.
3단계: Execute
- 계획 태스크를 Workflow 도구로 순차 실행한다(공유 파일 충돌 방지).
- 각 태스크: 실패 테스트 → 구현 → 통과 → build/test 검증 → commit (TDD).
- 어떤 태스크가 검증에 실패하면 그 위에 다음 태스크를 쌓지 않고 중단·보고한다.
- 막힌 작업은
superpowers:systematic-debugging 우선. 그래도 안 풀리면
codex:codex-rescue 서브에이전트(write 가능)로 위임할 수 있다(선택).
- 게이트: 실행 시작 전 사용자에게 확인한다.
4단계: Review
먼저 Claude 리뷰, 그다음 Codex 리뷰 순서로 진행한다.
superpowers:requesting-code-review로 스펙·스타일·결함·머지 준비를 커버한다.
- Codex가 놓치기 쉬운 영역(SECURITY / HIDDEN_ASSUMPTION / ARCHITECTURE / BLIND_SPOT)을
집중 검토한다. SlashCommand 도구로 다음을 호출한다(bash 미사용):
/codex:review — 결함 중심 리뷰
/codex:adversarial-review — 설계·가정 challenge 리뷰
- 재리뷰는 체크포인트당 1회. 이슈가 반복되면 사용자에게 에스컬레이션한다.
Codex 호출 전제 — 플래그 확인 + 폴백
/codex:review·/codex:adversarial-review는 플러그인이 disable-model-invocation: true로
두어 기본적으로 모델이 호출할 수 없다. 이 스킬은 두 커맨드 파일의 플래그를 false로 패치해 둔다.
Review 단계 진입 시 플래그 상태를 Read로 확인한다:
false로 패치돼 있으면 → SlashCommand로 자동 호출.
true로 원복돼 있으면(플러그인 업데이트/reload로 캐시 덮어쓰기) → 사용자에게
"Codex 커맨드 플래그가 원복됐습니다. 재패치할까요?"라고 묻는다.
- 동의 → 두 커맨드 파일을 다시 false로 패치 후 호출.
- 거부 → 그 회차는 사용자가
/codex:review·/codex:adversarial-review를 직접 실행하도록 요청(수동 폴백).
플러그인 커맨드 경로: ~/.claude/plugins/cache/openai-codex/codex/<ver>/commands/{review,adversarial-review}.md.
- 게이트: 리뷰 결과를 triage해 사용자와 합의한다.
5단계: Ship
superpowers:verification-before-completion으로 완료 주장 전 검증 명령을 실제 실행·확인한다.
superpowers:finishing-a-development-branch로 merge/PR/cleanup 선택지를 제시한다.
- PR은 자동 생성하지 않는다. 사용자가 원하면
make-pr를 별도로 호출한다.
- 게이트: ship 방식(merge/cleanup 등)은 사용자가 결정한다.
참고
- 이 스킬은 절차(rigid)다. 단계를 건너뛰지 않되, 사용자가 명시적으로 특정 단계를 생략하라고 하면 따른다.
- 각 단계는 기존 자산에 위임한다. 이 스킬이 직접 구현·리뷰·검증 로직을 재발명하지 않는다.