GSD (Get Shit Done) — 공식 README
Key Insight
context-rot을 해결하는 컨텍스트 엔지니어링 레이어. 각 계획을 새로운 20만 토큰 컨텍스트에서 실행하고, 파일 기반 상태(PROJECT.md, ROADMAP.md, STATE.md)로 세션 간 연속성을 유지한다. “아이디어 설명 → 실제로 만들어짐” 파이프라인.
출처: GitHub (gsd-build/get-shit-done) 저자: TÂCHES (솔로 개발자) 설치:
npx get-shit-done-cc@latest유효일: 2026-05-20
핵심 Takeaway
- context-rot 해결이 설계 목적: 컨텍스트 창이 채워질수록 품질이 저하되는 문제를 각 단계에 새 컨텍스트 할당으로 해결
- 6단계 워크플로우:
new-project→discuss-phase→plan-phase→execute-phase→verify-work→ship - 각 계획(PLAN.md)은 새로운 20만 토큰 컨텍스트에서 실행 → 메인 컨텍스트는 30-40% 수준 유지
- XML 프롬프트 포맷팅: 모든 계획이 Claude에 최적화된 구조화 XML (정확한 지시사항, 검증 내장)
- 웨이브 실행: 독립 계획 → 병렬, 의존 계획 → 순차. 수직 슬라이스가 수평 레이어보다 병렬화 효율 우수
- 원자적 git commit: 작업 단위마다 커밋 → git bisect로 정확한 롤백 가능
--minimal프로파일: 12K→700 토큰 오버헤드(≥94% 감소), 로컬 LLM 최적화- 12개 런타임 지원: Claude Code, OpenCode, Gemini CLI, Kilo, Codex, Copilot, Cursor, Windsurf, Antigravity, Augment, Trae, Cline
6단계 워크플로우
| 단계 | 명령어 | 생성 파일 | 핵심 동작 |
|---|---|---|---|
| 1. 초기화 | /gsd-new-project | PROJECT.md, REQUIREMENTS.md, ROADMAP.md, STATE.md | 질문 → 병렬 리서치 → 요구사항 → 로드맵 |
| 2. 논의 | /gsd-discuss-phase N | {N}-CONTEXT.md | 구현 결정 수집 (시각/API/콘텐츠 등 회색 지대) |
| 3. 기획 | /gsd-plan-phase N | {N}-RESEARCH.md, {N}-{M}-PLAN.md | 리서치 + XML 계획 생성 + 검증 루프 |
| 4. 실행 | /gsd-execute-phase N | {N}-{M}-SUMMARY.md, {N}-VERIFICATION.md | 웨이브별 병렬 실행, 작업당 커밋 |
| 5. 검증 | /gsd-verify-work N | {N}-UAT.md | 사람이 직접 테스트, 실패 시 디버그 에이전트 + 수정 계획 |
| 6. 출시 | /gsd-ship N | PR | 자동 생성 본문으로 PR |
멀티에이전트 오케스트레이션 패턴
얇은 오케스트레이터 + 전문화 에이전트 분리:
| 단계 | 오케스트레이터 역할 | 서브에이전트 역할 |
|---|---|---|
| 리서치 | 조율·결과 제시 | 병렬 4개 리서처: 스택/기능/아키텍처/주의사항 |
| 기획 | 검증·반복 관리 | 플래너(계획) + 확인기(검증), 통과 때까지 반복 |
| 실행 | 웨이브 그룹화·진행 추적 | 실행기 병렬, 각각 20만 토큰 새 컨텍스트 |
| 검증 | 결과 제시·다음 라우팅 | 검증기(코드베이스 확인) + 디버거(실패 진단) |
컨텍스트 엔지니어링 파일 구조
| 파일 | 역할 | 컨텍스트 전략 |
|---|---|---|
| PROJECT.md | 프로젝트 비전 | 항상 로드 |
| STATE.md | 결정사항·블로커·위치 | 세션 간 메모리 |
| ROADMAP.md | 방향과 완료 현황 | 진행 추적 |
| PLAN.md | XML 구조 원자적 작업 | 실행기 전용 새 컨텍스트 |
| SUMMARY.md | 변경 이력 | git 히스토리에 커밋 |
XML 계획 형식 (핵심 차별점)
<task type="auto">
<name>로그인 엔드포인트 생성</name>
<files>src/app/api/auth/login/route.ts</files>
<action>JWT에는 jose 사용. users 테이블 대비 검증. 성공 시 httpOnly 쿠키 반환.</action>
<verify>curl -X POST localhost:3000/api/auth/login이 200 + Set-Cookie 반환</verify>
<done>유효 자격증명 → 쿠키, 무효 → 401</done>
</task>연결되는 노트
- GSD — 이 README의 주체
- context-rot — GSD가 해결하는 핵심 문제
- subagent-driven-development — 관련 멀티에이전트 패턴
- harness-engineering — 상위 방법론 영역
- Claude-Code-6개-추천-스킬-LinkedIn — GSD를 6개 추천 스킬 중 하나로 소개