Claude Code + GSD — 기획부터 검증까지 자동화하는 법

📌 클로드 코드의 컨텍스트 롯 문제와 해결책 (00:00)

🔹 컨텍스트 롯(Context Rot)이란?

클로드 코드를 사용할 때 발생하는 구조적인 한계로, 작업 기억 용량(컨텍스트 윈도우)이 제한되어 있어 대화가 길어질수록 품질이 떨어지는 현상을 말합니다.

• 메모장처럼 작동하는 컨텍스트 윈도우는 용량 제한(100만~200만 토큰)이 있습니다.
• 용량이 차기 시작하면 이전에 정한 규칙을 잊거나 같은 실수를 반복하며, 코드 스타일이 일관성을 잃게 됩니다.
• 프로젝트가 커질수록 버그가 증가하고, 이를 수정하려 할수록 더 꼬이는 악순환이 발생합니다.

컨텍스트 롯은 AI 코딩이 프로토타입 단계에만 머무르는 이유 중 하나입니다.

🔹 GSD(Get Shit Done) 소개

컨텍스트 롯 문제를 해결하기 위해 개발된 메타프롬프팅 시스템입니다.

• 클로드 코드 위에 설치하여 사용하며, 설치는 터미널에서 MPX G턴c 명령어로 간단하게 할 수 있습니다.
• GSD는 클로드 코드가 코드를 더 잘 짜도록 컨텍스트를 관리해주는 도구입니다.
• 개발자는 솔로 개발자이며, 코드를 직접 짜지 않고 클로드 코드가 짜도록 합니다.
• 아마존, 구글, 쇼피파이 엔지니어들이 사용하고 있습니다.

📌 GSD의 작동 방식 (01:41)

🔹 5단계 프로세스

GSD는 5단계 과정을 통해 컨텍스트 롯 문제를 해결하고 코드 품질을 향상시킵니다.

1. 프로젝트 초기화: /GSD뉴 프로젝트 명령어를 통해 프로젝트 생성. GSD가 프로젝트의 목표, 기술 스택, 제약 조건, 엣지 케이스 등에 대한 질문을 던져 기획을 구체화합니다. 이 과정에서 프로젝트 MD, 리퀘어먼츠 MD, 로드맵 MD 등의 문서가 자동으로 생성됩니다.
2. 논의: /GSD 디스커스 페이지 명령어를 통해 각 단계의 모호한 부분을 명확히 합니다. 예를 들어, 레이아웃 방식이나 에러 처리 방식 등에 대한 질문을 통해 사용자의 의도를 파악합니다. 이 단계를 건너뛰면 클로드 코드가 임의로 결정하므로, 원하는 결과가 나오지 않을 수 있습니다.
3. 계획: /GSD 플랜 페이지 명령어를 통해 GSD가 먼저 필요한 라이브러리나 패턴을 리서치합니다. 이후 테스크 이름, 수정할 파일, 구체적인 행동, 검증 방법 등이 포함된 XML 형식의 계획서를 생성하고, 자체 검증을 통해 계획의 타당성을 확인합니다.
4. 실행: /GSD 엑스ec큐트 페이지 명령어를 통해 GSD가 계획서들을 웨이브 단위로 묶어 실행합니다. 의존성이 없는 계획서들은 동시에 실행하고, 의존성이 있는 계획서들은 순차적으로 실행합니다. 각 계획서 실행 시 새로운 서브 에이전트가 생성되어 신선한 컨텍스트(20만 토큰)를 제공합니다. 메인 컨텍스트는 30~40%만 사용하므로 컨텍스트 롯을 방지합니다. 테스크가 완료될 때마다 자동으로 Git 커밋이 이루어집니다.
5. 검증: /GSD 베리파이 워크 명령어를 통해 자동 검증을 수행합니다. 코드가 존재하는지, 테스트가 통과하는지 등을 확인하고, 사용자에게 직접 로그인이 되는지, 버튼이 동작하는지 등을 확인하도록 요청합니다. 문제가 발생하면 디버그 에이전트를 통해 원인을 분석하고 수정 계획서를 생성하여 다시 실행합니다.

GSD는 질문, 논의, 계획, 실행, 검증 사이클을 반복하여 프로젝트를 진행합니다.

📌 GSD의 핵심 장점 (03:30)

