cubetribe/ClaudeCode_GodMode-On

당신은 지금 정답을 보고 있습니다.

시작은 단순했습니다: 한 명의 개발자, 극심한 수면 부족, 그리고 하나의 비전.

1단계 (Phase 1): 수동 노동. 베스트 프랙티스 (Best practices) 조사. 문서 읽기. 프롬프트 (Prompts) 테스트. 실패. 반복. 에이전트 (Agent)를 하나씩 구축. 워크플로 (Workflow)를 하나씩 구축. 몇 주간의 반복.

2단계 (Phase 2): 시스템이 작동합니다. 8개의 특화된 AI 에이전트 (AI agents)가 스스로를 오케스트레이션 (Orchestrating) 합니다. 기능이 구축되고, 버그가 수정되며, 문서가 스스로 작성됩니다. "꽤 괜찮은데," 라고 저는 생각했습니다.

3단계 (Phase 3): 2026년 1월 6일. 한 가지 생각: "만약 내가 이 시스템을... 시스템을 개선하는 데 사용한다면 어떨까?"

저는 단 하나의 프롬프트 (Prompt)를 주었습니다. 오케스트레이터 (Orchestrator)는 리서치 팀 (Research team)에 권한을 위임했습니다. 자신의 아키텍처 (Architecture)를 분석했습니다. 비효율성을 찾아냈습니다. 개선 사항을 제안했습니다. 이를 구현했습니다. 스스로 검증했습니다. 변경 사항을 문서화했습니다.

루프 (Loop)가 완성되었습니다.

4단계 (Phase 4): 당신은 이 README를 읽고 있습니다. AI가 이 중 일부를 작성했습니다. AI가 이를 개선할 것입니다. 실험은 계속됩니다.

CC_GodMode는 Claude Code를 스스로 오케스트레이션하는 개발 팀으로 변모시킵니다.

당신은 '무엇(WHAT)'을 말하세요. AI가 '어떻게(HOW)'를 찾아냅니다.

당신: "JWT를 사용한 사용자 인증이 필요해"
오케스트레이터 (Orchestrator):
→ 요청 분석
...

차이점은 무엇일까요?

CC_GodMode 미사용	CC_GodMode 사용
당신: "기능을 설계해줘"	당신: "기능 X를 구축해줘"
...	...

8명의 전문가. 각자 고유한 전문 지식을 보유하고 있습니다. 각자가 무엇을 해야 하는지, 그리고 무엇을 할 수 없는지를 정확히 알고 있습니다.

에이전트 (Agent)	역할 (Role)	전문 분야 (Specialty)
`@researcher`	지식 발견 (Knowledge Discovery)	웹 조사, 문서 조회, 기술 평가 (신규 v5.10.0)
`@architect`	시스템 아키텍트 (System Architect)	상위 수준 설계, 모듈 구조, 기술 결정
`@api-guardian`	API 생명주기 전문가 (API Lifecycle Expert)	파괴적 변경 (Breaking changes), 소비자 영향, 계약 검증
`@builder`	시니어 개발자 (Senior Developer)	구현, `@architect`의 사양 준수
`@validator`	코드 품질 게이트 (Code Quality Gate)	TypeScript, 단위 테스트 (Unit tests), 보안, 소비자 검증
`@tester`	UX 품질 게이트 (UX Quality Gate)	E2E 테스트, 시각적 회귀 (Visual regression), 접근성, 성능 (강화됨 v5.10.0)
`@scribe`	기술 작가 (Technical Writer)	문서화, 변경 이력 (Changelog), 버전 관리
`@github-manager`	GitHub 매니저 (GitHub Manager)	이슈 (Issues), PR, 릴리스, CI/CD 오케스트레이션

이중 품질 게이트 (Dual Quality Gates):

@builder 완료
│
┌───────────────┴───────────────┐
...

v6.0에서 모듈형 아키텍처 (Modular architecture)를 도입했습니다. v6.1에서는 스킬 (Skills)을 추가했습니다. v6.2에서는 워크트리 격리 (Worktree isolation)를 추가했습니다. v6.3에서는 플러그인 패키징 (Plugin packaging)을 추가했습니다.

~/.claude/ ← 런타임 (RUNTIME) (Claude가 로드하는 것)
├── agents/ ← 8명의 에이전트, 전역적으로 사용 가능
│ ├── researcher.md
...

your-project/ ← 사용자의 프로젝트 (YOUR PROJECT)
├── CLAUDE.md ← 오케스트레이터 (Orchestrator) (~65줄, 자동 로드됨!)
├── VERSION ← 단일 진실 공급원 (Single source of truth)
...

