개요
Guild Plugin은 레포마다 전용 에이전트 조직을 만들어 개발하고, 그 조직이 스스로 성장하게 하는 Claude Code 플러그인입니다. 앞선 3부에서는 **① 결과물(코드베이스)**과 **② 개발자(조직 자신)**가 함께 성장하는 과정을 다뤘습니다.
이번 마지막 글에서는 남은 한 축, ③ 감독자 — 도구를 쓰는 사람을 다룹니다. 도구가 스스로 성장하는데 정작 그것을 쓰는 사람은 그대로여도 될까요? Guild Plugin의 답은 “아니오”입니다. 그리고 이렇게 스스로 코드·조직·규칙을 고치는 AI를 어떻게 안전하게 붙잡아 두는지도 함께 정리합니다.
Guild Plugin의 소스 코드와 설치 방법은 dev-yakuza/deku-claude-plugins 저장소에서 확인할 수 있습니다.
이 글은 Guild Plugin 시리즈의 4부(마지막)입니다.
- 1부. Skill이 아니라 조직을 키운다 — 왜 만들게 되었나
- 2부. 에이전트 조직의 구조와 개발 흐름
- 3부. 성장 엔진 ①② — 결과물과 개발자의 공진화
- 4부. 성장 엔진 ③ + 안전 — 감독자(사람)도 함께 자란다 (이 글)
세 번째 성장 대상은 사람이다
생각해 보면 이상한 일입니다. 도구(②)는 점점 똑똑해지는데, 그것을 쓰는 사람(③)은 그대로라면? 사람은 “왜 이렇게 하는지”는 모른 채 결과만 받아들이게 되고, 점점 도구에 의존하기만 합니다. 조직은 성장하는데 감독자는 정체하는 셈입니다.
그래서 Guild Plugin은 감독자(사람)도 조직의 한 구성원으로 보고 함께 성장시키려고 합니다. 다만 사람은 아주 특별한 구성원입니다. 성과 추이는 기록되지만, 에이전트처럼 파일로 정의되지도, 인사(HR)의 대상이 되지도 않습니다. 사람은 최종 승인권자이자 모든 근거의 원천 — 관리받는 부하가 아니라, 조직의 최고 권위이기 때문입니다.
여기에 하나의 결정적인 설계 원칙이 있습니다. 사람의 성장은 반드시 정상적인 사용의 부수 효과여야 한다는 것입니다. 만약 “학습하기” 같은 전용 명령을 따로 만들면, 아무도 그것을 일부러 실행하지 않을 것이고 — 그러면 감독자는 영영 성장하지 못할 것입니다. 그래서 사람을 키우는 장치들은 별도의 명령어가 아니라, 이미 Guild Plugin으로 매일 쓰는 명령어(review·evolve·dev) 안에 심어져 있습니다. (딱 하나, 코드베이스를 안내하는 onboard만 독립된 학습 명령입니다.)
사람은 어떻게 배우는가
정상 사용 안에 심어진 학습 장치들은 학습과학에서 힌트를 얻었습니다.
- 왜를 가르친다 — 가이드 리뷰(
review)에서 “무엇을 고쳤나”만이 아니라 그 근본 원리를 짚어 줍니다. “여기서 이 값을 분기했다”가 아니라 “모드에 따라 달라지는 값은 분기하는 것이 원칙”인 것처럼요. 국소적인 사실이 아니라 전이 가능한 원리를 배우게 합니다. - 답을 보기 전에 예측하게 한다 — 문제를 공개하기 전에 먼저 “이 부분, 어디가 위험해 보이세요?”라고 묻습니다. 예측과 실제의 차이가 그냥 답을 보는 것보다 훨씬 오래 기억에 남습니다.
- 당신의 결정 패턴을 비춘다 —
evolve가 감독자의 반복되는 결정과 맹점을 (실제 결과에 근거해) 회고로 보여 줍니다. “이 위험을 세 번 수용하셨습니다 — 그 근본 원리는…”처럼, 자기 자신의 패턴을 보게 합니다. - 적시에 상기시킨다 — 과거에 반복했던 맹점 영역을 다시 건드리려는 바로 그 순간, 그 교훈 하나를 짚어 줍니다. 나중에 몰아서 보고하는 것보다 훨씬 효과적입니다.
- 실력에 맞춰 물러난다 — 어떤 영역에 익숙해질수록 설명을 줄입니다. 초보일 땐 충분히 풀어서, 숙련되면 한 줄로. 잔소리도, 과소 설명도 피합니다.
- 시스템을 안내한다 — 새 메인테이너를 위해 코드베이스를 한 정거장씩 짚어 주는
onboard명령어도 있습니다. 유일하게 독립적으로 실행하는 학습 장치입니다.
사람을 가르칠 때의 원칙
사람을 가르치는 것은 에이전트를 가르치는 것보다 더 위험합니다. 사람은 배운 것을 믿고, 일반화하고, 실제 권한으로 행동하기 때문입니다. 그래서 사람을 향한 기준은 한층 더 엄격합니다.
- 반드시 실제 결과에 근거한다 — 모든 교훈은 검증된 결과, 실제로 발생한 결함, 또는 확정된 표준에 묶여 있어야 합니다. AI의 의견은 교훈이 아닙니다. 근거가 없는 관찰은 기껏해야 “확인이 필요한 후보”로만 제시됩니다.
- 권고이고, 선택이고, 가르치려 들지 않는다 — “이런 관점이 있습니다”이지 “당신이 틀렸습니다”가 아닙니다. 언제든 무시할 수 있고, 강요하지 않습니다.
- 사람에게는 읽기 전용이다 — Guild Plugin은 사람을 “고치려” 하지 않습니다. 보여주고, 제안하고, 물을 뿐입니다. 최종 판단과 승인 권한은 언제나 사람에게 있습니다.
정리하면, 도구가 조직을 향해서는 습관을 새기고 규칙을 강제하지만, 사람을 향해서는 오직 보여주고 제안할 뿐입니다. 그 경계가 명확합니다.
스스로 고치는 AI를 어떻게 안전하게 하는가
스스로 코드와 조직과 규칙을 고치는 도구는, 잘못 성장하면 오히려 해가 됩니다. 그래서 Guild Plugin의 자기 성장은 몇 가지 불변 원칙(never 규칙) 위에 서 있습니다.
- 적용은 언제나 사람이 승인한다 — 자동으로 반영되는 변경은 없습니다. 사람이 항목별로 승인해야만 적용됩니다.
- 검증을 약화하지 않는다 — 테스트나 게이트를 무력화하는 방향의 변경은 애초에 허용되지 않습니다. 예외가 없습니다.
- 모든 적용은 되돌릴 수 있다 — 백업·롤백·이력 기록과 함께 적용되어, 언제든 원상 복구할 수 있습니다.
- 적대적으로 먼저 검증한다 — 자기 수정을 적용하기 전에, 사전 문맥이 없는 독립 검토단이 “이 변경은 틀렸다”고 반박을 시도합니다. 자기에게 유리한 변경을 스스로 통과시키지 못하게 하는 장치입니다.
- 근거가 충분할 때만 자란다 — 흔적이 얕으면 성장을 아예 거부합니다.
그리고 이 원칙들 위에, 한 겹의 결정적인 커밋 게이트가 더 있습니다. 커밋에 비밀 키가 섞이거나 검증을 약화하는 변경이 들어가면 자동으로 차단합니다 — 사람이 실수하든, AI가 실수하든 상관없이요. 이것은 프롬프트가 아니라 결정적으로 동작하는 스크립트이기 때문에 우회할 수 없습니다.
핵심은 이렇습니다. 자기 성장의 자유는, 되돌릴 수 있고 · 사람이 승인하고 · 검증을 약화하지 않는 울타리 안에서만 허용됩니다.
세 축이 함께 자란다
이제 그림이 완성됩니다. Guild Plugin은 세 가지를 하나의 루프 안에서 함께 키웁니다.
- ① 결과물 — 개발 흐름이 코드베이스를 쌓고,
- ② 개발자 — 그 개발이 남긴 흔적이 조직을 키우고,
- ③ 감독자 — 그 과정을 지켜보는 사람이 원리를 배웁니다.
좋은 조직이 좋은 결과물을 만들고, 그 결과물의 흔적이 다시 조직을 개선하고, 그 모든 과정을 감독하는 사람까지 — 셋이 함께 나아집니다. 대부분의 도구가 결과물 하나만 개선하는 것과 달리, Guild Plugin은 이 셋을 한 루프에서 키웁니다. 이것이 처음부터 이야기한 공진화의 완성형입니다.
완료
이 시리즈를 한 줄로 되짚으면 이렇습니다.
AI와 체계적으로 개발하게 해 준 SDD Plugin에는 “도구가 스스로 성장하지 않는다”는 한계가 있었습니다. 그 문제를 사람들이 일하는 방식, 즉 조직에서 힌트를 얻어 풀어낸 것이 Guild Plugin입니다. 레포 전용 에이전트 조직이 개발을 수행하고, 그 흔적으로 결과물·개발자·감독자가 함께(공진화) 성장하되, 사람 승인·가역성·검증 보호라는 울타리 안에서 안전하게 성장합니다..
Guild Plugin은 아직 계속 다듬어지고 있습니다 — 실제로 쓰면서 발견한 것들이 다시 도구를 고치고 있으니, 어쩌면 그 자신이 가장 먼저 이 성장 엔진의 대상인지도 모르겠습니다.
Guild Plugin은 deku-claude-plugins 마켓플레이스에서 사용할 수 있습니다. 전체 시리즈는 1부 · 2부 · 3부 · 4부(이 글)로 이어집니다.
제 블로그가 도움이 되셨나요? 하단의 댓글을 달아주시면 저에게 큰 힘이 됩니다!
앱 홍보
Deku가 개발한 앱을 한번 사용해보세요.Deku가 개발한 앱은 Flutter로 개발되었습니다.관심있으신 분들은 앱을 다운로드하여 사용해 주시면 정말 감사하겠습니다.