OMARVII/claude-alloy

Claude Alloy

그 구성 요소들보다 더 강력한 혼합물.

Quick Start • Agents • Install • Dev Guide • Contributing

ig

IGNITE 모드를 활성화합니다 — 강철(steel)이 의도를 언어화하고, 전문가들을 병렬로 실행하며, HUD가 컨텍스트(context) / 비용(cost) / 할당량(quota)을 실시간으로 추적합니다.

팀과 함께하는 Claude Code.

14명의 전문가 에이전트(agent). 모델 계층화(Opus/Sonnet/Haiku)를 통해 검색을 위해 과도한 비용을 지불하는 일을 방지합니다. 런타임(runtime) 제로. 하나의 설정 오버레이(config overlay). 활성화하는 명령 하나, 제거하는 명령 하나.

강철(Steel)은 구조를 유지합니다. 텅스텐(Tungsten)은 압력 아래에서도 녹지 않습니다. 수은(Mercury)은 빠르게 움직입니다. 그래핀(Graphene)은 모든 것을 전도합니다.

alloy

그게 전부입니다. 14명의 에이전트, 23개의 훅(hooks), 10개의 기술(skills), 15개의 명령(commands) + HUD 상태 표시줄(statusline). 전역적으로 활성화됩니다. 어떤 디렉토리에서든 Claude Code를 열고 바로 시작하세요.

이 도구가 시간을 절약해 주었다면, ⭐를 눌러주세요 — 그것이 제가 계속 개발을 이어갈 수 있는 동력이 됩니다.

unalloy

순정(vanilla) Claude로 돌아갑니다. 원래의 설정이 정확하게 복구됩니다.

에이전트 (Agent)	모델 (Model)	역할 (Role)	이름의 이유
steel	opus	메인 오케스트레이터(orchestrator). 계획, 위임, 검증 수행.	모든 것을 하나로 묶어주는 합금.
tungsten	opus	자율 실행. 완료될 때까지 멈추지 않음.	모든 금속 중 가장 높은 녹는점.
quartz	opus	아키텍처 컨설턴트. 읽기 전용(Read-only).	수정처럼 맑음 — 문제를 꿰뚫어 봄.
carbon	sonnet	전략 기획자. 인터뷰 우선 방식.	기초 원소 — 모든 구조의 기반.
gauge	sonnet	코드 및 계획 검토자. 합격/불합격 판정.	정밀하게 측정함. 모호함 없음.
graphene	sonnet	외부 문서 및 조사.	원자 한 층의 두께. 모든 것을 전도함.
prism	sonnet	계획 수립 전 숨겨진 모호함 탐색.	빛을 분산시켜 모든 각도를 드러냄.
spectrum	sonnet	이미지, PDF, 다이어그램 분석.	시야의 전체 범위.
mercury	haiku	빠른 코드베이스 검색. 저렴한 실행 비용.	수은(Quicksilver) — 어디에나 동시에 존재함.
sentinel	opus	보안 검토자. CWE Top 25, 비밀 정보, 인젝션(injection) 확인. 읽기 전용.	파수꾼. 결코 잠들지 않음.
titanium	sonnet	컨텍스트 복구. 이전 세션으로부터 상태를 재구축.

모델 계층화(Model tiering)는 의도적입니다. Opus는 오케스트레이션(orchestration)과 판단을 담당합니다. Sonnet은 조사와 분석을 담당합니다. Haiku는 grep을 담당합니다. 당신은 검색이 아니라 사고(thinking)에 비용을 지불합니다.

런타임 없는 순수 설정(Pure config, no runtime). 플러그인 시스템, 데몬(daemon), 백그라운드 프로세스가 없습니다. 오직 마크다운 에이전트 정의, 셸 훅(shell hooks), 그리고 settings.json만 존재합니다. bash를 읽을 수 있다면, 모든 라인을 감사(audit)할 수 있습니다.

의도적인 모델 계층화(Deliberate model tiering). 오케스트레이션과 판단을 위한 Opus. 조사와 구현을 위한 Sonnet. grep을 위한 Haiku. 당신은 검색이 아니라 사고에 비용을 지불합니다.

다양한 설치 모드(Multiple install modes). activate.sh / deactivate.sh를 통한 전역 토글, 프로젝트별 드롭인(drop-in), 플러그인 스타일, 또는 전역 명령 — 당신의 워크플로에 맞는 방식을 선택하세요.

완전한 가역성(Fully reversible). /unalloy는 이전의 Claude Code 설정을 정확하게 복구합니다. 종속성(lock-in)이나 잔여물이 남지 않습니다.

