Borrowing it
Nothing to install: this file belongs to xzawed/claude-grok-build-plugin. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/xzawed/claude-grok-build-plugin/main/CLAUDE.mdgit clone --depth 1 https://github.com/xzawed/claude-grok-build-pluginWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/xzawed/claude-grok-build-plugin/claude-md)<a href="https://agentmods.dev/instructions/xzawed/claude-grok-build-plugin/claude-md"><img src="https://agentmods.dev/badge/instructions/xzawed/claude-grok-build-plugin/claude-md.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.10381 | $0.10381 |
| Opus 5 | $0.05190 | $0.05190 |
| Sonnet 5 | $0.02076 | $0.02076 |
| Haiku 4.5 | $0.01038 | $0.01038 |
Grade C, and why
claude-grok-build-plugin CLAUDE.md scanned grade C with 3 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Downloads and executes remote codehighSupply chain
curl | sh runs whatever the server returns today, which is not necessarily what it returned when this was reviewed.
curl -fsSL https://x.ai/cli/install.sh | bash # 1. Grok Build CLI 설치 Makes network callslowCapability
Not a fault in itself. Listed so you know the mod talks to something, and to what.
curl -fsSL https://x.ai/cli/install.sh | bash # 1. Grok Build CLI 설치 Runs shell commandslowCapability
Expected in a hook, worth knowing in a rule or an instructions file.
- 서브프로세스 실행은 `spawn` 사용, `exec`/`execSync`로 셸 인젝션 위험 있는 문자열 How it starts
The opening of the file, as written. The whole thing — 417 lines — stays where its author put it; the contents beside it link to each section on GitHub.
CLAUDE.md — claude-grok-build-plugin
이 파일은 Claude Code가 이 프로젝트에서 세션을 시작할 때 자동으로 읽는 컨텍스트 파일입니다.
사람이 읽는 개요는 README.md(영문 기본) 또는 README.ko.md(한글), 상세 설계는
docs/를 참조하세요.
⚠️ 이 CLAUDE.md는 이 저장소에서 개발할 때만 로드된다. 플러그인이 설치된 엔드유저에게는 플러그인 루트의 CLAUDE.md가 컨텍스트로 전달되지 않는다 (플러그인은 skill/agent/hook으로 컨텍스트를 제공). 따라서 절대 원칙(예: API 키 env 정제)이 엔드유저 런타임에 강제돼야 한다면 반드시 코드/hook에 구현해야 하며, 이 문서에만 적어두면 안 된다.
프로젝트 한 줄 요약
Claude Code 플러그인. Claude가 코딩 작업 중 일부를 xAI의 Grok Build CLI에 위임할 수 있게 하는 MCP 서버 래퍼. 과금은 API 종량제가 아니라 사용자의 xAI 구독(SuperGrok / X Premium+)을 사용하는 것을 최우선 제약 조건으로 한다.
제품 본질 (SSOT: docs/00-product-vision.md): 개발자가 Grok을 잘 쓰게 하고, 플러그인으로
Grok의 코딩 실력을 체감하게 하며, Claude(오케스트레이터) ↔ Grok(워커) 협업 경험을 만든다.
다리를 만드는 것만이 아니라 멋진 협업 경험이 목표다.
세션 핸드오프 (Claude·Grok·사람 — 필수)
의미 있는 작업 후에는 다음 세션이 즉시 진행 상황을 알 수 있게 문서를 맞춘다.
| 읽을 곳 | 담는 것 |
|---|---|
이 파일 현재 상태 |
지금 사실·다음 할 일만 (이력 나열 금지, 짧게) |
docs/00-product-vision.md |
왜 / 제품 목표 |
docs/06-roadmap.md |
Phase 완료 체크리스트 |
docs/09-scope-and-residuals.md |
이 레포 범위 완료·잔여 분류·polish 금지 |
docs/10-service-audit-queue.md |
열린 코드 결함 큐 (기능 감사 실측) — 고치면 지운다 |
docs/specs/, docs/plans/ |
결정 근거·구현 서사 |
같은 사실을 여러 문서에 복사하지 않는다 — 원천 하나를 고치고 나머지는 포인터. 전역 규칙과 동일.
현재 상태 (먼저 읽을 것)
- 최신 릴리스
v0.2.23(2026-09-06). 무엇이 왜 나갔는지는docs/releases/와CHANGELOG.md가 원천이다 — 여기 옮겨 적지 말 것(이 줄이 이력으로 자라면 다음 세션이 같은 서사를 매번 다시 읽는다). MCP 9 tools 동일. 계약 SSOT:docs/specs/grok-cli-contract.md— 절마다 유효 버전이 다르다(헤더 버전 하나로 전체를 대표시키지 말 것). 유닛 수치는npm test로 직접 낼 것 — 문서의 숫자는 낡는다. ⚠️ 선언만 하고 태그를 안 끊는 사고는 한 번이 아니다 —0.2.0·0.2.1·0.2.2는 지금도 태그가 없고v0.2.12는 소급 태그뿐이다(git tag --sort=v:refname). 마켓플레이스 소스가./라 그 사이 설치자가 옛 번들을 그 번호로 캐시한다 — 규칙은 아래 캐시 항목, 경위는docs/releases/·CHANGELOG.md.release-tag-check(schedule/dispatch)가 감시한다. - ⚠️ grok CLI는 스스로 업데이트된다. 2026-09-02 세션 도중
1.0.5 → 1.0.13자동 갱신이 실측됐다. 계약 스냅샷(값-플래그 목록 등)이 낡는 것을 전제로 설계한다 —grok-cli.ts차단 판정이 목록에 의존하지 않는 이유. 재실측 전 계약 문서의 버전을 "사용자 머신의 버전"으로 읽지 말 것. - 표면: route/
nextAction, status(+billingMismatch), review/resume, first-mile, consumer kit (examples/orchestrator-consumer.md), hook e2e + tool-surface CI. - 유지보수자 표면 (
.claude/, 배포 안 됨):accept-release.mjs(릴리스 수락 — 캐시 번들을 헤드리스로 채점, 쿼터 0,--repo로 설치본 없이도 가능 —docs/09§5a),mcpcall.mjs(단발 tool 호출),repo-scope(다음 할 일 = 기본 없음),maintainer-preflight(done 선언 전 test/typecheck/build + 번들 재빌드). 경계:CONTRIBUTING.md. - 의존성 PR: dist 재빌드는 사람이 아니라 에이전트가 한다. esbuild가 런타임 의존성을
번들에 인라인하므로 lockfile만 바뀌어도
dist/index.js가 바뀔 수 있다 (실측 PR #27·#49fast-uri). 단 패키지마다 다르다 —grep -c "node_modules/<pkg>" dist/index.js로 확인하고, 0이면 재빌드 없이 머지한다 (실측 PR #48ip-address는 번들 밖이라 CI 통과). CI 자동 재빌드는 기각 — 근거는CONTRIBUTING.md"Why this is not automated in CI". - 설치본 갱신은 순서가 있다 — 클론이 먼저다. 마켓플레이스 클론은
autoUpdate: false라 클론이 낡으면claude plugin update가 새 버전을 아예 보지 못한다(2026-09-04 실측). 순서는 아래 "다른 PC…" 블록이 원천이다. 설치본이 무엇인지는claude plugin list가, 레포가 선언한 값은mcp-server/package.json이 말한다 — 여기에 두 숫자를 박아두지 말 것(그렇게 했다가 두 번 낡았고, 그때마다 다음 세션이 이미 끝난 갱신을 할 일로 읽었다). ⚠️ 갱신 후에도 실행 중이던 세션은 옛 프로세스를 물고 있다 — 그 세션의/grok:status는 옛 번호를 말한다. 갱신 실패가 아니라 프로세스가 안 바뀐 것이고, 고치는 법은 Claude Code 재시작뿐이다. 캐시는 버전 키다(~/.claude/plugins/cache/<mk>/<plugin>/<version>/) — 번들이 바뀌면 같은 버전으로 재배포하지 말고 반드시 범프한다. 그 규칙의 실사례가 위v0.2.12다 — 머지 직후 바로 태그를 끊는다. - 다음 할 일 (이 레포): 없음. 감사 세 번이 연 25건이 전부 닫혔다 — 2026-09-05 기능 감사 20건
(FAIL 4건 v0.2.19 · A1
A6 v0.2.20 · A7A20 v0.2.21), 2026-09-06 전체 감사 3건 (A21·A22는 v0.2.22, A23은 발견과 동시에), 같은 날 릴리스+전체 코드 감사 2건(A24·A25는 v0.2.23). 감사마다 질문이 달랐다는 게 요점이다 — 기능이 도는가 → 광고한 계약이 지켜지는가 → 광고하지 않은 경로로도 계약이 지켜지는가. 마지막 질문이 잡은 게 A24다(값을 붙여 쓴-p가 인증 게이트와 이력 양쪽에서 동시에 사라졌다).docs/10-service-audit-queue.md의 A 섹션은 비어 있고 그 문서는 지우지 않는다: 재현 하네스와 B(측정 불가)·C(손대지 말 것)가 다음 감사에 필요하다. 새 결함은 거기 A 섹션에 적는다 (번호는 재사용하지 않는다 — A25까지 썼으므로 다음은 A26이다). 범위 밖(외부/수동/보류)은docs/09이고, 기각·반증된 항목을 다시 제기하기 전에는docs/09·docs/releases/의 근거부터 읽을 것. - 사람이 해야 할 미해결: 없음.
v0.2.23수락은 완결됐다. 머지 직후 태그·릴리스 → 클론·설치본 갱신 → 캐시 번들accept-release.mjs10/10 → 실제 Grok 위임(billing: subscription· 커밋 없음) → **갱신 뒤 새 세션의grok_build_status가serverVersion: 0.2.23**까지 확인했다. 실행 기록은docs/09§5. ⚠️ 다음 릴리스도 마지막 한 칸은 다음 세션 몫이다 — 세션은 자기가 시작할 때의 MCP 프로세스를 물고 있어서, 갱신을 수행한 세션은 갱신 뒤에도 옛 번호를 말한다(v0.2.23에서0.2.22↔0.2.23양방향 실측). 갱신 뒤 새로 시작된 세션이grok_build_status(=/grok:status의 구동부,commands/status.md)를 한 번 부르면 그것이 증거다 — 사람을 기다릴 필요는 없다.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- yesterday Changed · +103 lines · +2,541 tokens per session 745b335910dc
- 2d ago Changed · +9 lines · +304 tokens per session 72d29afaa632
- 3d ago Changed · +44 lines · +1,504 tokens per session 4f3ba0bbb6a8
- 7d ago First seen · 261 lines · 6,032 tokens per session scan C 8ae95699752b
claude-grok-build-plugin CLAUDE.md is an instructions file published in the GitHub repository xzawed/claude-grok-build-plugin (1 stars, last pushed yesterday), licensed MIT. It adds 10,381 tokens to every session, about $0.0519 per session on Opus 5. A static security scan graded it C with 3 findings (downloads and executes remote code, makes network calls, runs shell commands). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other instructions, from other repositories
next.js AGENTS.md
AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.
codex AGENTS.md
AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.
vscode buildNext.instructions.md
Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).
vscode oss-third-party-notices.instructions.md
Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, applying the notice (cutover) and fallback chain (never fail the build).
langchain AGENTS.md
AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.
spec-kit AGENTS.md
AGENTS.md instructions for github/spec-kit, covering agents.md, about spec kit and specify, quickstart — add a new integration in 5 steps, integration architecture and integrationmanifest — file tracking.