/auto

/auto - 원스톱 자동 워크플로우 (v6)

개별 커맨드를 하나씩 호출하는 대신, 전체 파이프라인을 한 번에 자동 실행합니다. CRITICAL 보안 이슈에서만 중단하며, 그 외에는 끝까지 진행합니다.

---

0단계: 인자 파싱

$ARGUMENTS에서 옵션을 추출한다:

인자	기본값	설명
--mode	feature	실행 모드: feature / bugfix / refactor
나머지 텍스트	-	작업 설명 (필수)

작업 설명이 없으면 에러를 출력하고 종료한다:

사용법: /auto [작업 설명]

예시:
  /auto 로그인 페이지 만들기
  /auto --mode bugfix 결제 금액이 0원으로 표시되는 버그
  /auto --mode refactor 인증 모듈 정리

---

1단계: 모드별 파이프라인 결정

feature 모드 (기본)

plan -> tdd -> code-review -> handoff-verify -> commit-push-pr -> sync-docs

1. plan: 구현 계획 수립. 사용자 확인 없이 자동 확정.
2. tdd: 테스트 먼저 작성 후 구현. RED -> GREEN -> IMPROVE 사이클.
3. code-review: 작성한 코드의 보안 + 품질 검사. CRITICAL/HIGH 이슈는 자동 수정.
4. handoff-verify: 빌드/테스트/린트 자동 검증. 실패 시 자동 수정 후 재검증 (최대 5회).
5. commit-push-pr: 커밋 메시지 자동 생성, 푸시, PR 생성.
6. sync-docs: 프로젝트 문서 동기화 (prompt_plan.md, spec.md, CLAUDE.md, rules).

bugfix 모드

explore -> tdd -> handoff-verify -> quick-commit -> sync-docs

1. explore: 관련 코드 탐색으로 버그 원인 파악.
2. tdd: 버그를 재현하는 테스트 작성 후 수정.
3. handoff-verify: 빌드/테스트 검증 (--once 모드).
4. quick-commit: 자동 생성된 커밋 메시지로 빠른 커밋 + 푸시.
5. sync-docs: 프로젝트 문서 동기화.

refactor 모드

refactor-clean -> code-review -> handoff-verify -> commit-push-pr -> sync-docs

1. refactor-clean: 사용하지 않는 코드, 중복 제거, 구조 개선.
2. code-review: 리팩토링 결과 검사.
3. handoff-verify: 기존 기능이 깨지지 않았는지 검증.
4. commit-push-pr: 커밋 + PR (--squash 권장).
5. sync-docs: 프로젝트 문서 동기화.

---

2단계: 환경 확인

파이프라인 시작 전 기본 환경을 확인한다:

1. Git 레포 확인 (git rev-parse --is-inside-work-tree)
2. 프로젝트 타입 감지 (package.json / go.mod / Cargo.toml / pyproject.toml)
3. 패키지 매니저 감지 (pnpm-lock.yaml / yarn.lock / bun.lockb / npm)

Git 레포가 아니면 안내 후 중단.

---

3단계: 파이프라인 실행

각 단계를 순차적으로 실행한다. ultrawork 모드를 사용하여 중간에 멈추지 않는다.

단계 전환 규칙

• 각 단계 완료 후 즉시 다음 단계로 진행한다.
• 사용자 확인을 요청하지 않는다.
• CRITICAL 보안 이슈 발견 시에만 중단하고 사용자에게 보고한다.

plan 단계 자동 확정 (feature 모드)

일반적으로 /plan은 사용자 확인을 기다리지만, /auto 모드에서는:

1. 계획을 수립한다.
2. 계획을 출력한다 (사용자가 볼 수 있도록).
3. 자동으로 확정하고 다음 단계로 진행한다.

에러 처리

• Fixable 에러 (린트, import, 타입 단순 오류): 자동 수정 후 계속 진행.
• Non-fixable 에러 (로직 오류, 아키텍처 문제): 해당 단계에서 최대 3회 재시도 후 실패 보고.
• CRITICAL 보안 이슈: 즉시 중단, 사용자에게 보고.

---

4단계: 결과 요약

전체 파이프라인이 완료되면 한 번에 요약을 출력한다:

성공 시

======================================================================
  Auto Complete (v6) - [mode] 모드
======================================================================

  작업: [작업 설명]

  실행 결과:
    [1] Plan         DONE   [N]개 단계 계획
    [2] TDD          DONE   [N]개 테스트, [N]% 커버리지
    [3] Code Review  DONE   CRITICAL 0 / HIGH 0
    [4] Verify       PASS   빌드+테스트+린트 통과
    [5] Commit & PR  DONE   PR #[번호]: [URL]
    [6] Sync Docs    DONE   문서 동기화 완료

======================================================================

부분 실패 시

======================================================================
  Auto Incomplete (v6) - [mode] 모드
======================================================================

  작업: [작업 설명]

  실행 결과:
    [1] Plan         DONE
    [2] TDD          DONE
    [3] Code Review  WARN   HIGH 2건 (자동 수정됨)
    [4] Verify       FAIL   테스트 2개 실패
    [5] Commit & PR  SKIP   (검증 실패로 스킵)
    [6] Sync Docs    SKIP   (커밋 실패로 스킵)

  실패 상세:
    - src/auth.ts:45 - 타입 불일치 (자동 수정 실패)
    - src/auth.test.ts:30 - 예상값 불일치

  수동 수정 후:
    /handoff-verify -> /commit-push-pr

======================================================================

---

사용 예시

# 새 기능 (기본 모드)
/auto 로그인 페이지 만들기

# 버그 수정
/auto --mode bugfix 결제 금액이 0원으로 표시되는 버그

# 코드 정리
/auto --mode refactor 인증 모듈 정리

# 자연어로 작업 설명
/auto 사용자가 비밀번호를 5번 틀리면 계정을 10분 잠금하는 기능
/auto --mode bugfix 이미지 업로드 시 CORS 에러
/auto --mode refactor API 호출 로직을 커스텀 훅으로 분리

---

주의사항

• /auto는 각 단계의 세부 동작을 개별 커맨드(/plan, /tdd 등)에 위임합니다.
• 중간 과정이 모두 출력되므로 진행 상황을 실시간으로 확인할 수 있습니다.
• CRITICAL 보안 이슈 외에는 멈추지 않으므로, 민감한 작업은 개별 커맨드를 사용하세요.
• 각 단계를 더 세밀하게 제어하고 싶다면 개별 커맨드를 순서대로 사용하세요.