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/.windsurfrulesgit 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/rules/byh3071-cpu/vhk/windsurfrules)<a href="https://agentmods.dev/rules/byh3071-cpu/vhk/windsurfrules"><img src="https://agentmods.dev/badge/rules/byh3071-cpu/vhk/windsurfrules/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/rules/byh3071-cpu/vhk/windsurfrules"><img src="https://agentmods.dev/badge/rules/byh3071-cpu/vhk/windsurfrules.svg" alt="Reviewed on agentmods" width="80" 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.01767 | $0.01767 |
| Opus 5.5 | $0.00707 | $0.00707 |
| Sonnet 5.5 | $0.00353 | $0.00353 |
| Haiku 4.5 | $0.00177 | $0.00177 |
Grade A, and why
windsurfrules 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 26d 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
100% identical to cursorrules — 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 — Windsurf 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.
- 26d ago Changed · +28 tokens per session f4668304ca78
- 1mo ago First seen · 80 lines · 1,739 tokens per session scan A 2bcd2ab721cc
windsurfrules is a cursor rule published in the GitHub repository byh3071-cpu/vhk (12 stars, last pushed 6d ago), licensed MIT. It adds 1,767 tokens to every session, about $0.0071 per session on Opus 5.5. A static security scan graded it A with 1 finding (runs shell commands). It is 100% identical to cursorrules, differing in 2 lines, and is treated as a copy.
Other cursor rules, from other repositories
frontend-architecture
Cursor rule "frontend-architecture" from tomasz-tomczyk/crit, covering frontend architecture, two-paradigm page fork, module pattern, shared modules (used by both modes) and code-review modules (used only by code-review mode).
proxy-auth-transport
Every CLI command or browser UI action that calls a crit-web API must work in both modes.
frontend-js
Cursor rule "frontend-js" from tomasz-tomczyk/crit, covering frontend js rules (semantic — eslint handles syntax/style), dom & events, state management, persisted settings (cookies, not localstorage) and error handling.
go
Cursor rule "go" from tomasz-tomczyk/crit, covering go code rules (semantic — linters handle syntax/style), struct & state integrity, code organization, git operations and daemon/server.
frontend-css
Cursor rule "frontend-css" from tomasz-tomczyk/crit, covering css rules, responsive & touch and selectors.
forge-core
Core Forge project conventions — always applied.