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>
122 lines
5.6 KiB
Markdown
122 lines
5.6 KiB
Markdown
# 빠른 작업과 간단한 작업을 처리하는 방법
|
|
|
|
모든 작업이 페이즈 안에 맞는 것은 아닙니다. GSD는 전체 discuss → plan → execute → verify 루프가 필요 없는 작업을 위한 두 가지 경량 명령을 제공합니다.
|
|
|
|
전체 페이즈 파이프라인이 오버헤드를 감당할 가치가 있는 경우에 대한 맥락은 [컨텍스트 엔지니어링](../explanation/context-engineering.md)을 참고하세요.
|
|
|
|
---
|
|
|
|
## 어떤 명령을 사용할지 결정
|
|
|
|
| 상황 | 명령 |
|
|
|-----------|---------|
|
|
| 버그 수정, 소규모 기능 추가, 또는 단일 사소한 수정으로 요약할 수 없는 작업 | `/gsd-quick` |
|
|
| 오타 수정, 설정 값 업데이트, `.gitignore` 항목 추가, 또는 ≤ 3개 파일을 터치하고 1분 이내에 완료되는 변경 | `/gsd-fast` |
|
|
| 작업에 미지수가 있거나 리서치가 필요하거나 여러 파일을 터치할 경우 | `--research`와 함께 `/gsd-quick` |
|
|
|
|
**경험 법칙:** 작업이 사소한지에 대해 잠시라도 망설인다면 `/gsd-quick`을 사용하세요. `/gsd-fast`는 범위가 사소하지 않아 보이면 자동으로 `/gsd-quick`으로 리디렉션합니다.
|
|
|
|
---
|
|
|
|
## `/gsd-quick` — GSD 보장이 있는 임시 작업
|
|
|
|
`/gsd-quick`은 전체 페이즈와 동일한 원자적 커밋 및 STATE.md 추적 보장으로 플래너와 실행자를 실행하지만, 페이즈 오버헤드 없이 진행합니다(ROADMAP 항목 없음, discuss-phase 없음, 여러 계획에 걸친 웨이브 조정 없음).
|
|
|
|
### 기본 사용
|
|
|
|
```bash
|
|
/gsd-quick
|
|
```
|
|
|
|
GSD가 태스크 설명을 묻고 계획 및 실행합니다. 산출물은 `.planning/quick/`에 저장됩니다.
|
|
|
|
설명을 직접 전달할 수도 있습니다:
|
|
|
|
```bash
|
|
/gsd-quick "Fix the login button not responding on mobile Safari"
|
|
```
|
|
|
|
### 플래그
|
|
|
|
작업에 필요한 경우 더 많은 품질 파이프라인을 추가하는 플래그를 사용하세요.
|
|
|
|
| 플래그 | 추가되는 것 |
|
|
|------|-------------|
|
|
| `--discuss` | 플래너 실행 전 모호한 영역을 표시하고 결정을 `CONTEXT.md`에 캡처하는 경량 사전 기획 논의 |
|
|
| `--research` | 집중된 리서치 에이전트가 기획 전에 접근법, 라이브러리, 함정을 조사함 |
|
|
| `--validate` | 플랜 체킹(최대 2회 반복) 및 실행 후 검증 |
|
|
| `--full` | 위의 모든 것 — `--discuss --research --validate`와 동일 |
|
|
|
|
플래그는 자유롭게 조합할 수 있습니다:
|
|
|
|
```bash
|
|
/gsd-quick --research --validate # 리서치 + 플랜 체킹 + 검증, 논의 없음
|
|
/gsd-quick --discuss # 기획 전 모호한 영역만 표시
|
|
/gsd-quick --full # 전체 품질 파이프라인
|
|
```
|
|
|
|
### 플래그 추가 시기
|
|
|
|
- 작업에 어떻게 접근할지 또는 어떤 라이브러리를 사용할지 확실하지 않을 때 `--research` 추가
|
|
- 작업이 중요한 코드 경로를 터치하고 검증자 에이전트가 must-haves를 충족했는지 확인하기를 원할 때 `--validate` 추가
|
|
- 작업에 플래너 실행 전 확정하고 싶은 설계 선택이 있을 때 `--discuss` 추가(예: 올바른 오류 처리 동작이 명확하지 않을 때)
|
|
- 태스크가 실제로 중요하고 페이즈로 기획하겠지만 ROADMAP에 속하지 않을 때 `--full` 사용
|
|
|
|
### 빠른 작업 목록 및 재개
|
|
|
|
```bash
|
|
/gsd-quick list # 상태별 모든 빠른 작업 표시
|
|
/gsd-quick status my-task-slug # 특정 작업 상태 표시
|
|
/gsd-quick resume my-task-slug # 중단된 작업 재개
|
|
```
|
|
|
|
---
|
|
|
|
## `/gsd-fast` — 인라인 사소한 편집
|
|
|
|
`/gsd-fast`는 현재 컨텍스트에서 직접 작업을 수행합니다. 서브에이전트, `PLAN.md`, 리서치가 없습니다. 스스로 1분 이내에 할 수 있는 변경에만 적합합니다.
|
|
|
|
```bash
|
|
/gsd-fast "fix typo in README"
|
|
/gsd-fast "add .env to .gitignore"
|
|
```
|
|
|
|
설명을 생략하면 GSD가 묻습니다.
|
|
|
|
`/gsd-fast`는 진행 전에 작업이 실제로 사소한지 확인합니다. 범위가 너무 크다고 판단하면 중단하고 리디렉션합니다:
|
|
|
|
```text
|
|
This looks like it needs planning. Use /gsd-quick instead:
|
|
/gsd-quick "your task description"
|
|
```
|
|
|
|
변경 후 `/gsd-fast`는 원자적으로 커밋하고, `.planning/STATE.md`에 `Quick Tasks Completed` 테이블이 있으면 행을 추가합니다.
|
|
|
|
---
|
|
|
|
## `/gsd-quick`이 `/gsd-fast`와 다른 점
|
|
|
|
| 기능 | `/gsd-fast` | `/gsd-quick` |
|
|
|------------|------------|--------------|
|
|
| 서브에이전트 플래너 | 없음 | 있음 |
|
|
| 서브에이전트 실행자 | 없음 | 있음 |
|
|
| 리서치 에이전트 | 없음 | 선택 사항 (`--research`) |
|
|
| 플랜 체킹 | 없음 | 선택 사항 (`--validate`) |
|
|
| 실행 후 검증 | 없음 | 선택 사항 (`--validate`) |
|
|
| 논의 단계 | 없음 | 선택 사항 (`--discuss`) |
|
|
| 워크트리 격리 | 없음 | 있음 (기본값) |
|
|
| 태스크당 원자적 커밋 | 단일 커밋 | 계획 태스크당 하나 |
|
|
| STATE.md 추적 | 테이블이 있으면 행 추가 | 항상 업데이트됨 |
|
|
| `.planning/quick/` 산출물 | 없음 | 있음 |
|
|
|
|
핵심 차이는 서브에이전트 격리입니다. `/gsd-quick`은 별도의 컨텍스트 창에서 새 플래너와 실행자를 실행하므로 작업이 적절히 기획되고 커밋이 태스크당 원자적이며 오케스트레이터가 결과를 검증할 수 있습니다. `/gsd-fast`는 현재 컨텍스트 창만 사용하며 이러한 것이 필요하지 않을 만큼 사소한 변경에 의도적으로 제한됩니다.
|
|
|
|
---
|
|
|
|
## 관련 문서
|
|
|
|
- [페이즈 루프](../explanation/the-phase-loop.md)
|
|
- [컨텍스트 엔지니어링](../explanation/context-engineering.md)
|
|
- [명령어 참조](../COMMANDS.md)
|
|
- [문서 목차](../README.md)
|