클로드 코드 오래 쓰면 답답해지는 이유, GSD Core로 고칠 수 있습니다
클로드 코드로 며칠씩 이어지는 프로젝트를 진행하다 보면 비슷한 경험을 하게 됩니다. 처음에는 지시를 잘 알아듣던 에이전트가 대화가 길어질수록 앞서 정한 규칙을 잊어버리고, 세션을 새로 열면 어제 어떤 결정을 내렸는지부터 다시 설명해야 합니다. 코드를 다 짰다고 해서 그게 실제로 요구사항대로 작동하는지 확인해주는 것도 아닙니다.
이 문제를 정면으로 다루는 오픈소스 프레임워크가 GSD Core입니다. GitHub 저장소 open-gsd/gsd-core에 공개돼 있고, 이 글을 쓰는 시점 기준 스타 9천 개, 포크 652개를 넘길 만큼 빠르게 주목받고 있습니다.
GSD Core GitHub 저장소 화면
GSD가 정확히 무엇을 해결하는 도구인지, 어떤 원리로 작동하는지, 클로드 코드에 어떻게 설치하는지 정리했습니다.
GSD Core란 무엇인가
GSD는 “Git. Ship. Done.”의 줄임말로, 클로드 코드, 커서, 코덱스, 코파일럿, 윈드서프 등 여러 AI 코딩 에이전트에 설치해서 쓰는 경량 메타 프롬프팅 프레임워크입니다. 특정 AI 모델이 아니라 이미 쓰고 있는 코딩 에이전트 위에 얹어서, 작업 방식 자체를 체계화해주는 역할을 합니다.
MIT 라이선스로 배포되는 완전한 오픈소스이고, npm 패키지 @opengsd/gsd-core로 관리됩니다. 원래 있던 GSD 프로젝트에서 갈라져 나온 버전으로, 현재는 별도 조직인 open-gsd 아래에서 활발하게 개발되고 있습니다.
GSD Core가 해결하려는 세 가지 문제
GSD Core 공식 문서는 AI 코딩 에이전트를 쓸 때 반복적으로 겪는 문제를 세 가지로 정리합니다.
- 컨텍스트 손상 : 대화가 길어질수록 AI가 컨텍스트 창을 그동안 쌓인 대화 내용으로 채우게 되면서, 별다른 경고 없이 추론 능력과 응답 품질이 조용히 떨어지는 현상입니다.
- 세션 간 기억 단절 : 새 세션을 시작하면 에이전트는 어제 어떤 아키텍처를 선택했는지, 어떤 버그를 이미 배제했는지 아무것도 모르는 상태로 시작합니다.
- 검증 부재 : 대부분의 AI 코딩 작업은 “실행 완료”에서 끝나고, 그 결과가 실제로 요구사항을 충족하는지, 테스트를 통과하는지 아무도 확인하지 않습니다.
GSD Core는 무거운 리서치와 계획, 실행 작업을 매번 새로운 컨텍스트를 가진 서브에이전트에서 처리해 컨텍스트 손상이 누적되지 않게 막습니다. 그리고 STATE.md, CONTEXT.md 같은 구조화된 마크다운 파일에 결정 사항과 진행 상황을 디스크에 그대로 남겨, 대화 메모리가 아니라 파일 자체가 세션 간 기억 역할을 하도록 설계돼 있습니다.
Discuss부터 Ship까지, 5단계로 반복되는 루프
GSD Core는 프로젝트의 각 마일스톤마다 다음 5단계를 하나씩 순서대로 반복합니다.
Discuss, Plan, Execute, Verify, Ship 순서로 반복되는 GSD Core의 5단계 루프
- Discuss : 계획을 세우기 전에 구현 방식에 대한 결정 사항을 먼저 기록합니다.
- Plan : 병렬로 리서치 에이전트를 돌려 작업을 원자 단위로 쪼개고, 계획이 새 컨텍스트 창 안에 들어맞는지 검증합니다.
- Execute : 계획을 병렬 실행 웨이브로 처리하는데, 각 실행 에이전트는 최대 20만 토큰짜리 깨끗한 컨텍스트에서 새로 시작합니다.
- Verify : 만들어진 결과물을 직접 점검하고 테스트를 돌려서, 문제가 있으면 완료 처리 전에 수정 계획부터 세웁니다.
- Ship : PR을 생성하고 해당 단계의 산출물을 아카이브한 다음, 다음 단계로 넘어갑니다.
이 루프 전체는 대화 메모리에 아무것도 남기지 않고 .planning/ 디렉토리 안에 사람이 읽을 수 있는 마크다운과 JSON 파일로만 기록됩니다. 그래서 세션이 끊기거나 /clear로 대화를 초기화해도 진행 상황이 그대로 남습니다.
설치 방법과 지원하는 CLI 목록
설치 방법은 다음과 같습니다.
npx @opengsd/gsd-core@latest
이 명령어를 실행하면 어떤 런타임에 설치할지 선택하는 화면이 뜹니다. 현재 지원하는 런타임은 클로드 코드, 오픈코드, 안티그래비티 CLI, 킴 CLI, 킬로, 코덱스, 코파일럿, 커서, 윈드서프 등입니다. 전역 설치와 프로젝트별 로컬 설치 중에서도 고를 수 있습니다.
공식 문서는 agents/나 commands/ 폴더의 파일을 직접 복사해서 쓰지 말고 반드시 설치 도구를 거치라고 명시합니다. 런타임마다 명령어 표기 방식이 달라서, 설치 스크립트가 이 차이를 맞춰주기 때문입니다.
설치가 끝나면 클로드 코드 등 대상 런타임을 재시작해야 새로 추가된 명령어와 에이전트를 인식합니다.
프로젝트 시작하는 방법
설치 후 프로젝트 성격에 따라 두 가지 명령어 중 하나로 시작합니다.
/gsd-new-project: 처음부터 새로 만드는 그린필드 프로젝트용입니다./gsd-onboard: 이미 코드가 있는 기존 프로젝트에 GSD 워크플로우를 적용할 때 씁니다.
두 명령어 모두 실행하면 VISION.md, ROADMAP.md, CURRENT_STATE.md 같은 프로젝트 산출물 파일을 만들어서, 이후 모든 Discuss와 Plan 단계가 이 파일들을 기준으로 진행되도록 합니다.
정리
GSD Core는 클로드 코드를 비롯한 여러 AI 코딩 에이전트가 겪는 컨텍스트 손상과 세션 간 기억 단절, 검증 부재 문제를 Discuss, Plan, Execute, Verify, Ship이라는 5단계 루프와 서브에이전트, 디스크에 남는 마크다운 산출물로 풀어내는 오픈소스 프레임워크입니다. 이미 쓰고 있는 CLI 위에 npx 명령어 한 줄로 얹을 수 있고, MIT 라이선스라 부담 없이 시도해볼 수 있습니다.
Leave a comment