핵심 비결: CLAUDE.md는 Claude Code에 의해 자동으로 로드됩니다. 65줄의 코드에는 핵심 규칙이 포함되어 있습니다. 상세 문서는 필요할 때만 로드되므로 — 컨텍스트 낭비는 줄이고 집중도는 높입니다.

CC_GodMode는 에이전트를 위해 **이중 위치 모델 (Dual-location model)**을 사용합니다:

┌─────────────────────────────────────────────────────────────────────┐
│ 에이전트 이중 위치 모델 (AGENT DUAL-LOCATION MODEL) │
├─────────────────────────────────────────────────────────────────────┤
...

왜 이런 설계인가요?

소스 (Source) (/agents/): Git에서 추적되며, 공유 및 업데이트가 가능합니다.
런타임 (Runtime) (~/.claude/agents/): Claude Code가 실제로 에이전트를 찾는 곳입니다.

업데이트 흐름:

/agents/ (소스)에서 에이전트 수정 — 설치 스크립트 실행
변경 사항이 ~/.claude/agents/ (런타임)로 복사됨 — Claude Code가 업데이트된 에이전트를 사용

오케스트레이터(Orchestrator)가 적절한 워크플로우(workflow)를 자동으로 선택합니다:

새로운 기능 (New Feature):

(@researcher)* → @architect → @builder → (@validator ∥ @tester) → @scribe

버그 수정 (Bug Fix):

@builder → (@validator ∥ @tester)

API 변경 사항 (중요! / API Change (Critical!)):

(@researcher)* → @architect → @api-guardian → @builder → (@validator ∥ @tester) → @scribe

리팩토링 (Refactoring):

@architect → @builder → (@validator ∥ @tester)

연구 작업 (Research Task) (신규 v5.10.0):

@researcher → 출처를 포함한 보고서 작성 (report with sources)

*@researcher는 선택 사항입니다 - 새로운 기술/라이브러리 연구가 필요할 때 사용하세요.

참고: v5.6.0부터 품질 게이트(quality gates)가 병렬(PARALLEL, ∥ 기호)로 실행되어 검증 속도가 40% 더 빨라졌습니다.

릴리스 (Release):

@scribe → @github-manager

비밀 재료: 모든 파일 변경 후에 실행되는 PostToolUse 훅(hook)입니다.

개발자 변경 사항: shared/types/User.ts
│
▼
...

어떤 것도 잊히지 않습니다. 훅(hook)이 당신을 대신해 기억합니다.

단 하나의 프롬프트(prompt). Claude가 모든 것을 설치합니다.

1단계: 권한을 부여하여 Claude를 시작합니다:

claude --dangerously-skip-permissions

2단계: CC-GodMode-Prompts/CCGM_Prompt_Install.md의 전체 내용을 복사하여 붙여넣으세요.

3단계: 지켜보세요. Claude가 다음 작업을 수행합니다:

저장소(repository) 클론
8개의 에이전트(agents)를 전역(globally)으로 설치
훅(hook) 스크립트 설정
Memory MCP 서버 설치
구성 및 검증

왜 --dangerously-skip-permissions를 사용하나요? 30개 이상의 파일 작업이 필요하기 때문입니다. 이 옵션이 없다면 각 작업을 수동으로 확인해야 합니다.

단계별 지침은 CC-GodMode-Prompts/CCGM_Prompt_ManualInstall.md를 참조하세요.

CC_GodMode에는 다양한 시나리오를 위한 즉시 사용 가능한 프롬프트(prompts)가 포함되어 있습니다:

프롬프트 파일	목적	사용 시점
`CCGM_Prompt_Install.md`	원샷 설치 (One-shot installation)	`--dangerously-skip-permissions`를 사용한 최초 설정 시
`CCGM_Prompt_ManualInstall.md`	단계별 설치 (Step-by-step installation)	수동 제어를 선호할 때
`CCGM_Prompt_ProjectSetup.md`	프로젝트에 오케스트레이터 (orchestrator) 주입	기존 프로젝트의 `CLAUDE.md`에 CC_GodMode를 추가할 때
`CCGM_Prompt_Restart.md`	중요 컨텍스트 복구 (Context recovery)	`/compact` 사용 후, 긴 세션 이후, 또는 매번 새로운 세션을 시작할 때

┌─────────────────────────────────────────────────────────────────────────────┐
│ PROMPT DECISION TREE │
├─────────────────────────────────────────────────────────────────────────────┤
...

CCGM_Prompt_Restart.md가 왜 그렇게 중요한가요?

