# 페이즈를 자율적으로 실행하는 방법

남은 모든 페이즈 또는 지정된 범위를 무인으로 실행합니다. GSD가 각 단계마다 직접 진행하지 않아도 discuss → plan → execute를 진행합니다.

자율 실행 중 페이즈 루프가 무엇을 하는지에 대한 배경은 [페이즈 루프](../explanation/the-phase-loop.md)를 참고하세요.

---

## 전제 조건

- `.planning/ROADMAP.md`와 `.planning/STATE.md`가 있는 활성 프로젝트
- 실행하려는 모든 페이즈가 자율 모드로 처리 가능한 상태여야 함 (보류 중 또는 진행 중, 이미 완료되지 않은 것)
- 중요한 설계 결정 사항은 이미 `PROJECT.md`에 있거나 이전 `/gsd-discuss-phase`를 통해 캡처되어 있어야 함 — 자율 모드는 `--interactive`를 사용할 때만 대화형으로 모호한 영역을 표시할 수 있음

---

## 남은 모든 페이즈 실행

```bash
/gsd-autonomous
```

GSD는 `ROADMAP.md`를 읽고, 미완료 페이즈를 번호 순으로 발견하며, 각각에 대해 discuss → plan → execute를 실행합니다. 모든 페이즈가 완료되면 자동으로 마일스톤 생애주기를 실행합니다: audit → complete → cleanup.

---

## 특정 페이즈 범위 실행

`--from`과 `--to`를 사용하여 실행 범위를 지정합니다. 두 플래그 모두 소수 페이즈 번호를 허용합니다(예: `3.1`).

```bash
/gsd-autonomous --from 3          # 페이즈 3, 4, 5 … (이미 완료된 1, 2 건너뜀)
/gsd-autonomous --to 5            # 5까지 포함한 페이즈
/gsd-autonomous --from 3 --to 5   # 정확히 페이즈 3, 4, 5
```

`--to`에 도달하면 마일스톤의 모든 페이즈가 완료되지 않았으므로 생애주기 단계는 건너뜁니다. 완료 배너가 재개 방법을 알려줍니다:

```text
Resume with: /gsd-autonomous --from 6
```

---

## 대화형 논의로 실행

기본적으로 자율 모드는 스마트 논의(배치 테이블 제안)를 사용하여 논의 질문에 자동으로 답변합니다. 계획 및 실행을 메인 컨텍스트 밖으로 유지하면서 설계 질문에 직접 답하고 싶다면:

```bash
/gsd-autonomous --interactive
```

대화형 모드에서:
- `/gsd-discuss-phase`가 인라인으로 실행되어 답변을 기다림
- 기획 및 실행은 백그라운드 에이전트로 실행되므로 현재 페이즈가 구축되는 동안 다음 페이즈를 논의할 수 있음
- 메인 컨텍스트는 가볍게 유지됨 — 논의 대화만 누적됨

---

## 여전히 적용되는 안전 게이트

자율 모드는 GSD의 품질 파이프라인을 우회하지 않습니다. 각 페이즈는 여전히:

- 실행 전 플랜 체커를 실행함
- 실행 후 `VERIFICATION.md`를 읽고 결과에 따라 라우팅함
- 검증 상태가 `human_needed` 또는 `gaps_found`인 경우 일시 중지하고 어떻게 할지 묻음
- 단계가 실패하면 중단하고 옵션 제시 (수정 후 재시도, 페이즈 건너뛰기, 또는 중단)

수동 실행과의 유일한 차이는 `passed` 검증이 자동으로 다음으로 진행된다는 것입니다. 결정이 필요한 경우를 제외하고 페이즈 사이에 프롬프트가 표시되지 않습니다.

패키지 적법성 게이트도 활성 상태로 유지됩니다. 계획에 의심스러운 패키지에 대한 `checkpoint:human-verify` 태스크가 포함된 경우 실행자가 중단하고 체크포인트를 표시합니다. 자율 모드는 플래그된 패키지를 자동으로 설치하지 않습니다.

---

## 자율 모드를 사용하지 않아야 할 때

다음과 같은 경우 `/gsd-autonomous`를 사용하지 마세요:

- **페이즈에 미결된 설계 결정이 있는 경우.** `/gsd-discuss-phase`를 실행하지 않았고 `PROJECT.md`에 선호 사항이 캡처되지 않은 경우, 스마트 논의가 동의하지 않을 수 있는 자율 선택을 합니다. 먼저 대화형으로 논의하거나 `--interactive`를 사용하세요.

- **단일 페이즈를 세밀하게 제어해야 하는 경우.** 하나의 페이즈는 `/gsd-execute-phase N`이 단계별 출력을 제공하고 계속하기 전에 반응할 수 있게 해줍니다. 자율 모드는 대규모 무인 실행을 위해 설계되었습니다.

- **페이즈에 새롭거나 위험도 높은 작업이 있는 경우.** 자율 모드는 차단기가 없는 한 일시 중지를 건너뜁니다. 예상치 못한 상황이 예상되는 페이즈에서는 수동 실행으로 루프에 머무세요.

- **부분 실행 중인 페이즈가 있는 경우.** 자율 모드는 미완료 페이즈를 처리하지만 부분적으로 실행된 웨이브는 재개하지 않습니다. 이미 진행 중인 페이즈를 완료하려면 `/gsd-execute-phase N`을 사용하세요.

실행이 도중에 중단된 경우 [실패한 실행 디버그](debug-a-failed-execution.md)를 참고하여 문제를 진단하세요.

---

## 실행 중 진행 상황 확인

자율 모드는 각 페이즈 전에 진행 상황 배너를 출력합니다:

```text
 GSD ► AUTONOMOUS ▸ Phase 3/7: Auth Middleware [████░░░░] 28%
```

세션 도중 실행 상태를 확인해야 한다면 다른 터미널을 열고 실행하세요:

```bash
/gsd-progress
```

---

## 중단 후 재개

자율 모드가 중단된 경우(차단기 프롬프트에서 "자율 모드 중단"을 선택했거나 세션이 중단된 경우), 중단된 곳에서 재개하세요:

```bash
/gsd-autonomous --from 4     # 4를 첫 번째 미완료 페이즈 번호로 교체
```

GSD는 이미 완료된 페이즈를 자동으로 건너뛰므로 실행이 어디서 중단되었는지 확실하지 않은 경우 이전 페이즈 번호에서 재실행해도 안전합니다.

---

## 관련 문서

- [페이즈 실행](execute-a-phase.md)
- [실패한 실행 디버그](debug-a-failed-execution.md)
- [명령어 참조](../COMMANDS.md)
- [문서 목차](../README.md)