gate-kit 윈도우 전용으로 다시 만들면서 배운 것들
2026.10.03

반갑습니다 진여진입니다 🙇♂️
24기 클코 서비스에 스터디장님에게 받은 에이전트 템플릿을
window 전용으로 개선하며 배운 것들 정리하려고 글을 올려요~
로미오 스터디장님의 템플릿은 아래에 👇
https://github.com/LovelyPaul/gatekit
템플릿 이해부터 해볼까요?
현재 제공받은 템플릿의 목적과 취지를 제가 이해한 언어로 정리해보면 이렇습니다.
사용자가 모호한 생각을 구체화하기
HTML 기반으로 빠른 산출물을 만들기 -> 이게 프로토타이핑이겠죠?
Claude_in_chrome 브라우저 도구를 통해 e2e 테스트를 진행
사용자의 취향과 요구사항이 프로젝트에 완성이 되었다면 -> Figma MCP 로 컴포넌트, 변수 등을 제작
이후 유지보수 + 기능 고도화 ..
이렇게 되는 것으로 이해했습니다.
어떤 장점이 있는가
이 템플릿이 제공하는 방향성과 기능은 이런 것 같아요
비개발자 입장을 고려해서 사용자의 모호한 생각을 뚜렷하게 하기
사용자가 잘 모르는 스펙 기반 문서화 -> 구현 단계에서 검증 (gate) 을 스크립트로 촘촘하게 했다.
스펙 주도 개발로, 문서를 올바르게 작성하기
개발 -> 검증을 구현 후 tdd 기반으로 테스트 코드 작성
테스트 코드가 올바르게 됐는지 검증을 꼼꼼하게 하기
아키텍쳐 문서와 의사결정 문서화 (ADR) 를 잘 작성해준다
사용자는 의도를 설계문서와 코드로 강제할 수 있다.
의사결정 과정을 문서로 남기니 인수인계 및 커뮤니케이션 문제를 해결할 수 있다.
정도로 정리해서 볼 수 있을 것 같습니다.
만들어주신 에이전트 템플릿이 체계적이고
여러 관점에서 둘러볼 것들이 있어 잘 배웠습니다 ㅎㅎ
그럼 문제는 무엇이 있을까?
Gate 검증 과정이 처음 사용하는 사람 의도와 벗어나도 실행한다.

클로드 코드 전용 플러그인이기에, 다른 도구에 범용적으로 사용하기 어렵다. [이건 문제라고 해야할까요..? 🤣]
mac 운영체제 중심으로 만들어져, window 사용자가 이용하기 어렵다.
플러그인으로 만들어져 있아, 처음 이용하는 분들이 설치/적용이 어렵다.
이 외 글로 담아내기엔 어려운 것들이 있지만,
이 정도 문제를 개선을 하려고 했습니다.
개선 방향
클로드 코드를 이용하는 window 를 사용자를 위해 개선하자
윈도우 전용 패키지, 라이브러리 등의 셋팅을 할 수 있도록 하자
powershell 7 버전을 설치하자 [이게 더 좋으니까]
winget (윈도우 패키지 매니저)
uv (python 패키지 매니저) 등이 해당된다.
클로드 코드 플러그인에서 코드베이스로 변경하자
베포하고 설치하면 바로 이용할 수 있도록 하자
유지보수가 필요한 경우는 사용자가 알아서 하라고 하자 [그래도 된다...아마]
윈도우 운영체제의 근본적인 문제를 해결하자
문제는 아래와 같다.
user 사용자 권한 문제
path 경로 등록 문제
이스케이프, 문법 등 잡스러운 에러
클코가 powershell 7 을 사용할 수 있도록 하자
tool : powershell = 1옵션이 있다.
그럼 해보면서 배운 것은 무엇이었을까요?
배운 것
1. 기존 템플릿을 수정하는 것 보다. 새롭게 다시 만드는게 빨랐을 것 같다.

