// orchestration 스킬의 3-Team 워크플로우 승인 규칙과 CLAUDE.md §3 Checkpoint / §4 Guardrails를 체크리스트로 강제하는 게이트. 모든 작업 시작 시 자동 적용되며, 사용자 승인 없이 다음 팀으로 진입하는 것을 방지한다.
| name | workflow-enforcer |
| description | orchestration 스킬의 3-Team 워크플로우 승인 규칙과 CLAUDE.md §3 Checkpoint / §4 Guardrails를 체크리스트로 강제하는 게이트. 모든 작업 시작 시 자동 적용되며, 사용자 승인 없이 다음 팀으로 진입하는 것을 방지한다. |
| triggers | ["워크플로우 체크","workflow check","Gate-0","Gate-1","Gate-2","Gate-3","체크리스트 제시","승인 게이트","/workflow-enforcer"] |
| version | 2.0.0 |
| user-invocable | true |
| depends_on | [] |
| conflicts_with | [] |
| min_claude_md_version | 4.0 |
모든 작업 요청 수신 시, 실행 전에 아래 체크리스트를 완료하고 사용자에게 제시해야 한다. 체크리스트 미제시 상태에서 변경/실행 도구(Edit, Write, Bash, Agent)를 사용하는 것은 지침 위반이다. Why: 체크리스트는 Gate-1(분석 보고) 통과의 객관 증거이며, 미제시 상태의 변경 도구 사용은 사용자 승인 없는 무단 진입과 동일해 롤백 추적이 불가능해진다. Team 1(Analyze) 단계에서 Read-only 도구(Read, Grep, Glob)는 분석 목적으로 허용된다.
작업 규모 판정 전에 먼저 작업 유형을 판별한다. 비코드 작업은 Gate-1만으로 실행 가능.
| 유형 | 대상 경로 | Gate 요구 | ~/.claude/docs/{product}/tasks 산출물 |
|---|---|---|---|
| 비코드 | docs/, .claude/, .agent-logs/, CLAUDE.md, scripts/pipeline/, memory/ | Gate >= 1 | 면제 |
| 코드 | app/, components/, store/, hooks/, lib/, public/, messages/ 등 | Gate >= 2 | 필수 |
비코드 작업 예시: 스킬 수정, 훅 추가, 지침서 갱신, 메모리 저장, 파이프라인 스크립트 수정, 분석 문서 작성
비코드 작업 워크플로우:
| 등급 | 기준 | Gate 적용 | 비고 |
|---|---|---|---|
| S (Small) | 단일 파일, 단일 함수, 기존 패턴 반복 | Gate-1만 (Gate-2와 통합 보고) | Orchestrator 직접 실행 가능 (3-Team 생략 옵션) |
| M (Medium) | 2~4파일, 기존 아키텍처 내 변경 | Gate-1 + Gate-2 | 3-Team 전체 |
| L (Large) | 5파일 이상 또는 아키텍처 변경 | Gate-1 + Gate-2 | 3-Team 전체 |
S등급 작업은 다음 두 가지 경로 중 하나를 선택한다:
사용자가 "바이브코딩" 지시 시 활성화. 3-Team 대신 도메인별 Lead가 미니 사이클을 자체 완결하는 경량 모드.
orchestration 스킬 Part 5 참조.| Gate | 참조 | 조건 요약 | 승인 키워드 |
|---|---|---|---|
| Gate-V1 | orchestration §5 | Vibe Coding 분석 보고 → 승인 1회 후 실행 | "진행", "ok", "yes", "ㄱㄱ" 등 |
| Gate-1 | orchestration 스킬 §4.1 | Team 1(Analyze) 완료 → analyze.md 보고 후 승인 대기 | "진행", "ok", "yes", "ㄱㄱ" 등 |
| Gate-2 | orchestration 스킬 §4.2 | Team 2(Plan) 완료 → plan.md 보고 후 승인 대기 | 동일 |
| Gate-3 | CLAUDE.md §3 | Checkpoint — 비가역적 작업, 광범위 영향, 요구사항 상충, 외부 연동 | 즉시 중단 + 승인 |
| Gate-4 | debate 스킬 | 질문 유형 입력 → 토론 진행 여부 확인 | 사용자 확인 |
| Gate-5 | orchestration 스킬 §2.2 | 트레이드오프 감지 → 3-Consultants 온디맨드 소환 (팀 내부) | Lead가 판단 |
| Gate-6 | orchestration 스킬 §4.3 | Team 3 Feedback Loop — Medium/Low ≥ 6건 → 추가 수정 여부 확인 | 사용자 확인 |
| Gate-7 | orchestration 스킬 §4.3 | Team 3 완료 → result.md 보고 후 사용자 확인 | 사용자 확인 |
모든 등급 공통: Gate-3 (Checkpoint), Gate-6 (Feedback Loop), Gate-7 (Result) 항상 적용. Why: 이 3개 Gate 는 비가역 작업·잔여 결함·결과 검증의 마지막 안전망이라 작업 규모와 무관하게 생략하면 사용자가 결과 적합성을 확인할 기회 자체가 사라진다.
gate-approve.sh (UserPromptSubmit hook) 가 묶음 승인 키워드를 매칭하면 Gate 0 또는 1 에서 곧장 Gate 2 로 점프한다. analyze.md 와 plan.md 를 한 응답에 묶어 보고한 뒤 사용자가 한 번에 승인하는 패턴을 지원하기 위함이다.
매칭 키워드 (정규식):
| 언어 | 패턴 |
|---|---|
| 한국어 | 분석.{0,3}계획, 계획.{0,3}분석, 둘.?다, 한.?번에, 한꺼번에, 묶어서, 통째, 모두.{0,3}(진행|승인|ok|확인), 전체.{0,3}(진행|승인|ok|확인) |
| 영어 | (all|both)\s+(ok|okay|yes|approve|go|proceed|lgtm) |
예시: "분석/계획 진행", "둘다 ok", "한번에 승인", "묶어서 진행", "all ok", "both approve"
적용 조건:
dangerous-ops-guard 별도 hook).
Why: Fast-Track 은 절차 단축용이지 비가역 작업 승인 권한까지 포괄하지 않으며, 단일 키워드로 Checkpoint 까지 통과시키면 사용자가 위험 작업 인지 없이 실행돼 복구 불가능한 변경이 발생한다.보안: Gate 0→2 점프 시에도 task-docs 검증 조건은 동일 (gate-approve.sh 의 [ "$CURRENT" -lt 2 ] && [ "$NEW_LEVEL" -eq 2 ]). 단계 문서 누락 시 차단되어 산출물 우회는 불가능하다.
CLAUDE.md §4 Guardrails "Flexible Deliverables" 와 정합. 작업 성격이 단일 단계로 완결 가능한 경우 Gate 적용을 생략할 수 있다. 단, Gate-3/6/7 은 항상 유지한다.
| 작업 성격 | 작성 산출물 | 적용 Gate |
|---|---|---|
| 분석 단독 (구현 없는 조사·리포트) | analyze.md 만 | Gate-1 만 |
| 소규모 단발 구현 (S 경량 경로) | result.md 만 | Gate-1 (Gate-2 통합) |
| 표준 다단계 (M/L) | analyze + plan + result 3종 | Gate-1 + Gate-2 |
판단 기준: "이 작업이 별도 plan 단계 없이 분석 또는 구현 한 번으로 끝나는가?" 예 = 단일 산출물 + Gate 축약, 아니오 = 표준 3종 + Gate-1/2 둘 다.
## Workflow Enforcer Checklist
### 1. 요청 재진술 (Restate)
> {사용자의 요청을 1~2문장으로 정확히 재진술}
### 1-1. 작업 유형 및 규모 판정
- **유형:** {비코드 / 코드}
- **비코드 판정 시:** Gate-1 승인 후 즉시 실행 (아래 규모 판정 생략)
- **등급:** {S / M / L} *(코드 작업만)*
- **근거:** {파일 수, 영향 범위, 아키텍처 변경 여부}
- **실행 경로:** {S경량 / S정식 / M정식 / L정식}
### 2. 적용 프로토콜 식별 (Protocol Match)
| Gate | 해당 여부 | 근거 |
|------|-----------|------|
| Gate-1: Team 1 Analyze | O/X | {S경량은 Orchestrator 직접, M/L은 Team spawn} |
| Gate-2: Team 2 Plan | O/X | {S경량은 Gate-1과 통합} |
| Gate-3: Checkpoint | O/X | {해당 조건 명시} |
| Gate-4: Debate Protocol | O/X | {질문 유형 여부} |
| Gate-5: 3-Consultants | — | (팀 내부에서 Lead가 판단) |
| Gate-6: Feedback Loop | — | (실행 후 판단) |
| Gate-7: Result | — | (실행 후 판단) |
### 3. 분석 요약 (Gate-1 해당 시)
1. {분석 항목 1}
2. {분석 항목 2}
**수정 대상 파일:** {파일 목록}
**예상 영향 범위:** {범위 설명}
### 4. 타당성 검토 (Feasibility Review) — **CLAUDE.md §4 5영역 해당 시에만 작성**
> 적용 영역: (1) 분석/설계 산출물 (2) 라이브러리·프레임워크 선택 (3) 아키텍처 결정 (4) API 설계·계약 변경 (5) 보안·인증 패턴. 일반 코드 수정·버그 픽스·리팩토링·명명·주석·typo 는 본 섹션 자동 생략.
| # | 권고/결정 사항 | 공식 근거 | 출처 |
|---|--------------|----------|------|
| 1 | {항목} | {근거} | {출처} |
> 적용 영역에서는 공식 문서(앤트로픽, 프레임워크, RFC, IEEE, OWASP 등) 근거 필수. 근거 없는 권고는 지침 위반.
> **Why:** 아키텍처·라이브러리·보안 결정은 retrofitting 비용이 크고 복구가 어려워, 공식 근거 없이 "통상적" 추정으로 진행하면 사용자가 사후에 결정 적합성을 검증할 수 없게 된다.
### 5. 변경 영향 기록 (Change Impact Log)
| # | 변경 사항 | 개선점 | 수행 이유 (Why) |
|---|----------|--------|----------------|
| 1 | {무엇이 변경되는가} | {어떤 개선이 있는가} | {왜 해야 하는가} |
> 이유 생략은 지침 위반.
### 6. 장기 관점 검증 (Long-term Perspective) — **CLAUDE.md §4.1 강제**
> 본 룰은 분석/계획 산출물(`analyze.md` / `plan.md`) 의 **"장기 영향 / 재발 방지 / SSOT 일관성"** 3섹션 작성 여부를 검증한다. 누락 시 Gate-1 / Gate-2 차단.
| 항목 | 작성 여부 | 핵심 내용 (1~2줄) |
|------|---------|-------------------|
| 장기 영향 (Long-term Impact) | O/X | {3~12개월 누적·전이·재발 시나리오} |
| 재발 방지 (Regression Prevention) | O/X | {hook/lint/test 등 차단 수단 + 차단 강도} |
| SSOT 일관성 (SSOT Consistency) | O/X | {본 작업과 어긋나는 룰/템플릿/hook 갱신 항목} |
> **S(단발) 작업** = 각 항목 1줄 + `"해당 없음 (사유)"` 허용. **M·L** = 실질 시나리오 1건+ 필수.
> **Why:** 단기 fix 누적은 SSOT 분기·산출물 정합성 붕괴 + 동일 문제 재발의 구조적 빚을 만든다 (CLAUDE.md §4.1 SSOT).
### [Status] `Analyze Complete` — 사용자 승인 대기
아래 경우에는 체크리스트 없이 즉시 실행 가능:
/help, /context 등 시스템 명령 응답실행 중 다음 상황 발생 시 즉시 중단 후 사용자 보고:
Workflow Violation Detected
- 위반 Gate: {Gate 번호}
- 위반 내용: {설명}
- 자가 교정: {중단 후 올바른 절차로 복귀}
워크플로우 실행 중 다음을 검증한다:
[HINT] Download the complete skill directory including SKILL.md and all related files