목차
개요
지난 4월, 사내 공유회에서 「생성 AI를 사용하는 개발 프로세스」라는 주제로 발표를 했습니다. 사람 중심 개발에서 AI 중심 개발로 옮겨 가기 위한 방법으로 SDD(Spec-Driven Development) 를 소개하고, 그것을 바탕으로 만든 SDD Plugin을 공유했습니다.
그로부터 4개월이 지났습니다. SDD Plugin을 계속 쓰면서 느낀 문제와, 그 문제를 풀기 위해 새로 만든 Guild Plugin을 이번 공유회에서 다시 발표했습니다. 이 글은 그 발표 내용을 정리한 것입니다.
Guild Plugin의 설계와 동작을 더 깊이 다룬 시리즈가 따로 있습니다. 이 글은 그 내용을 발표 흐름에 맞춰 한 편으로 압축한 것입니다.
Guild Plugin의 소스 코드와 설치 방법은 dev-yakuza/deku-claude-plugins 저장소에서 확인할 수 있습니다.
지난 발표에서 소개한 SDD Plugin
4월 발표를 못 들으신 분도 있고 시간이 꽤 지나기도 해서, 먼저 간단히 되짚었습니다. SDD Plugin은 Claude에게 단순히 프롬프트를 던져서 문제를 고치게 하는 것이 아니라, Claude가 요구 분석 → 설계 → 구현 → 테스트라는 개발 프로세스를 밟으며 개발을 진행하게 만드는 플러그인입니다.
그때 발표는 이렇게 마무리했습니다.
- 코딩 시간은 확실히 줄었다. 그런데 생산성이 올랐다는 느낌은 없었다.
- 문서 확인과 리뷰 시간이 늘었다. 사람의 리뷰를 줄이지 않으면 크게 오르지 않을 것 같다.
- 각자 자기 plugin / skill을 만들어 보자.
이번 발표는 그 뒤 4개월치 이야기입니다.
SDD Plugin으로 해결한 것
먼저 좋았던 점부터 이야기했습니다. AI 코딩에는 이런 함정이 있습니다.
- 과제를 충분히 분석하지 않은 상태로 개발을 시작한다
- 설계 없이 바로 구현부터 한다
- 대화(컨텍스트)가 길어지면 앞에서 합의한 내용을 잊어버린다
SDD Plugin은 개발 프로세스를 밟게 하고, 각 단계에서 나온 결과물을 GitHub 이슈에 남기게 해서 이 세 가지를 상당 부분 해결했습니다. 이 부분은 실제로 꽤 만족스러웠습니다.
코드베이스는 자라는데 도구는 자라지 않는다
문제는 그다음이었습니다. 플러그인을 계속 쓰다 보면 코드베이스는 커지는데, 플러그인 자체는 처음 만든 그 상태 그대로였습니다.
그래서 같은 지적을 몇 번이고 반복하게 됩니다. “이 프로젝트에서는 그 패턴 안 씁니다”, “이 파일을 고치면 저 파일도 같이 고쳐야 합니다” 같은 것들이요. 그런데 그 지적은 그 순간에만 남습니다. 세션이 끝나면 사라지고, 다음에 같은 문제가 나오지 않게 하려면 제가 직접 플러그인을 열어서 고쳐야 했습니다.
세션은 나눴지만 역할은 나누지 않았다
또 하나는 구조 자체의 문제였습니다.
컨텍스트 오염을 막기 위해 개발 프로세스마다 세션을 나눠서 실행하도록 만들었습니다. 이건 잘 동작했습니다. 컨텍스트가 한 창에 무한정 쌓이는 문제는 여기서 해결됩니다.
그런데 그렇게 나눈 세션에 역할이 없었습니다. 전부 일반적인 AI, 즉 general-purpose 그대로 썼습니다. 그래서 전문성이 없고, 자기가 방금 쓴 것을 자기가 검토하니 리뷰 품질도 좋지 않았습니다.
정리하면 SDD Plugin의 한계는 두 가지였습니다.
- 성장하지 않는 도구
- 명확한 역할이 없는 실행자
관점을 바꿔 사람과 조직을 보다
처음에는 “플러그인을 어떻게 관리할까, 어떻게 개선할까”를 고민하면서 그때그때 SDD Plugin을 고쳤습니다. 그런데 하다 보니 뭔가 아니라는 생각이 들었습니다. 결국 제 수동 노동을 조금 효율화하는 것뿐이었으니까요.
그래서 한 걸음 물러나 관점을 바꿔 봤습니다. 사람은, 조직은 어떻게 움직이는가.
소프트웨어 조직의 움직임을 보면 이렇습니다.
- 분업과 전문 역할이 있습니다.
- 코드 리뷰는 당연히 다른 사람에게 받습니다.
- 성장을 위해 회고를 하고, 다른 멤버에게 피드백을 받습니다.
- 새 멤버가 들어오면 온보딩으로 지금까지의 지식을 공유하고, 문서를 남깁니다.
- 사람이 필요해지면 채용하고, 흔치는 않지만 맞지 않으면 내보내기도 합니다.
이렇게 사람과 조직을 흉내 내면 AI를 더 잘 활용할 수 있지 않을까 하는 생각으로 Guild Plugin을 만들기 시작했습니다.
Guild Plugin은 함께 성장하는 플러그인
Guild Plugin은 한마디로 코드베이스와 AI 에이전트가 함께 성장하는 플러그인입니다.
하네스(harness) 라는 함께 성장할 환경과 Guild라는 조직을 레포에 만들고, 코드베이스와 그 조직에 소속된 AI 에이전트가 서로 영향을 주고받으며 성장합니다.
기본적인 사용법은 이렇습니다.
/gld init # 레포 분석 → 하네스 + 창립 에이전트 + 표준 문서 (레포당 1회)
/gld dev 123 # GitHub 이슈 #123 을 처음부터 끝까지 개발
/gld evolve # 조직 성장레포에 에이전트 조직을 만든다
/gld init을 실행하면 그 레포지토리에 맞춰 16개의 기본 에이전트가 만들어집니다.
기본적으로는 리더, 테크리드, 개발자, 테스터, QA가 개발 프로세스를 밟으며 개발합니다. 나머지 에이전트는 리더가 필요할 때 호출해서 개발을 진행합니다.
예를 들어 인증과 권한에 관한 과제라면 보안 전문 에이전트를, UI/UX에 관한 과제라면 디자이너 에이전트를 불러서 개발을 진행하는 식입니다.
여기가 SDD Plugin에서 general-purpose를 부르던 문제를 해결하는 부분입니다. 익명의 범용 AI를 매번 새로 부르는 것이 아니라, 이름을 가진 역할 정의가 파일로 레포에 남습니다.
코드베이스를 키우는 첫 번째 성장
Guild Plugin은 이 에이전트 조직을 이용해서 먼저 코드베이스를 성장시킵니다.
SDD Plugin과 마찬가지로 분석 → 설계 → 실행 → 테스트 → QA의 개발 프로세스를 밟으면서, AI 에이전트들이 협력하며 개발해 코드베이스를 키웁니다.
진행 상태는 대화가 아니라 GitHub 이슈·PR과 라벨에 남기 때문에, 세션이 끊겨도 /gld status로 어디까지 왔는지 확인하고 /gld resume으로 이어서 진행할 수 있습니다.
에이전트를 키우는 두 번째 성장
또 하나는 개발자, 즉 에이전트를 성장시키는 것입니다.
/gld evolve라는 스킬이 있습니다. 이것을 실행하면 Guild Plugin으로 개발하는 동안 있었던 사람의 교정 · 되돌림 · 검증 격차 · 반복되는 마찰을 확인해서, 에이전트의 습관과 조직의 지식, 코드베이스의 규칙을 성장시킵니다.
- 습관은 에이전트 파일에 적어서 에이전트의 능력을 올립니다.
- 지식은 조직, 즉 에이전트를 넘나드는 정보로 저장해 두고 에이전트들이 개발할 때 참고하도록 합니다.
- 규칙은 기계적으로 지적할 수 있는 것을 정의해서 자동으로 지적되게 합니다.
또 인사(HR) 기능이 있습니다. 개발하다가 이미 정의된 에이전트 외의 전문 지식이 필요해지면 그 전문 지식에 대한 새 에이전트를 만듭니다. 습관과 지식으로 에이전트의 품질을 올리지만, 그래도 에이전트의 움직임이 이상하면 그 에이전트를 지우고 새 에이전트를 만듭니다.
도구를 쓰는 사람이라는 세 번째 축
이렇게 코드베이스와 에이전트를 함께 성장시키는데, 여기까지 만들고 나니 이 플러그인을 쓰는 감독자, 즉 개발자도 성장시킬 필요가 있겠다는 생각이 들었습니다.
그래서 Guild Plugin으로 개발할 때 여러 장치를 통해 이 플러그인을 쓰는 개발자도 성장하도록 만들었습니다.
생성 AI로 개발할 때 AI를 어떻게 활용해서 효율적으로 개발할까는 다들 꽤 고민한다고 생각합니다. 그런데 이것을 쓰는 개발자를 성장시키는 것은 별로 고민하지 않는 것 같아서, 이런 재미있는 관점도 이번에 넣어 봤습니다.
완료
발표는 이렇게 마무리했습니다.
SDD Plugin으로 개발할 때 있었던 성장하지 않는 도구와 명확한 역할이 없는 AI라는 문제를, Guild Plugin에서는 분업 · 에이전트의 성장 · 팀의 성장 · 인사 기능으로 풀었습니다. 그리고 거기에 더해 여러 장치로 플러그인을 쓰는 사람도 성장하도록 만들어 봤습니다.
Guild Plugin을 만들면서 느낀 것은 두 가지입니다.
- AI를 잘 쓰려면 사람의 일하는 방식을 잘 관찰하고 이해하는 것도 중요하다.
- AI로 효율적으로 개발하는 것만이 아니라, AI를 쓰는 사람의 성장도 함께 생각해야 한다.
Guild Plugin은 deku-claude-plugins 마켓플레이스에서 사용할 수 있습니다. 더 자세한 내용은 1부 · 2부 · 3부 · 4부 시리즈에서 다루고 있습니다.
제 블로그가 도움이 되셨나요? 하단의 댓글을 달아주시면 저에게 큰 힘이 됩니다!
앱 홍보
Deku가 개발한 앱을 한번 사용해보세요.Deku가 개발한 앱은 Flutter로 개발되었습니다.관심있으신 분들은 앱을 다운로드하여 사용해 주시면 정말 감사하겠습니다.