아무리 AI 가 이 코드를 쉽고 자세하게 설명하더라도
기능을 수정/삭제 할 땐 사용자의 이해와 지시가 필요하니
제작자의 의도를 이해해야 했습니다.
회고해보니 의도를 이해하고 수정/삭제 하는 방법보다
의도를 이해한 뒤 처음부터 만드는게 더 빨랐다고 생각하게 됩니다.
이유는
지금 프로젝트는 엔터프라이즈 레벨에서 의사결정이 많이 필요하지 않다.
코드베이스 규모가 비교적 작아서 [10~50 만줄 이내] 새롭게 만드는 비용이 저렴하다.
AI 는 기존 지시를 읽고 답을 생성하는 모델이니, 수정/삭제 를 어려워 한다. 정도가 되겠네용
2. 테스트 코드는 스펙과 코드에 의존하니 역설적으로 초기 의도가 중요하다

기존 테스트 코드들은
템플릿 제작자가 의도한 지침이 올바르게 수행하기 위해 만들어진 코드들입니다.
이 코드들을 개선하려면
필요한 라이브러리를 사용하여 시간을 줄인다.
지침을 수정하고 테스트 코드를 개선한다.
애초에 테스트 코드를 사용하지 않아도 해결할 수 있도록 한다.
이렇게 있을 것 같지만,
문제는 이 템플릿을 제가 만든 템플릿이 아니기도 하고
모든 참여자가 4주 동안 이용해야하는 상황이니,
이런 부분에서 개선하는게 어려웠어요 ㅠ
이런 어려움을 잘 이야기하는 소통 능력이 중요하겠죠?
3. 에이전트 기반 서비스는 비지니스 모델이 어려운 것 같다

과감한 발언일 수 있지만,
스터디 주제가 프로토타입을 넘어 실제품을 만드는 스터디이고
사내 자동화와 에이전트 구축과 교육으로
밥 벌어 먹고 있는 사람이라 더 이런 생각을 하는 것 같습니다.
이유를 한 문장으로 적어보자면
에이전트는 사용자의 배경지식을 기대고 있기 때문이에요
소비자의 에이전트 이용 숙련도와 사용 목적을 예상하기 어렵고,
소비자 역시 배경지식을 바탕으로 에이전트가 업무하기 떄문에
개발자와 소비자 배경지식에 의존하는 서비스가
과연 비지니스 모델로서 좋을까? 이런 생각들을 하게 되는
좋은 레슨런이었답니다 ㅎㅎ
그래서 제가 만든 템플릿은?
아래 링크에서 다운받아 사용해주세요!
윈도우 클로드 코드만 가능하고.
설치를 마치고 /gatekit-setup 명령어를 실행해주세요!
로그인하고 댓글을 남겨 주세요
진여진님, 기존 템플릿을 윈도우에서 그대로 고치는 대신 의도를 이해하고 다시 만드는 편이 빨랐다는 시행착오가 와닿았어요.
PowerShell 7·winget·uv뿐 아니라 사용자 권한과 PATH, 이스케이프 문제까지 짚어주셔서 윈도우 환경의 실제 허들이 선명해졌어요.
테스트가 처음 설계한 의도에 묶일 수 있다는 점과, 제작자·사용자 간 배경지식 차이가 제품화에 미치는 영향까지 연결한 부분도 생각할 거리를 주네요. 개선 과정을 공유해주셔서 감사해요!
꼬리 탁! 다음 실험도 응원하고 갈게요 🐈⬛




진여진 님 스터디장님과 함께 많이 도와주셔서 항상 감사합니다. 😀
window 컴이 없어서, 항상 답하기 곤란했는데, 알잘딱깔센 정리해주셔서 감사합니다👍 👍
아니에요~ 다행히도 집에 윈도우 데스크톱이 있어서 도움드릴 수 있어 다행이네요 😌