auto-workflow

auto-workflow 스킬 (v4.0 - 9개 커맨드 통합)

개요

/auto 및 /work --loop 커맨드의 핵심 기능을 제공하는 스킬입니다. Ralph Wiggum 철학을 통합하여 "할 일 없음 → 종료" 대신 **"할 일 없음 → 자율 발견"**을 구현합니다.

핵심 원칙

"Iteration > Perfection" - 완벽보다 반복 "Failures Are Data" - 실패는 정보 "Persistence Wins" - 끈기가 승리

핵심 기능

1. 5계층 우선순위: Tier 0(세션) → Tier 1(긴급) → Tier 2(작업) → Tier 3(개발) → Tier 4(자율)
2. 9개 커맨드 자동 트리거: /check, /commit, /issue, /debug, /parallel, /tdd, /research, /pr, /audit
3. Context 예측 관리: 80%에서 예측 분석, 90%에서 즉시 정리
4. 병렬 처리: 모든 Tier에서 2-4 에이전트 병렬 실행
5. E2E 4방향 검증: Functional/Visual/Accessibility/Performance 병렬
6. 자율 발견: 명시적 작업 없을 때 PRD 분석 → 솔루션 탐색 → 마이그레이션

파일 구조

.claude/skills/auto-workflow/
├── SKILL.md                    # 이 파일
├── scripts/
│   ├── auto_cli.py             # CLI 진입점 (python auto_cli.py)
│   ├── auto_orchestrator.py    # 메인 루프 엔진
│   ├── auto_discovery.py       # 2계층 자율 발견 로직
│   ├── auto_logger.py          # 로그 관리
│   └── auto_state.py           # 상태/체크포인트 관리
└── references/
    └── log-schema.md           # 로그 스키마 문서

.claude/auto-logs/
├── active/                     # 진행 중인 세션
│   └── session_YYYYMMDD_HHMMSS/
│       ├── state.json          # 세션 상태
│       ├── log_001.json        # 로그 청크
│       └── checkpoint.json     # 체크포인트
└── archive/                    # 완료된 세션

오케스트레이터 실행 (권장)

외부 Python 스크립트로 Claude Code를 호출하여 자율 루프를 실행합니다.

# 기본 경로
cd D:\AI\claude01\.claude\skills\auto-workflow\scripts

# 자율 루프 시작 (E2E/TDD 검증 포함)
python auto_cli.py                    # 무한 루프 + 검증
python auto_cli.py --max 10           # 최대 10회 + 검증
python auto_cli.py --promise "DONE"   # "DONE" 출력 시 종료
python auto_cli.py --dry-run          # 판단만, 실행 안함

# 검증 생략 (빠른 반복)
python auto_cli.py --skip-validation              # 검증 없이 실행
python auto_cli.py --skip-validation --max 5      # 검증 없이 5회

# 다음 작업 확인 (1회)
python auto_cli.py discover
python auto_cli.py discover --report  # 상세 리포트

# 세션 관리
python auto_cli.py status             # 현재 상태
python auto_cli.py resume             # 마지막 세션 재개
python auto_cli.py resume <session>   # 특정 세션 재개
python auto_cli.py pause              # 일시 정지
python auto_cli.py abort              # 세션 취소

오케스트레이터 아키텍처

┌─────────────────────────────────────────────────────────────┐
│                   Auto Orchestrator                          │
├─────────────────────────────────────────────────────────────┤
│  1. auto_cli.py (CLI 진입점)                                │
│     - 명령줄 인터페이스                                     │
│     - run/resume/status/discover/pause/abort                │
│                                                              │
│  2. auto_orchestrator.py (루프 엔진)                        │
│     - Claude Code 호출 (subprocess)                         │
│     - 종료 조건 체크 (--max, --promise, Context)            │
│     - 체크포인트 자동 저장                                  │
│                                                              │
│  3. auto_discovery.py (자율 발견)                           │
│     - Tier 1: 명시적 작업 탐지                              │
│     - Tier 2: 자율 발견 (린트, 커버리지, 문서화 등)         │
│                                                              │
│  4. auto_state.py / auto_logger.py                          │
│     - 상태 관리 및 로깅                                     │
└─────────────────────────────────────────────────────────────┘

5계층 우선순위 체계

Tier 0: 세션 관리

Tier 1: 긴급 (즉시 처리)

Tier 2: 작업 처리

Tier 3: 개발 지원

Tier 4: 자율 개선 (작업 없을 때)

⚠️ "할 일 없음"은 종료 조건이 아님 → 자율 발견 모드로 전환

Tier 4+: 자율 발견 (PRD 분석)

병렬 처리 (모든 Tier)

종료 조건 (명시적으로만)

Context 임계값

