Borrowing it
Nothing to install: this file belongs to byh3071-cpu/vhk. 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/byh3071-cpu/vhk/main/GEMINI.mdgit clone --depth 1 https://github.com/byh3071-cpu/vhkWrote 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/byh3071-cpu/vhk/gemini-md)<a href="https://agentmods.dev/instructions/byh3071-cpu/vhk/gemini-md"><img src="https://agentmods.dev/badge/instructions/byh3071-cpu/vhk/gemini-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.01739 | $0.01739 |
| Opus 5 | $0.00870 | $0.00870 |
| Sonnet 5 | $0.00348 | $0.00348 |
| Haiku 4.5 | $0.00174 | $0.00174 |
Grade A, and why
vhk GEMINI.md scanned grade A with 1 finding 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 7d ago.
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.
Runs shell commandslowCapability
Expected in a hook, worth knowing in a rule or an instructions file.
- `execSync` 신규 사용 금지 → `safeExecFile` 사용 <!-- vhk:check=no-exec-sync --> This is a copy
98% identical to vhk copilot-instructions.md — 2 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.
How it starts
The opening of the file, as written. The whole thing — 80 lines — stays where its author put it; the contents beside it link to each section on GitHub.
vhk — Gemini CLI Rules
코딩/디자인 전용. 기록/운영 → CLAUDE.md 참조. ⚡ 이 파일은 RULES.md에서 자동 생성됨 (vhk sync). 직접 수정 금지.
필수 참조
- docs/PRD.md · docs/ARCHITECTURE.md · CLAUDE.md · RULES.md
세션 시작 필독
이 절은 진입점이다. 어떤 도구로 세션을 열든 여기부터 읽는다 (ADR-010 §3).
- 현 사이클 원본: docs/roadmap/2.x-roadmap.md — 작업 단위·순서·릴리스 종료 조건 전량. 작업 시작 전 여기부터 읽는다.
- 수용 기준: docs/PRD-2.x.md
- 실행 단위인
goals/*.md카드와scripts/check-goal-<번호>.mjs는 위 원본에서 파생된 비추적 산출물이다. Goal 카드가 있으면 그 frontmatter가 로컬 실행 상태를 보존한다. 소실되면 정의·완료 조건은 원본에서 재생성하고vhk goal sync로 검사 스크립트를 백필한다. 단, 과거 로컬 진행 상태는 복구된 것으로 추측하지 않고 unknown으로 돌아간다. .vhk/context.md와docs/state/next-task.md는 현재 상태를 보기 쉽게 모은 파생 스냅샷이다. 작업 정의나 완료 조건의 원본으로 사용하지 않는다.docs/state/blockers.md는 로컬 차단 기록이다. append-only로 다루되 제품 작업 정의의 원본으로 승격하지 않는다.
기술 스택
변경 시 ADR(docs/adr/) 필수.
- Node.js + TypeScript (strict)
- commander (CLI) + inquirer (인터랙티브) + chalk (출력)
- tsup (빌드) + vitest (테스트)
- @modelcontextprotocol/sdk + zod (MCP)
- pnpm (패키지 매니저)
- src/i18n/ko.ts (한국어 i18n)
- src/lib/nlp-router.ts (자연어 라우팅)
코딩 규칙
- TypeScript strict (any 금지)
- try-catch 필수, 빈 catch 금지
- console.log 프로덕션 제거
- 실행 위치가 바뀌어도 같아야 하는 로컬 전용 경로는 저장 전에 절대경로로 바꾼다. 공개 파일에는 로컬 절대경로를 기록하지 않는다.
- 사람에게 보여주는 날짜는 로컬 날짜를, 기계가 읽는 정확한 시각은 UTC ISO 형식을 쓴다.
- 질문이 필요한 명령은 시작할 때 TTY를 확인한다. 입력할 수 없거나 입력이 끝나면 실행 방법을 안내하고 실패로 끝낸다.
- 셸 명령의 따옴표와 여러 줄 문법은 실제 실행 셸에 맞춘다. Bash와 PowerShell 문법을 섞지 않는다.
- 외부 입력이나 시각으로 파일·폴더명을 만들 때는 공통 헬퍼로 운영체제 금지문자를 바꾸고, 빈 이름과 중복을 확인한다.
execSync신규 사용 금지 →safeExecFile사용fs.rmSync신규 사용 금지 →removeFileSync·removeDirSync사용 (비ASCII 경로에서 프로세스 즉사·조용한 삭제 누락, TS-005). src 는 0건, tests 는scripts/rmsync-baseline.json잔존분만 허용하며 늘리면 차단- 모든 커맨드 파일에
printNextStep()패턴 사용 - 한국어 별칭
.alias()+ko.ts메시지 필수 - 신규 커맨드 시
nlp-router.ts키워드 추가 필수 - 주석: 복잡 로직(git porcelain·drift·sync 등)은 why 블록주석 / 자명한 코드엔 주석 금지 / JSDoc 지양(타입이 말함) / 트러블 우회 코드는 원인
#이슈참조 - 신규 명령 체크리스트: 등록 4지점(index.ts + command-registry TOP_LEVEL·CONTAINER·한글별칭 + cli-args + ko.ts) 누락 = NL 라우터 가드 무력 — 영문·한글 별칭 둘 다 테스트. + COMMANDS.md·README 사용법 갱신
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.
- 7d ago First seen · 80 lines · 1,739 tokens per session scan A 59fe9aa3db4a
vhk GEMINI.md is an instructions file published in the GitHub repository byh3071-cpu/vhk (12 stars, last pushed 3d ago), licensed MIT. It adds 1,739 tokens to every session, about $0.0087 per session on Opus 5. A static security scan graded it A with 1 finding (runs shell commands). It is 98% identical to vhk copilot-instructions.md, differing in 2 lines, and is treated as a copy.
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.