3bb2f8f1c5
* chore: wire docs/agents config into AGENTS.md Agent skills section
Add the `## Agent skills` discovery block pointing the engineering
skills at the existing docs/agents/{issue-tracker,triage-labels,domain}.md
files (issue tracker, triage label mapping, single-context domain docs).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* docs: rebrand to GSD Core and restructure docs with Diataxis
Reorganise the root README and docs/ around the Diataxis framework
(tutorials, how-to guides, reference, explanation), add new how-to
guides and schema references (STATE.md / CONTEXT.md / PLAN.md /
planning artifacts), and cross-link the whole set. Update the lone
legacy gsd-build reference to open-gsd; keep internal get-shit-done/
filesystem paths unchanged (directory rename tracked separately in
open-gsd/gsd-core#604). Regenerate the ja-JP, ko-KR, pt-BR and zh-CN
localised trees to mirror the new structure.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* docs: backfill changeset PR number (#605)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
125 lines
5.9 KiB
Markdown
125 lines
5.9 KiB
Markdown
# 페이즈를 자율적으로 실행하는 방법
|
|
|
|
남은 모든 페이즈 또는 지정된 범위를 무인으로 실행합니다. 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)
|