Claude Code는 세션 간에 오케스트레이터 모드 (orchestrator mode)를 자동으로 기억하지 않습니다. 설령 다음과 같은 상황이라도 말이죠:

CC_GodMode가 전역적으로 설치되어 있음
프로젝트에 CLAUDE.md가 구성되어 있음
어제 모든 것이 완벽하게 작동했음

다음과 같은 경우에는 반드시 재시작 프롬프트 (Restart Prompt)를 사용해야 합니다:

새로운/신선한 Claude Code 세션을 시작할 때
/compact (컨텍스트 요약)를 사용한 후
Claude가 무언가를 "잊어버리는" 것 같은 긴 세션 이후
Claude가 위임 (delegating)하는 대신 직접 구현 (implementing)하기 시작할 때

재시작 프롬프트가 필요한 징후:

Claude가 에이전트 (agents)를 호출하는 대신 코드를 직접 작성함
Claude가 API 변경 사항에 대해 @api-guardian을 호출하는 것을 잊어버림
Claude가 품질 게이트 (quality gates, @validator 또는 @tester)를 건너뜀
Claude가 허가 없이 푸시 (push)를 진행함

시나리오	조치
생전 처음 사용하는 경우	`CCGM_Prompt_Install.md` 사용
새 프로젝트 (CC_GodMode가 이미 설치됨)	`CCGM_Prompt_ProjectSetup.md`를 `CLAUDE.md`에 복사
매 새로운 세션마다	`CCGM_Prompt_Restart.md`를 붙여넣기
`/compact` 실행 후	`CCGM_Prompt_Restart.md`를 붙여넣기
Claude가 혼란스러워 보일 때	`CCGM_Prompt_Restart.md`를 붙여넣기

요약 (TL;DR): 한 번 설치하고, 매 세션마다 재시작하세요.

설치 후, 각 프로젝트별로 다음을 수행하세요:

macOS / Linux:

cd your-project
cp ~/.claude/templates/CLAUDE-ORCHESTRATOR.md ./CLAUDE.md
claude

Windows:

cd your-project
Copy-Item "$env:USERPROFILE\.claude\templates\CLAUDE-ORCHESTRATOR.md" ".\CLAUDE.md"
claude

CLAUDE.md가 자동으로 로드됩니다. Orchestrator (오케스트레이터) 모드가 활성화되었습니다.

Model Context Protocol (MCP)을 통한 기능 강화:

서버	에이전트 (Agent)	목적	필수 여부
memory	@researcher, @architect, @scribe	지속적인 지식 유지	✅ 설치됨
playwright	@tester	브라우저 자동화, E2E, 스크린샷	권장
github	@github-manager	이슈 (Issues), PR, 릴리스 (Releases)	권장
lighthouse	@tester	성능 감사 (Performance audits)	선택 사항
a11y	@tester	접근성 테스트 (Accessibility testing)	선택 사항

# 권장되는 MCP 설치
claude mcp add playwright -- npx @playwright/mcp@latest
claude mcp add lighthouse -- npx lighthouse-mcp
...

Version-First (버전 우선)— 모든 작업이 시작되기 전에 버전을 결정합니다.
@researcher for Unknown Tech (미지의 기술을 위한 @researcher)— 새로운 기술에 대한 평가가 필요할 때 사용합니다. (신규 v5.10.0)
@architect is the Gate (설계가 관문입니다)— 설계 없이는 어떤 기능도 시작되지 않습니다.
@api-guardian is MANDATORY ( @api-guardian은 필수입니다)— 모든 API 변경 사항에 적용됩니다.
Dual Quality Gates (이중 품질 관문)— @validator와 @tester를 모두 통과해야 합니다.
@tester MUST create Screenshots (@tester는 반드시 스크린샷을 생성해야 합니다)— 모든 페이지는 3개의 뷰포트(viewports)에서 테스트됩니다. (신규 v5.10.0)
No Skipping (건너뛰기 금지)— 워크플로우 내의 모든 에이전트가 실행됩니다.
Reports in reports/vX.X.X/ (보고서는 reports/vX.X.X/에 저장)— 버전별로 정리됩니다.
NEVER push without permission (허가 없이 절대 푸시하지 마세요)— 모든 에이전트에게 적용됩니다.

CC_GodMode에는 시스템을 이해하고 확장하기 위한 포괄적인 문서가 포함되어 있습니다:

CHANGELOG.md- 전체 버전 히스토리 및 시스템의 진화 과정
AGENT_ARCHITECTURE.md- 이중 위치 모델 (dual-location model)에 대한 이해
AGENT_MODEL_SELECTION.md- 비용 최적화 및 ROI (투자 대비 수익) 분석