🔹 컨텍스트 롯 방지 메커니즘

GSD는 다음과 같은 세 가지 핵심 메커니즘을 통해 컨텍스트 롯을 구조적으로 방지합니다.

1. 서브 에이전트 격리: 각 서브 에이전트는 독립적인 컨텍스트를 가지므로, 메인 컨텍스트의 과부하를 막고 컨텍스트 롯을 방지합니다. 팀장(오케스트레이터)이 팀원들에게 필요한 기획서만 보고 일을 시키는 것과 유사합니다.
2. 구조화된 정보 전달: GSD는 각 단계의 산출물을 구조화된 마크다운 파일로 저장하고, 필요한 정보만 서브 에이전트에게 전달합니다. 불필요한 채팅 히스토리를 제거하여 컨텍스트의 질을 높입니다. 핵심만 정리된 2만 토큰이 잡다하게 섞인 10만 토큰보다 효과적입니다.
3. 원자적 계획: GSD는 계획서를 서브 에이전트 컨텍스트 안에서 완결될 수 있는 크기로 쪼개고, 각 계획서 안에 검증 단계를 포함시킵니다. 실행하는 에이전트가 스스로 검증할 수 있도록 하여 효율성을 높입니다. 팀원에게 일을 시킬 때, 완료 후 확인해야 할 사항까지 명확하게 제시하는 것과 같습니다.

GSD는 컨텍스트 격리, 구조화된 전달, 원자적 계획을 통해 컨텍스트 롯을 원천 차단합니다.

📌 컨텍스트 엔지니어링 (05:01)

🔹 AI와 인간 사이의 커뮤니케이션 문제 해결

GSD는 단순한 컨텍스트 롯 해결을 넘어, AI와 인간 사이의 커뮤니케이션 문제를 해결합니다.

• GSD는 질문을 통해 애매한 부분을 구체화하고, 문서를 통해 정리하며, 구조화된 형태로 정보를 전달합니다.
• 이는 컨텍스트 엔지니어링의 핵심 원리입니다.

🔹 컨텍스트 엔지니어링이란?

AI에게 올바른 컨텍스트를 올바른 타이밍에 올바른 형태로 전달하는 기술입니다.

• 프롬프트 엔지니어링이 "어떻게 말하느냐"의 문제였다면, 컨텍스트 엔지니어링은 "무엇을 언제 얼마나 보여주느냐"의 문제입니다.
• GSD의 모든 기능(질문, 문서화, 서브 에이전트 활용)은 올바른 컨텍스트를 추출, 구조화, 전달하기 위한 것입니다.

AI에게 일을 제대로 시키려면 컨텍스트를 설계해야 합니다.

📌 GSD 원칙의 실질적인 적용 (05:59)

🔹 GSD 없이도 적용 가능한 원칙

GSD를 직접 사용하지 않더라도, 다음 세 가지 원칙을 통해 클로드 코드 경험을 향상시킬 수 있습니다.

1. 대화 축소, 문서 확대: 클로드 코드와 채팅으로 소통하는 대신, 프로젝트 구조나 반복적인 지시사항을 문서로 정리합니다. 컨텍스트의 질을 높여 결과물의 질을 향상시킬 수 있습니다.
2. 작업 분할: 큰 작업을 세분화하여 원자적인 단위로 클로드 코드에게 지시합니다. 로그인 API 개발과 같이 구체적인 목표와 스펙, 검증 방법을 명시하여 컨텍스트 과부하를 방지합니다.
3. 자동 검증: 테스트 코드를 먼저 작성하고, 클로드 코드에게 구현을 맡깁니다. 테스트 통과 여부를 통해 결과물을 검증하고, 안전망을 확보합니다.

문서화, 작업 분할, 자동 검증을 통해 컨텍스트 롯 문제를 해결하고 AI 활용 효율성을 높일 수 있습니다.

🔹 컨텍스트 엔지니어링의 중요성

AI 도구의 성능이 향상되더라도 컨텍스트 엔지니어링은 여전히 중요합니다. 컨텍스트 윈도우 크기가 커지더라도 쓰레기 데이터를 넣으면 쓰레기 결과가 나오기 때문입니다. AI를 다루는 사람의 핵심 역량은 "무엇을 넣느냐"에 달려 있습니다.