요즘 Claude Code 기반 에이전트 스킬들을 직접 사용해보면서 느낀 점을 정리해보았습니다. 단순히 “AI가 코드를 잘 작성해준다”는 수준은 이미 기본이 된 것 같고, 실제로 생산성 차이가 나는 구간은 AI를 어떻게 활용하느냐, 특히 컨텍스트 관리, 역할 분리, 작업 흐름 설계 + 토큰 효율 최적화에 있다고 판단됩니다. 이러한 관점에서 실무에 적용할 수 있는 몇 가지 도구를 공유드립니다.
이거 몇 개만 셋업해도 사실상 웬만한 개발 업무는 다 커버된다고 느꼈습니다. Claude Code 셋업 막막하신 분들은 이거부터 시작하셔도 충분할 것 같습니다. 사내에도 공유했던 기준으로 핵심만 정리해봤습니다.
1. code-review-graph — 코드 이해 효율을 개선하는 도구
https://github.com/tirth8205/code-review-graph
code-review-graph는 코드베이스를 knowledge graph 형태로 구성하여, AI가 필요한 부분만 선택적으로 읽을 수 있도록 도와주는 도구입니다. 기존에는 AI가 요청을 처리할 때마다 전체 레포지토리를 다시 읽는 구조였기 때문에, 불필요한 토큰 사용과 함께 맥락을 잘못 이해하는 경우가 종종 발생하였습니다.
이 도구를 적용하면 코드 간의 구조적 관계를 기반으로 필요한 파일만 참조하게 되어, 리팩토링이나 영향 범위 분석 시 보다 정확한 결과를 도출할 수 있습니다. 특히 “특정 변경이 어디까지 영향을 미치는지” 빠르게 파악해야 하는 상황에서 유용합니다.
다만 초기 세팅이 다소 번거로울 수 있으며, 프로젝트 규모가 작은 경우에는 체감 효과가 제한적일 수 있습니다. 반대로 코드베이스가 일정 규모 이상일 경우 충분한 도입 가치가 있다고 판단됩니다.
2. gstack — 설계 중심 개발을 유도하는 워크플로우 도구
https://github.com/garrytan/gstack
gstack은 단순한 코드 생성 도구라기보다는, 개발 전 단계에서의 설계와 문서화를 강제하는 워크플로우 도구에 가깝습니다. Think → Plan → Build → Review → Test → Ship의 전체 사이클을 단계적으로 수행하도록 구성되어 있으며, 각 단계에서 필요한 정보를 명확히 정리하도록 유도합니다.
실제 사용 시 코드 작성을 바로 시작하기보다, 요구사항 정의, 아키텍처 설계, 테스트 전략 수립 등의 과정을 먼저 거치게 됩니다. 초기에는 작업 속도가 느려진다고 느낄 수 있으나, 반복 사용 시 설계 없이 구현을 진행했다가 재작업하는 상황이 줄어드는 효과를 확인할 수 있습니다.
다만 이미 요구사항과 구조가 명확한 상태에서 빠르게 구현이 필요한 경우에는 다소 비효율적으로 느껴질 수 있습니다. 설계 단계가 중요한 프로젝트나 기능 개발 초기에 특히 적합한 도구입니다.
3. Everything Claude Code — AI 개발 워크플로우 통합 세팅
https://github.com/affaan-m/everything-claude-code/blob/main/docs/ko-KR/README.md
Everything Claude Code는 Claude Code를 활용하기 위한 다양한 설정을 통합한 레포지토리로, 역할 기반 프롬프트, 테스트 규칙, 자동화 훅, MCP 연동 등을 포함하고 있습니다. 개별적으로 구성하기 번거로운 요소들을 하나로 묶어, AI 기반 개발 환경을 빠르게 구축할 수 있도록 돕습니다.
이 도구의 장점은 “AI를 팀원처럼 활용할 수 있는 구조”를 기본적으로 제공한다는 점입니다. 프로젝트에 적용하면 일정한 방식으로 작업 흐름을 유지할 수 있으며, 테스트 및 문서 생성 또한 자연스럽게 포함됩니다.
다만 초기 구조를 이해하는 데 시간이 필요하며, 기본 설정이 다소 무겁게 느껴질 수 있습니다. 그럼에도 불구하고 AI 워크플로우를 체계적으로 구성하고자 하는 경우에는 충분히 고려할 만한 선택지입니다.
4. caveman — 토큰 비용 최적화 도구
https://github.com/JuliusBrussee/caveman
caveman은 AI 응답을 최대한 간결하게 압축하여 토큰 사용량을 줄이는 도구입니다. 불필요한 설명을 제거하고 핵심 정보만 전달하는 방식으로 동작합니다.
코드 리뷰, 반복 작업, 자동화된 QA 등에서 토큰 사용량이 누적되는 상황에서 특히 효과적이며, 실제로 비용 절감이 즉각적으로 체감됩니다. 내용의 정확도를 크게 훼손하지 않으면서 표현만 간결하게 만드는 구조이기 때문에, 부담 없이 적용할 수 있습니다.
다만 응답이 다소 건조하게 느껴질 수 있으며, 초기에는 가독성이 떨어진다고 느낄 수 있습니다. 그러나 일정 기간 사용하면 충분히 적응 가능한 수준입니다.
결론
각 도구의 역할을 정리하면 다음과 같습니다.
code-review-graph는 AI가 “무엇을 읽을지”를 최적화하고,
gstack은 “어떻게 개발할지”에 대한 흐름을 정의하며,
Everything Claude Code는 이를 팀 단위 워크플로우로 확장하고,
caveman은 비용을 효율적으로 관리하는 역할을 수행합니다.
사실 더 있긴 한데, 사내 공유할만한건 저정도로 충분해보여서 겸사겸사 블로그 포스팅까지 해봤습니다.
- 사이드플젝 단위로는 https://github.com/phuryn/pm-skills 라던가 디자인 시스템 에이전트 스킬 같은 것도 정리해서 따로 추후 포스팅해보겠습니다.
- 추천 댓글 완전 환영합니다 !!!!! (슬랙에서도 개인 셋업 추천 관련 답글들이 핫하게 달리고 잇음.)
'재밌는 개발글이지만 아직 미분류' 카테고리의 다른 글
| SSOT를 향한 사고의 이동: 이번 세션에서 정리된 깨달음의 타임라인 (아무말) (0) | 2026.05.21 |
|---|---|
| ● AI 하네스 깎는 노인 (0) | 2026.04.16 |
| 맥북 셋업 가이드 (0) | 2026.01.20 |
| [2024-06-12] chapter 1.0 ~ 2.4 / keyword: integer type, NO Truthy/Falsy concept in Rust, panic! & Error with ROP (2) | 2025.06.12 |
| [Staging] expiry (4) (0) | 2025.06.12 |