선형 파이프라인이 아닌 적응형 라우팅(Adaptive routing, not a linear pipeline). Steel은 모든 작업을 고정된 순서로 강제하거나 명확한 목적 없이 에이전트를 생성하는 대신, 작업에 필요한 요구사항(FAST, RESEARCH, PLAN, BUILD, SECURITY 등)에 따라 경로를 지정합니다.

Claude Code — Anthropic의 CLI 에이전트 (npm install -g @anthropic-ai/claude-code)

Claude Pro/Max 구독 또는 Anthropic API 키 — 멀티 에이전트 워크로드에는 Max를 권장합니다.

bash (4.0+), jq, git

토큰 사용량: claude-alloy는 오케스트레이션에는 Opus를, 구현에는 Sonnet을, 검색에는 Haiku를 라우팅합니다. 따라서 당신은 검색이 아니라 사고에 비용을 지불합니다. 멀티 에이전트 작업(특히 `ig

에는 단일 에이전트 Claude Code보다 더 많은 토큰을 사용합니다. 더 높은 Rate Limit (속도 제한)를 제공하는 Claude Max를 5배/20배 사용하실 것을 강력히 권장합니다. API 사용자의 경우 복잡한 작업 시 일반적인 토큰 사용량의 약 2-3배를 예상할 수 있습니다.

일회성 Alias (별칭) 설정:

git clone https://github.com/OMARVII/claude-alloy.git
cd claude-alloy
bash setup-aliases.sh
...

그 다음, 어디에서든:

alloy # 전역적으로 14개의 에이전트 활성화
unalloy # 순정 Claude 상태로 복귀

그 후 Claude 내부에서, 최대 노력 모드(maximum effort mode)를 위해 ** ig** (또는 /ignite)를 입력하세요 — 모든 에이전트가 병렬로 작동하며, 어떠한 작업도 미완성 상태로 제출되지 않습니다.

상태: 플러그인 메타데이터는 포함되어 있으나, 완전한 Hook (훅)/설정 경험을 위해서는 Global Toggle (전역 토글) 또는 프로젝트별 설치를 권장합니다. Claude Code 플러그인 범위의 에이전트는 ~/.claude 또는 프로젝트의 .claude/ 디렉토리에 설치된 파일보다 더 엄격한 제한이 적용됩니다.

# 로컬 플러그인 테스트 (먼저 클론하세요)
claude --plugin-dir /path/to/claude-alloy

# 특정 프로젝트에만 설치
bash install.sh --project /path/to/project
# 또는 전역 /alloy-init 명령어를 설정한 후, 모든 프로젝트에서 사용하세요
...

설치 후, 서브 에이전트(subagents)를 위한 MCP Schema Pinning (MCP 스키마 고정)을 활성화하려면 docs/mcp-config.md를 참조하세요 (cp .mcp.json.example .mcp.json).

.claude/
├── agents/ 14개 에이전트 (steel, tungsten, quartz, mercury, graphene, carbon, prism, gauge, spectrum, sentinel, titanium, iridium, cobalt, flint)
├── skills/ 10개 스킬 (git-master, frontend-ui-ux, dev-browser, code-review, review-work, ai-slop-remover, tdd-workflow, verification-loop, pipeline, hyperplan)
...

Hook	시점	기능
write-guard	쓰기 전 (Before Write)	기존 파일의 덮어쓰기를 차단 — 대신 Edit 사용 권장
branch-guard	쓰기/수정 전 (Before Write/Edit)	main/master 브랜치에서의 수정을 차단; 문서는 허용(경고), `ALLOY_BRANCH_GUARD=off
comment-checker	쓰기/수정 후 (After Write/Edit)	AI slop(AI가 생성한 무의미한 텍스트) 주석에 대해 경고
edit-ledger	쓰기/수정/MultiEdit/NotebookEdit 후 (After Write/Edit/MultiEdit/NotebookEdit)	IGNITE 리뷰 강제 적용을 위해 구현 수정 사항을 기록
typecheck	.ts/.tsx 수정 후 (After .ts/.tsx edits)	`tsc --noEmit`을 실행하고 에러를 보고
auto-install	package.json/requirements.txt/pyproject.toml 변경 후 (After package.json/requirements.txt/pyproject.toml)	의존성(dependencies) 설치 (안전을 위해 lifecycle scripts는 비활성화)
agent-reminder	5회의 직접 검색 후 (After 5 direct searches)	조사가 광범위해질 경우 mercury/graphene 사용을 제안
agent-count	Agent/Task 배정 후 (After Agent/Task dispatch)	IGNITE 강제 적용을 위해 생성된 Agent를 기록
lint	쓰기/수정 후 (After Write/Edit)	ESLint/Biome/Prettier를 실행하고 에러를 보고
skill-reminder	12회의 직접 도구 호출 후 (After 12 direct tool calls)	작업이 확장된 경우 관련 skill(기술) 또는 agent를 제안
todo-enforcer	중단 전 (Before stopping)	완료되지 않은 todo(할 일)에 대해 상기 (한 번 차단 후 허용)
loop-stop	중단 전 (Before stopping)	`/loop`가 활성화되어 있으면 작업을 계속 수행
session-notify	중단 시 (On stop)	세션 종료 시 데스크톱 알림 전송
pre-compact	압축 전 (Before compaction)	메모리 압축(memory compaction) 전 중요한 컨텍스트를 저장
subagent-start	Subagent 시작 시 (On subagent start)	Agent 활동 및 위임(delegation)을 추적
subagent-stop	Subagent 중단 시 (On subagent stop)	Agent의 산출물(deliverables) 및 결과를 검증
rate-limit-resume	중단 실패 시 (On stop failure)	Rate limit(속도 제한) 발생 시 자동 재개 (최대 3회)
session-start	세션 시작 시 (On session start)	세션에 wiki 컨텍스트를 주입
session-end	세션 종료 시 (On session end)	세션이 생산적이었을 경우 wiki 업데이트를 독려
ignite-detector	사용자 프롬프트 시 (On user prompt)	`ig` / `ignite` 키워드를 감지하여 IGNITE 세션 플래그 설정
ignite-stop-gate	중단 전 (Before stopping)	IGNITE 프로토콜(6명 이상의 agent, graphene, 리뷰)이 준수되지 않은 경우 종료를 차단
context-pressure

명령어	기능
`ig` (또는 그냥 `/ignite`)	최대 노력 모드. 6명 이상의 에이전트(agent)가 병렬로 가동되며, 할 일(todos)을 집요하게 추적하고, 완료 전 수동 QA를 수행합니다. 이 시스템의 시그니처 동작입니다.
`/loop`	자율 루프 — 작업이 100% 완료될 때까지 에이전트가 작동합니다 (`/loop`와 Claude Code의 네이티브 `/goal`의 차이점은 commands/loop.md 참조)
`/halt`	루프 중단
`/alloy`	모든 에이전트, 기술(skills), 명령어, 훅(hooks) 표시
`/unalloy`	현재 프로젝트에서 claude-alloy 제거
`/handoff`	세션 지속을 위한 컨텍스트 요약 생성
`/refactor`	LSP 진단(diagnostics)을 활용한 안전한 리팩터링
`/init-deep`	계층적 CLAUDE.md 파일 생성
`/start-work`	carbon으로부터 계획 실행
`/status`	루프 상태, 대기 중인 할 일, 브랜치, 최근 활동 표시
`/wiki-update`	세션 학습 내용을 바탕으로 프로젝트 위키 업데이트
`/notify-setup`	데스크톱, Slack, Discord 알림 설정
`/learn`	현재 세션에서 재사용 가능한 패턴을 추출하여 기술(skills)로 저장
`/assess`	프로젝트 상태 스캔 — Claude Code의 성숙도를 0–10으로 평가하고 다음 단계 제안

Steel은 고정된 파이프라인을 따르지 않습니다. 적응형으로 경로를 지정합니다:

┌─ FAST: 직접 처리
│
사용자 → steel ──├─ RESEARCH: mercury ×N + graphene ×N (병렬)
...

차별점: prism은 인라인(inline)으로 실행되며(별도의 단계가 아님), gauge는 선택 사항입니다(필수 게이트가 아님). 또한 모든 빌드 후에는 변경 사항에 따라 일치하는 리뷰어 — sentinel (보안), iridium (성능), cobalt (의존성), flint (테스트) — 를 호출하는 리뷰 게이트가 작동합니다. quartz는 파이프라인에 포함되지 않습니다 (정체되었을 때만 사용). 고정된 순서도 없고 이유 없는 에이전트 생성도 없습니다 — steel은 작업별로 적응합니다.

기본 모드는 정밀 라우팅(precision-routed) 모드입니다. 불확실성, 리스크 또는 규모로 인해 가치가 생길 때 에이전트가 가동됩니다. ig는 완전한 병렬 처리를 위해 명시적으로 선택(opt-in)하는 모드입니다.

ig (또는 /ignite)를 입력하여 최대 출력(maximum effort) 모드를 실행하세요: 6개 이상의 에이전트가 병렬로 가동되며, 할 일(todos)을 집요하게 추적하고, 모든 완료 주장(completion claim) 전에 수동 QA를 수행합니다. 단 두 글자만으로 전체 팀이 투입됩니다.

방법	명령어	대상
전역 토글 (Global toggle)	`alloy` / `unalloy`	대부분의 사용자 — 즉각적이며 되돌릴 수 있음
플러그인 (Plugin)	`claude plugin add claude-alloy`	마켓플레이스 사용자 (메타데이터 포함; 전체 훅(hook) 설치 권장)
프로젝트별 (Per-project)	`bash install.sh --project .`	팀 단위 — 버전 관리(version control)를 준수하는 경우
전역 명령어 (Global command)	`bash setup-global.sh` 실행 후 `/alloy-init`	프로젝트당 하나의 명령어
휘발성 (Ephemeral)	`claude --plugin-url <release-zip-url>`	단일 세션 동안 릴리스를 테스트 — 디스크에 아무것도 기록되지 않음

alloy는 기존 Claude 설정과 병합됩니다. 사용자의 커스텀 권한, 모델 선호도 및 플러그인이 그대로 유지됩니다. unalloy를 입력하면 설정이 정확히 복구됩니다.

디스크에 아무것도 기록하지 않고 단일 세션 동안에만 claude-alloy를 로드하려면 --plugin-url 플래그와 함께 claude를 실행하세요:

claude --plugin-url https://github.com/OMARVII/claude-alloy/releases/download/v1.7.1/claude-alloy.zip

플러그인은 압축이 해제되어 세션 동안 사용된 후 종료 시 폐기됩니다. 이는 릴리스 후보(release candidate)를 테스트하거나, 전체 설치를 결정하지 않고 일회성 작업에 alloy를 시도해 볼 때 유용합니다. --plugin-url 플래그에 대한 문서는 https://code.claude.com/docs/en/cli-reference 에서 확인할 수 있습니다.

제거 대상	명령어
비활성화 (파일은 유지)	`unalloy`
...

요약(TL;DR)—cd /path/to/claude-alloy && git pull을 실행하세요. 전역 심볼릭 링크(symlink) 설치는 즉시 업데이트됩니다. 복사 모드(Copy-mode) 및 프로젝트별 설치는 한 단계를 더 거쳐야 합니다: alloy 또는 bash install.sh --project .를 다시 실행하세요.

전역 설치(alloy)는 macOS 및 Linux에서 기본적으로 **심볼릭 링크 (symlinks)**를 사용합니다. 이는 claude-alloy 저장소에서 git pull을 실행하면 모든 에이전트, 스킬, 명령어 및 훅(hooks)이 즉시 업데이트됨을 의미하며, 재활성화가 필요하지 않습니다.

cd /path/to/claude-alloy
git pull # 심볼릭 링크 모드: 변경 사항이 즉시 적용됩니다

명시적인 제어를 선호하는 경우:

alloy --update # 최신 버전 pull + 한 번에 재활성화 (re-activate)
alloy --check # 상태 점검 (health checks, alloy doctor) 실행
alloy --version # 설치된 버전 표시

활성화 시 자동 업데이트 (auto-update)를 비활성화하려면:

export ALLOY_AUTO_UPDATE=0 # 환경 변수 (세션별 적용)
touch ~/.claude/.alloy-no-update # 영구적인 옵트아웃 (opt-out)

심볼릭 링크 (symlinks)를 지원하지 않는 WSL/Windows 또는 파일 시스템의 경우, alloy는 자동으로 **복사 모드 (copy mode)**로 전환됩니다. 복사 모드에서는 git pull을 수행한 후 alloy를 실행하여 업데이트를 적용하세요.

프로젝트별 설치 (Per-project installs)는 항상 복사본을 사용하므로 (심볼릭 링크 아님), 업데이트를 위해서는 설치 프로그램을 다시 실행해야 합니다:

cd /path/to/claude-alloy
git pull
bash install.sh --project /path/to/your/project

프로젝트 설치를 위해 setup-global.sh와 /alloy-init을 사용했다면, 먼저 캐시된 페이로드 (cached payload)를 업데이트하세요:

cd /path/to/claude-alloy
git pull
bash setup-global.sh # ~/.claude/alloy-dist/를 새로고침합니다

그 다음, 업데이트를 적용하기 위해 Claude Code 내의 각 프로젝트 안에서 /alloy-init을 다시 실행하세요.

OMARVII/claude-alloy

요약

핵심 포인트

댓글