Show GN: Claude Deep Suite - Claude Code용 구조화된 개발 플러그인 번들 (6개 플러그인)
(github.com/Sungmin-Cho)Claude Code를 써오면서 아마 다들 겪으셨던 것처럼 저 또한 처음에는 그 똑똑함에 놀라지만 이내 내가 원하는대로 구현되지 않는 '현실'에 직면하게 되었습니다. 이후, Harness Engineering에 대한 개념이 등장했고 이 Harness Engineering을 녹인 개발 워크플로우 Suite를 만들어 보았습니다.
Deep-Suite에는 총 6개의 플러그인이 있습니다.
- deep-work
- deep-review
- deep-wiki
- deep-evolve
- deep-docs
- deep-dashboard
Claude Code에 /deep-work "기능 추가" 하나 치면 이런 일이 벌어집니다.
-
코드베이스를 먼저 읽습니다 (Research). 이 동안 코드 수정을 시도하면
PreToolUse hook이 exit 2로 차단합니다. LLM에게 "수정하지 마"라고
프롬프트로 부탁하는 게 아니라, Write/Edit 도구 자체를 물리적으로 막습니다. -
구현 계획을 세웁니다 (Plan). 프로젝트가 Next.js면 자동 감지해서
"use client를 layout.tsx에 쓰지 마라" 같은 프레임워크별 가이드를 적용합니다.
(React SPA, Express API, Python 등 6개 토폴로지 내장) -
구현은 TDD로 강제합니다. 실패하는 테스트를 먼저 작성해야
프로덕션 코드 수정이 허용됩니다. 이것도 hook이 상태 머신으로 관리합니다. -
코드를 수정할 때마다 센서가 자동 실행됩니다. ESLint, tsc, ruff, mypy,
dotnet build, clang-tidy — 프로젝트 언어에 맞는 린터/타입체커를
자동 감지하고 돌립니다. 에러가 나면 다음 구현으로 못 넘어갑니다. -
구현이 끝나면 별도 Opus 에이전트가 코드를 리뷰합니다.
코드를 작성한 에이전트와 리뷰하는 에이전트가 완전히 분리되어 있습니다.
같은 에이전트가 자기 코드를 "LGTM" 하는 문제가 구조적으로 없습니다.
이게 deep-work + deep-review 두 플러그인이 하는 일이고,
나머지 4개가 더 있습니다.
deep-wiki — 세션 간 지식이 사라지는 문제를 해결합니다.
Karpathy의 LLM Wiki 아이디어를 구현해서, Claude Code가 직접
마크다운 위키를 점진적으로 구축합니다.
URL이나 파일을 /wiki-ingest로 넣으면 기존 위키에 통합하고,
/wiki-query로 질문하면 위키를 근거로 답변합니다.
Obsidian vault로 바로 열립니다.
deep-evolve — 목표를 주면 코드를 자율적으로 개선합니다.
Karpathy의 autoresearch에서 영감을 받았습니다.
프로젝트를 분석해서 평가 스크립트를 생성하고,
코드 수정 → 평가 → 점수 올랐으면 keep / 내렸으면 discard를
자동으로 반복합니다. ML 훈련부터 테스트 커버리지까지 적용 가능합니다.
deep-docs — CLAUDE.md 같은 에이전트 지침 문서가 코드와
어긋나지 않았는지 검사하고 자동 수정합니다.
deep-dashboard — 위 플러그인들의 센서 결과를 모아서
코드베이스가 AI 에이전트와 일하기에 얼마나 적합한지
정량 점수(0-10)로 보여줍니다.
전체 36,000줄, 테스트 5,400줄. 6개 플러그인이 하나의
마켓플레이스에서 설치됩니다.
설치:
/plugin marketplace add Sungmin-Cho/claude-deep-suite
/plugin install deep-work@Sungmin-Cho-claude-deep-suite
각 플러그인을 개별로 설치할 수도 있습니다.
아직 부족한 부분이 많습니다.
피드백 환영합니다.