samguk

Samguk (삼국)

Claude Code 서브에이전트를 이름 있는 삼국지 명장으로, 코드베이스를 위·촉·오 영토로, 작업을 전투로 바꾼다 — 단, 오버하지 않게. 실무 도구 90%, 풍미 10%, 한 명령으로 풍미 전부 끔.

한국어 · English · 中文 · 日本語

---

Samguk 는 Claude Code 플러그인 + 로컬 엔지니어링 하네스입니다. 진짜 도구입니다: 요청 intent 를 6가지 전투 유형(토벌/정복/재편/천도/방어/정찰)으로 분류하고, 적합한 장수(서브에이전트)에게 위임하며, 모든 상태를 .samguk/ 에 기록합니다. 삼국지 컨셉은 얇은 외피일 뿐 — 한 줄로 모든 이모지·배너·출진 메시지를 끌 수 있습니다.

한 줄 체험

$ /samguk:init
      🌸  桃 園 結 義  🌸     ← 첫 init 때만 1회
   ┌─────────────────────────┐
   │   劉 ─── 關 ─── 張      │
   │      ⚔   義   ⚔        │
   │  the oath is sworn      │
   └─────────────────────────┘

$ /samguk:plan "결제 모듈 500 버그 수정"
Battle:    토벌전 — "결제 모듈 500 버그 수정"
Faction:   촉(Shu)
General:   제갈량 (諸葛亮) — Planner

$ /samguk:launch
⚔️  관우 (關羽)(executor) 출진 — 토벌전: 결제 모듈 5xx 정찰
↳ 사마의 (司馬懿)(reviewer) — diff 검열
↳ 장료 (張遼)(verifier) — 테스트 실행

$ /samguk:status
✓ 전투 완료. 검열 1회 통과, 재작업 0회.

거추장스러우면:

$ /samguk:config quiet

모든 출진 메시지·배너 무음, 전투 이름은 plain task title 로 표기 — 하네스는 그대로 동작합니다.

실제 들어있는 것

• 이름 있는 장수 5명 = Claude Code 서브에이전트 — jegal-ryang(전략), gwan-u(실행), sa-ma-ui(리뷰), jang-ryo(검증), ju-yu(아키텍트). 스티커가 아니라 실제 모델·도구·페르소나 정의가 붙은 서브에이전트입니다.
• Intent classifier — 자유 요청을 6가지 전투 유형으로 결정론적 분류. LLM 호출 없음.
• 영토 지도 — top-level 디렉토리를 위/촉/오/중립으로 자동 분할. .samguk/territory.json 수동 편집 가능.
• Dispatch hook — PreToolUse(Task) 에 후킹해서 출진 한 줄 emit. quiet 에서 무음.
• 단일 HTML 대시보드 — 영토 treemap, 진행 중 전투, 장수 명부, 이벤트 로그. 서버 없음, 빌드 없음.
• 다국어 — EN / KO / ZH / JA. init 시 선택 또는 /samguk:config locale <code>.
• Quiet 프로파일 로 풍미 전부 off — 진지한 프로젝트에서 그대로 사용 가능.

설치

/plugin marketplace add mir-makeitreal/samguk
/plugin install samguk@samguk
/reload-plugins

짧은 /sg:* 별칭도 함께:

/plugin install sg@samguk

명령 (8개)

명령	별칭	동작
/samguk:init	/sg:init	첫 셋업. .samguk/ 생성, 영토 추론, locale/profile 선택
/samguk:plan <요청>	/sg:plan	intent → 전투 분류, 장수 배정, 전투 plan 작성
/samguk:launch	/sg:launch	배정된 장수를 native Task 로 출진. 출진 메시지 emit
/samguk:status	/sg:status	읽기 전용: 현재 phase, 전투, 장수, 최근 이벤트, 대시보드 URL
/samguk:verify	/sg:verify	선언된 검증 실행, Done 게이트 통과
/samguk:retreat	/sg:retreat	현재 run 안전 git 롤백 (미리보기 후 확인)
/samguk:config <intent>	/sg:config	quiet / default / locale <code> / flavor off|low|high
/samguk:doctor	/sg:doctor	hook / 엔진 / locale / 영토 / 장수 / gitignore 진단

5명의 장수

이름	세력	역할	모델
제갈량 (諸葛亮)	촉	Planner — intake, 분해, 분류	sonnet
관우 (關羽)	촉	Executor — 허용 경로 안에서만 구현	sonnet
사마의 (司馬懿)	위	Code Reviewer — 남이 못 본 이음새	sonnet
장료 (張遼)	위	Verifier — 빠른 합/불 + 최단 재현	haiku
주유 (周瑜)	오	Architect — 교차 영토 리팩토링/마이그레이션	opus

諸葛亮 — Planner

關羽 — Executor

司馬懿 — Reviewer portrait TBD

張遼 — Verifier

周瑜 — Architect

전투 유형

전투	한자	언제
토벌전	討伐戰	버그 수정, 회귀
정복전	征服戰	신기능
재편전	再編戰	동작 변경 없는 리팩토링
천도	遷都	영토 교차 / 프레임워크 업그레이드
방어전	防禦戰	보안, 하드닝
정찰전	偵察戰	조사, spike

분류 confidence < 0.7 → 미지의전투 라벨로 사용자 확인.

상태

v0.1. init / plan / status / config / doctor / dashboard render 는 실제 동작 + 테스트. launch / verify / retreat 은 MVP stub — 전체 실행은 v0.2.

라이센스

MIT.