Claude Code로 작업하다 보면 묘한 패턴이 있어요. 처음 30분은 완벽한데, 1시간쯤 지나면 합의한 패턴을 까먹고 컴포넌트를 또 만들기 시작하거든요. 이런 현상을 context rot(맥락 부패)이라고 불러요. GSD는 작업마다 깨끗한 AI를 새로 띄우고 맥락은 파일로 외부화해서 이 문제를 풀었어요. 토큰 소비가 많아 Max 플랜이 권장되고 간단한 작업에는 오버헤드예요. 할 일 관리 앱 예시로 전체 사이클을 따라해볼게요.
Claude Code가 먼저 설치되어 있어야 해요(https://claude.ai/code). Node.js 18 이상도 필요해요. 터미널에서 claude 명령어가 동작하는지 먼저 확인하세요.
기존 코드베이스에 GSD를 도입하려면 /gsd:new-project 전에 /gsd:map-codebase를 먼저 실행하세요. 병렬 에이전트가 기존 스택·아키텍처·컨벤션을 분석해서 기존 패턴과 충돌하지 않게 도와줘요.
잘 모르겠는 질문에는 '알아서 판단해줘'라고 해도 돼요. GSD가 합리적인 기본값을 골라줘요. --auto 플래그를 붙이면 GSD가 코드베이스를 읽고 스스로 판단한 뒤, 이상한 것만 물어봐요.
PLAN.md를 직접 열어서 꼭 확인해보세요. 플랜이 마음에 안 들면 이 단계에서 수정을 요청할 수 있어요. 실행 후에 바꾸는 것보다 여기서 바꾸는 게 훨씬 싸요.
실행 중 에러가 나면 GSD가 자동으로 재시도해요. 그래도 안 되면 /gsd:debug(내장 명령어)를 쓰면 디버그 에이전트가 원인을 잡아줘요. 실행 중에는 터미널을 닫지 마세요.
간단한 수정은 /gsd:quick '설명'으로 전체 사이클 없이 빠르게 처리할 수 있어요. 작업 중단 시 /gsd:pause-work, 다음에 /gsd:resume-work로 이어받기. 토큰 절약은 /gsd:set-profile budget으로 서브에이전트 모델을 낮출 수 있어요. 레거시 코드가 복잡하면 .planning/ 문서를 수동으로 고쳐야 할 수도 있어요.
Claude Code로 작업하다 보면 묘한 패턴이 있어요. 처음 30분은 완벽한데, 1시간쯤 지나면 합의한 패턴을 까먹고 컴포넌트를 또 만들기 시작하거든요. 이런 현상을 context rot(맥락 부패)이라고 불러요. GSD는 작업마다 깨끗한 AI를 새로 띄우고 맥락은 파일로 외부화해서 이 문제를 풀었어요. 토큰 소비가 많아 Max 플랜이 권장되고 간단한 작업에는 오버헤드예요. 할 일 관리 앱 예시로 전체 사이클을 따라해볼게요.
Claude Code가 먼저 설치되어 있어야 해요(https://claude.ai/code). Node.js 18 이상도 필요해요. 터미널에서 claude 명령어가 동작하는지 먼저 확인하세요.
기존 코드베이스에 GSD를 도입하려면 /gsd:new-project 전에 /gsd:map-codebase를 먼저 실행하세요. 병렬 에이전트가 기존 스택·아키텍처·컨벤션을 분석해서 기존 패턴과 충돌하지 않게 도와줘요.
잘 모르겠는 질문에는 '알아서 판단해줘'라고 해도 돼요. GSD가 합리적인 기본값을 골라줘요. --auto 플래그를 붙이면 GSD가 코드베이스를 읽고 스스로 판단한 뒤, 이상한 것만 물어봐요.
PLAN.md를 직접 열어서 꼭 확인해보세요. 플랜이 마음에 안 들면 이 단계에서 수정을 요청할 수 있어요. 실행 후에 바꾸는 것보다 여기서 바꾸는 게 훨씬 싸요.
실행 중 에러가 나면 GSD가 자동으로 재시도해요. 그래도 안 되면 /gsd:debug(내장 명령어)를 쓰면 디버그 에이전트가 원인을 잡아줘요. 실행 중에는 터미널을 닫지 마세요.
간단한 수정은 /gsd:quick '설명'으로 전체 사이클 없이 빠르게 처리할 수 있어요. 작업 중단 시 /gsd:pause-work, 다음에 /gsd:resume-work로 이어받기. 토큰 절약은 /gsd:set-profile budget으로 서브에이전트 모델을 낮출 수 있어요. 레거시 코드가 복잡하면 .planning/ 문서를 수동으로 고쳐야 할 수도 있어요.
댓글 3개
댓글을 작성하려면 로그인이 필요합니다.