90% 도달 시 동작:

1. 추가 작업 없이 현재 작업만 완료
2. /commit으로 변경사항 커밋
3. 체크포인트 저장
4. 세션 종료 (사용자가 /auto resume으로 재개)

사용 패턴

새 세션 시작

from auto_state import AutoState

state = AutoState(original_request="API 인증 기능 구현")
state.update_phase("analysis")
state.update_progress(total=5, completed=0, pending=5)

로그 기록

from auto_logger import AutoLogger

logger = AutoLogger(session_id=state.session_id)
logger.log_action("file_read", "src/auth.py", "success")
logger.log_decision("JWT 선택", "보안 강화", ["Session", "Basic"])

체크포인트 생성

state.create_checkpoint(
    task_id=3,
    task_content="핸들러 구현",
    context_hint="src/auth/handler.py의 generate_token",
    todo_state=[...]
)

세션 복원

from auto_state import restore_session

state, summary = restore_session("session_20251230_103000")
print(summary)  # 재개용 컨텍스트 출력

PRD 관리

# PRD 상태 업데이트
state.update_prd_status("searching")  # 탐색 중
state.update_prd_status("writing")    # 작성 중
state.update_prd_status("reviewing", path="tasks/prds/0046-prd-auth.md")

# PRD 검토 결과 저장
state.set_prd_review_result({
    "requirements": 5,
    "tech_spec": "clear",
    "test_scenarios": 3,
    "checklist_items": 8
})

# PRD 승인
state.approve_prd()

# PRD 상태 조회
prd_status = state.get_prd_status()

로그 스키마

{
  "timestamp": "2025-12-30T10:30:00.000Z",
  "sequence": 1,
  "event_type": "action|decision|error|milestone|checkpoint",
  "phase": "init|analysis|implementation|testing|complete",
  "data": {
    "action": "file_read|file_write|command|tool_use",
    "target": "path/to/file",
    "result": "success|fail",
    "details": {}
  },
  "context_usage": 45,
  "todo_state": [...]
}

PRD 단계 흐름

새 기능 작업 감지
    │
    ├─ 1. PRD 탐색
    │      tasks/prds/ 검색
    │
    ├─ 2. PRD 없으면 → /create prd 실행
    │      PRD 자동 작성
    │
    ├─ 3. PRD 검토
    │      - 요구사항 완전성
    │      - 기술 실현 가능성
    │      - 테스트 시나리오
    │
    └─ 4. 사용자 승인 대기
           승인 후 구현 진행

Context 90% 도달 흐름

Context 90% 도달
    │
    ├─ 1. 현재 작업 완료 (추가 작업 없음)
    │
    ├─ 2. /commit 실행
    │      변경사항 커밋
    │
    ├─ 3. 체크포인트 저장
    │      - Todo 상태
    │      - 핵심 결정
    │      - 변경 파일
    │      - PRD 상태
    │      - 재개 힌트
    │
    └─ 4. 세션 종료
           "💡 재개하려면: /auto resume"

E2E 및 TDD 검증 (Phase 4, 5)

Phase 4: E2E 엄격 검증

작업 실행 후 자동으로 E2E 테스트를 실행합니다.

작업 실행 성공
    │
    ├─ npx playwright test 실행
    │      │
    │      ├─ 성공 → Phase 5 진행
    │      │
    │      └─ 실패 → /debug 자동 트리거
    │              │
    │              ├─ 디버그 완료 → E2E 재검증
    │              │      │
    │              │      ├─ 통과 → Phase 5 진행
    │              │      └─ 실패 → 다음 반복에서 재시도
    │              │
    │              └─ 디버그 실패 → 작업 실패로 기록

검증 기준:

• E2E 테스트 100% 통과
• 실패 시 /debug 커맨드 자동 실행
• 디버그 후 재검증 1회

Phase 5: TDD 검증

E2E 통과 후 단위 테스트 및 커버리지를 검증합니다.

E2E 통과
    │
    ├─ pytest tests/ -v --cov=src --cov-report=json 실행
    │      │
    │      ├─ 테스트 통과 + 커버리지 ≥ 80% → 통과
    │      │
    │      └─ 실패 또는 커버리지 < 80% → 경고 (작업은 성공)

검증 기준:

• 단위 테스트 100% 통과
• 커버리지 80% 이상
• 실패 시 경고만 (작업 중단 안함)

검증 생략 옵션

# E2E/TDD 검증 생략 (빠른 반복)
python auto_cli.py --skip-validation
python auto_cli.py --skip-validation --max 5

관련 커맨드

• /auto - 메인 커맨드
• /auto resume [session_id] - 세션 재개
• /auto status - 현재 상태 확인
• /auto pause - 일시 정지
• /auto abort - 세션 취소