REPORT_TEMPLATES.md- 7개 에이전트 모두를 위한 표준화된 형식
CONTEXT_SCOPE_POLICY.md- 에이전트의 경계 및 책임
SECURITY_TOOLING_POLICY.md- 도구 액세스 제어 매트릭스 (access control matrix)

이 문서들은 암묵적인 지식을 명시적인 계약(contracts)으로 변환하여, 시스템을 더욱 유지보수하기 쉽고 예측 가능하게 만듭니다.

Claude Code의 /compact

메모리 손실 (memory loss)을 유발할 수 있습니다. 오케스트레이터 (orchestrator)가 위임 (delegating) 대신 직접 구현을 시작할 때:

CC-GodMode-Prompts/CCGM_Prompt_Restart.md 파일을 엽니다.
재시작 프롬프트 (restart prompt)를 복사합니다.
채팅창에 붙여넣습니다.
오케스트레이터 모드가 복구됩니다.

재시작이 필요한 징후:

Claude가 에이전트 (agents)를 호출하는 대신 코드를 직접 작성함
Claude가 API 변경 시 @api-guardian을 잊어버림
Claude가 품질 게이트 (quality gates) (@validator 또는 @tester)를 건너뜀
Claude가 허가 없이 푸시 (push)를 수행함
Claude가 보고서를 잘못된 폴더에 작성함 (원래 reports/v[VERSION]/ 이어야 함)

Q: 왜 8개의 에이전트인가요?
A: 관심사 분리 (Separation of concerns) 때문입니다. 각 에이전트는 단 하나의 작업만을 수행합니다. 중복도 없고 혼란도 없습니다.

Q: @validator와 @tester의 차이점은 무엇인가요?
A: @validator = 코드 품질 (TypeScript, 테스트, 보안). @tester = UX 품질 (E2E, 시각적 요소, 접근성 (a11y), 성능 (perf)).

Q: @tester를 건너뛰어도 되나요?
A: 백엔드 전용 변경 사항의 경우 가능합니다. UI와 관련된 사항이라면 불가능합니다.

Q: 에이전트가 사용자 허가 없이 푸시할 수 있나요?
A: 아니요. "허가 없이 절대 git push 하지 말 것"이라는 규칙이 모든 에이전트에게 강제됩니다.

Q: 이것은 그저... AI가 AI를 개선하는 것인가요?
A: 네. 그것이 불안한 부분이면서 동시에 매혹적인 부분입니다. 사실 같은 것이죠.

이 README는 부분적으로 AI에 의해 작성되었습니다. 이것을 작성한 시스템이 이를 개선할 것입니다. 루프 (loop)는 계속됩니다.

CC_GodMode v6.3.0 — 플러그인 릴리스 (The Plugin Release)

v6.0: 모듈형 아키텍처 (Modular architecture) — CLAUDE.md가 688행에서 약 75행으로 감소 (-89%)
v6.1: 스킬 아키텍처 (Skills Architecture) — 점진적 공개 (progressive disclosure)를 위한 7개의 온디맨드 (on-demand) SKILL.md 파일
v6.2: 플랫폼 기능 (Platform Features) — 병렬 에이전트를 위한 워크트리 격리 (Worktree isolation), 에이전트 팀 (Agent Teams) 지원, TeammateIdle 훅 (hook)
v6.3: 플러그인 패키징 (Plugin Packaging)

단일 명령 설치를 위한 plugin.json 매니페스트 (manifest)
모델 선택 및 워크트리 격리가 가능한 8개의 특화된 에이전트
이중 품질 게이트 (격리된 워크트리에서의 병렬 실행)
5개의 훅 이벤트 (SessionStart, PostToolUse, SubagentStop, TaskCompleted, TeammateIdle)
자동화된 푸시 전 점검 (pre-push checks)을 포함한 버전 우선 워크플로 (Version-first workflow)

전체 내용은 CHANGELOG.md를 참조하세요.

Dennis Westermann (www.dennis-westermann.de)
수년간의 고통이 이 저장소(repo)로 응축되었습니다. 이제 이 저장소는 스스로를 개선합니다. 그럴 만한 가치가 있었을까요?

Proprietary License (독점 라이선스) — 개인적 사용은 허용됩니다. 상업적 이용에는 허가가 필요합니다.

심각한 수면 부족 상태에서 제작됨

실험은 계속됩니다.

⭐ 너무 불안하지 않다면 별(Star)을 눌러주세요 ⭐

cubetribe/ClaudeCode_GodMode-On

요약

핵심 포인트

댓글