msd-core/docs/ko-KR/how-to/run-phases-autonomously.md

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

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

자율 실행 중 페이즈 루프가 무엇을 하는지에 대한 배경은 페이즈 루프를 참고하세요.

---

전제 조건

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

---

남은 모든 페이즈 실행

/gsd-autonomous

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

---

특정 페이즈 범위 실행

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

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

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

Resume with: /gsd-autonomous --from 6

---

대화형 논의로 실행

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

/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을 사용하세요.

실행이 도중에 중단된 경우 실패한 실행 디버그를 참고하여 문제를 진단하세요.

---

실행 중 진행 상황 확인

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

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

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

/gsd-progress

---

중단 후 재개

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

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

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

---

관련 문서

• 페이즈 실행
• 실패한 실행 디버그
• 명령어 참조
• 문서 목차