Files

Tom Boucher 3bb2f8f1c5 docs: rebrand to GSD Core and restructure docs with Diataxis (#605 )

* 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>

2026-06-02 08:13:09 -04:00

4.5 KiB

Raw Blame History

페이즈를 실행하는 방법

목표: 기획된 페이즈를 웨이브 기반 병렬 실행으로 처리하고 각 계획을 원자적 git 커밋으로 완료합니다.

전제 조건: 페이즈에 최소 하나의 PLAN.md 파일이 있어야 합니다. 기획이 아직 완료되지 않았다면 먼저 /gsd-plan-phase N을 실행하세요 — 페이즈 기획을 참고하세요.

전체 페이즈 실행

/gsd-execute-phase 1

GSD는 페이즈의 계획 파일을 읽고 의존성 웨이브로 그룹화한 후 계획당 새 실행자 에이전트를 실행합니다. 각 실행자는 다음 웨이브가 시작되기 전에 작업을 원자적으로 커밋합니다.

에이전트가 실행되기 전에 GSD는 웨이브 테이블을 출력합니다:

## Execution Plan

Phase 1: Core middleware — 3 plans across 2 wave(s)

| Wave | Plans          | What it builds            |
|------|----------------|---------------------------|
| 1    | 01-01, 01-02   | Core validation function  |
| 2    | 01-03          | Express middleware wrapper |

웨이브 1 계획은 병렬로 실행됩니다(각각 독립된 git 워크트리에서). 웨이브 2는 모든 웨이브 1 커밋이 병합될 때까지 기다립니다.

기본 에이전트 조정 모델에 대해서는 멀티 에이전트 오케스트레이션을 참고하세요.

단일 웨이브 실행

예를 들어 웨이브 2로 넘어가기 전 웨이브 1 출력을 검사하고 싶은 경우 --wave N을 사용하세요:

/gsd-execute-phase 1 --wave 2

GSD는 웨이브 2 계획만 실행합니다. 먼저 이전 웨이브가 완료되었는지 확인하며, 웨이브 1 계획이 아직 미완료인 경우 이전 웨이브를 먼저 완료하도록 알립니다.

실행 전 상태 검증

충돌이나 이전 실행이 중단된 후 .planning/ 디렉터리가 파일 시스템과 동기화되지 않았을 것으로 의심되는 경우 --validate를 사용하세요:

/gsd-execute-phase 1 --validate

GSD는 실행자를 실행하기 전에 상태 일관성 검사를 실행합니다. 감지된 드리프트가 보고되며 진행 전에 수락하거나 수정할 수 있습니다.

중단된 실행 재개

실행이 도중에 중단된 경우(할당량 오류, 네트워크 끊김, 세션 충돌 등) 웨이브 레벨 진행 상황은 보존됩니다. GSD는 각 계획의 SUMMARY.md 파일을 확인합니다. 이미 파일이 있는 계획은 재실행 시 자동으로 건너뜁니다:

/gsd-execute-phase 1

GSD는 SUMMARY.md가 이미 존재하는 계획을 건너뛰고 첫 번째 미완료 계획에서 재개합니다.

커밋은 존재하지만 SUMMARY.md가 없는 경우(실행자가 커밋했지만 세션이 종료되기 전 요약을 작성하지 못한 경우), GSD는 안전 재개 게이트를 표시하고 세 가지 옵션을 제공합니다:

수동으로 마무리 — 커밋을 검사하고 SUMMARY.md를 작성한 후 재실행
처음부터 재실행 — 부분 커밋을 되돌리거나 대체한 후 새 실행자 실행
표시하고 건너뛰기 — 명시적 확인 하에 이상을 기록하고 진행

체계적인 실패 진단에 대해서는 실패한 실행 디버그를 참고하세요.

출력 위치

모든 웨이브가 완료되면 페이즈 디렉터리에 다음이 포함됩니다:

.planning/phases/01-<name>/
  01-01-SUMMARY.md    # 계획 01이 구축한 것, 핵심 파일, 편차
  01-02-SUMMARY.md
  01-03-SUMMARY.md
  VERIFICATION.md     # 요구 사항별 통과/실패 상태

STATE.md와 ROADMAP.md는 모든 웨이브가 완료되면 자동으로 업데이트됩니다. VERIFICATION.md는 페이즈가 완전히 완료된 경우에만 작성됩니다.

Git 히스토리에는 각 실행자의 태스크당 커밋 하나와 오케스트레이터의 추적 커밋이 표시됩니다.

크로스 AI 실행

workflow.cross_ai_command에 설정된 외부 AI CLI(Codex, Gemini 등)에 실행을 위임하려면:

/gsd-execute-phase 2 --cross-ai

설정에 크로스 AI가 활성화된 경우에도 로컬 실행을 강제하려면:

/gsd-execute-phase 2 --no-cross-ai

4.5 KiB Raw Blame History