rpgdev: Instructions file for Claude Code

CLAUDE.md

rpgdev CLAUDE.md is an instructions file for Claude Code from kitepon/rpgdev. It costs 12,634 tokens per session, scanned B, a copy of rpgdev AGENTS.md, MIT.

A set of project instructions for Claude Code, an AI coding assistant, in the RPGDev repository. It documents the desktop app’s design, platform setup, testing rules, and npm release process.

In plain words
What is it for?
Use it when changing RPGDev, especially its RPG-style desktop window, hooks, TODO quests, macOS or Windows integration, WSL2 support, or package publishing.
Why use it?
It gives the coding assistant the repository’s specific rules so changes and checks follow the project’s architecture and supported platforms.

Instructions file for Claude Code

Written for Claude Code: PreToolUse hook event. Also seen: reads .claude/ paths; mentions CLAUDE.md; names the TodoWrite tool.

This is kitepon/rpgdev's own configuration. It tells Claude Code how to work on rpgdev itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything rpgdev configures →

Reuse

Borrowing it

Nothing to install: this file belongs to kitepon/rpgdev. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/kitepon/rpgdev/main/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/kitepon/rpgdev

Made for: Claude Code.

Wrote 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.

agentmods badge for rpgdev CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/kitepon/rpgdev/claude-md.svg)](https://agentmods.dev/instructions/kitepon/rpgdev/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/kitepon/rpgdev/claude-md"><img src="https://agentmods.dev/badge/instructions/kitepon/rpgdev/claude-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 12,634 This file is loaded in full into every session.
When invoked 12,634 The same file — it is already loaded in full.
Security scan B 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin 98% copy Near-identical to another mod in the catalogue.
Token cost

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.

ModelPer sessionOnce invoked
Fable 5.1 $0.12634 $0.12634
Opus 5 $0.06317 $0.06317
Sonnet 5 $0.02527 $0.02527
Haiku 4.5 $0.01263 $0.01263

Measured 6d ago against content hash 5b7d88b7482e, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade B, and why

rpgdev CLAUDE.md scanned grade B 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 6d 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.

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

`~/.claude/settings.json`(**ユーザー全体の `settings.local.json` は Claude Code に読まれない**=v0.6.0 のバグ。v0.6.1 で修正)。
Origin

This is a copy

98% identical to rpgdev AGENTS.md — 4 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.

CLAUDE.md · 391 lines

How it starts

The opening of the file, as written. The whole thing — 391 lines — stays where its author put it; the contents beside it link to each section on GitHub.

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

概要

RPGDev は Codex / Claude Code の Hook イベントを、小さな RPG 風デスクトップ ウィンドウの演出に変換するツール。モンスターはツール使用ごとに一定確率で出現する ランダムエンカウントで、ツール利用が攻撃になる。撃破条件は出現時に紐づいた TODO の 有無で変わる(攻撃5回/ターン終了で討伐、または紐づき TODO の完了で討伐)。TODO は クエスト一覧として表示しつつ、紐づきエンカウントの討伐トリガーにもなる。 macOS / Windows(WSL2 含む)対応、Node 20+、全体が ESM ("type": "module")。JS のビルド/バンドル工程はなく、TypeScript も使っていない。 デスクトップ窓だけがプラットフォーム依存(macOS=Swift+WKWebView / Windows=C# WinForms+WebView2 / WSL2=Windows ホスト側に interop で同窓を起動 / 素の Linux は窓なし=npm run web)。Windows/WSL2 は サーバ(ハブ)も窓も Windows ホスト上の単一インスタンスに集約=ハブ1つを Windows ローカルのファイルから起動して 0.0.0.0 で待ち受け(窓は localhost 接続、WSL2 フックはホストの WSL アダプタ IP 経由)、Windows でも WSL2 でも同じ1つの 共有冒険を動かす(セットアップ順非依存。要:WSL→ホスト inbound を許可する標準 Defender + Hyper-V の両層の ファイアウォール許可規則=rpgdev setup-firewall が適用。標準は RemoteAddress 172.16/12、Hyper-V は WSL vmCreator の既定 Block の例外)。詳細は docs/02_windows-wsl.md。 文書の入口は docs/00_overview.md。設計正典は docs/01_design-todo-rpg.md

RPGDev 固有の検証ルール

RPGDev は macOS デスクトップアプリ / overlay アプリであり、ブラウザアプリではない。 ユーザーが明示的に依頼しない限り、Browser プラグイン、Playwright、ブラウザ表示確認、 npm run web を検証の主経路にしない。UI確認が必要な場合は npm startnpm run build:desktopnpm run server + RPGDev overlay / デスクトップウィンドウ、 または reducer テストと demo Hook の流れで確認する。/ のフル Web ビューは補助ビューであり、 RPGDev の本体として勝手に扱わない。

コマンド

npm test                              # node:test の全テストを実行
node --test test/adventure-state.test.mjs   # 単一テストファイルを実行
node --test --test-name-pattern "spawns a monster"  # 名前で単一テストを実行

npm run server                        # HTTP サーバのみ起動(ウィンドウなし)
npm run web                           # サーバ起動 + ブラウザでフル Web ビューを開く
npm start                             # ビルド + macOS デスクトップウィンドウを起動
npm run build:desktop                 # Swift ウィンドウのコンパイルのみ(起動しない)
npm run render:bgm                    # BGM 7トラックを再生成(public/audio の BGM wav)
npm run render:sfx                    # 攻撃/帰還/被弾の効果音(SFX)を再生成
npm run demo                          # 起動中のサーバに対して擬似 Hook シーケンスを流す
npm run trace                         # 演出トレースを解析(二連続/欠落/取りこぼしの検出。docs §10)

Read the full file on GitHub · 391 lines

Changes

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.

  1. 6d ago First seen · 391 lines · 12,634 tokens per session scan B 5b7d88b7482e

Subscribe to this mod's changes

rpgdev CLAUDE.md is an instructions file published in the GitHub repository kitepon/rpgdev (1 stars, last pushed 24d ago), licensed MIT. It adds 12,634 tokens to every session, about $0.0632 per session on Opus 5. A static security scan graded it B with 1 finding (reads agent configuration directories). It is 98% identical to rpgdev AGENTS.md, differing in 4 lines, and is treated as a copy.

Related

Other instructions, from other repositories

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.

openai/codex · 5,182 tokens

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).

microsoft/vscode · 6,785 tokens

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.

vercel/next.js · 7,296 tokens

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.

langchain-ai/langchain · 4,469 tokens

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).

microsoft/vscode · 5,001 tokens

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.

github/spec-kit · 7,104 tokens