Borrowing it
Nothing to install: this file belongs to iamjameslennon/ddb-mcp. 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/iamjameslennon/ddb-mcp/main/CLAUDE.mdgit clone --depth 1 https://github.com/iamjameslennon/ddb-mcpWrote 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/iamjameslennon/ddb-mcp/claude-md)<a href="https://agentmods.dev/instructions/iamjameslennon/ddb-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/iamjameslennon/ddb-mcp/claude-md/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/instructions/iamjameslennon/ddb-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/iamjameslennon/ddb-mcp/claude-md.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.05791 | $0.05791 |
| Opus 5.5 | $0.02316 | $0.02316 |
| Sonnet 5.5 | $0.01158 | $0.01158 |
| Haiku 4.5 | $0.00579 | $0.00579 |
Grade A, and why
ddb-mcp CLAUDE.md scanned grade A with 0 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 2d 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.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 176 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.
It holds the commands, invariants and gotchas. The full per-module, per-tool and historical detail lives in docs/claude/. Read the relevant file there before changing that area, and update it when behaviour changes:
| File | Read it before touching |
|---|---|
| docs/claude/architecture.md | Session lifecycle, execution paths, the full key-modules table (Open5e, edition, game config, library join, …) |
| docs/claude/caching.md | Any cache, in-flight dedupe, failure memo, deadline or epoch guard |
| docs/claude/tool-notes.md | A tool's output, params or edition selection; parseCharacterData behaviour (senses, languages, spells, limited use, …) |
| docs/claude/release-and-ops.md | Releasing, LobeHub, CI workflows, the Dockerfile, package pins |
| docs/claude/history.md | Owner decisions and rulings, every work item and carry-over (a)–(az), security finding F-2026-10-20 |
parseCharacterData is split into per-domain modules under src/tools/character/. docs/character-refactor.md has the module boundaries and the live-character snapshot regression flow. Keep that flow when changing parse behaviour. The rules-edition spec is docs/superpowers/specs/2026-10-16-rules-edition-design.md. Where it and these notes differ, the spec wins.
Commands
npm ci # Install dependencies (prefer ci over install — respects the lockfile)
npm run dev # Run in development mode (no build step, uses tsx)
npm run build # Compile TypeScript to dist/
npm run build:watch # Watch mode
npm run lint # ESLint on the whole repo (src/, tests/, scripts/, root configs)
npm run typecheck # Type-check src/, tests/ and scripts/release-history.mjs without emitting
npm test # Run all tests (vitest)
npm run release # Bump version, generate release notes, publish (patch|minor|major)
# accepts --dry-run (mutate files only, no commit/tag/push)
# and --skip-verify (skip the `npm ci && npm test` gate)
npm run lobehub:manifest # Regenerate lhm.plugin.json (needs dist/ — run build first)
npx vitest run tests/character-parser.test.ts # Run a single test file
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.
- 2d ago Changed · +15 lines · +890 tokens per session a56795a1dcec
- 4d ago Changed · +2 lines · +205 tokens per session 85758c682700
- 5d ago Changed · +2 lines · +291 tokens per session d63330c5eefd
- 6d ago Changed · +77 tokens per session 01897fb322e5
- 9d ago Changed · -106 lines · -29,705 tokens per session 6efb543723ea
- 10d ago Changed · +3,026 tokens per session be2b95091416
- 11d ago Changed · +46 lines · +18,475 tokens per session 4da73d029ddf
- 27d ago Changed · -13 lines · +1,614 tokens per session a5f68c2de95c
- 28d ago Changed · +25 lines · +2,311 tokens per session 1240a6bb27ec
- 1mo ago First seen · 205 lines · 8,607 tokens per session scan A 1133ee7b8fb1
ddb-mcp CLAUDE.md is an instructions file published in the GitHub repository iamjameslennon/ddb-mcp (3 stars, last pushed 2d ago), licensed MIT. It adds 5,791 tokens to every session, about $0.0232 per session on Opus 5.5. A static security scan graded it A with 0 findings. It comes from a forked repository.
ddb-mcp CLAUDE.md compared with instructions from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| ddb-mcp CLAUDE.mdiamjameslennon/ddb-mcp | Instructions file | 3 | 2d ago | MIT | A | 5,791 | Claude Code |
| vscode buildNext.instructions.mdmicrosoft/vscode | Instructions file | 195k | today | MIT | A | 9,719 | GitHub Copilot |
| next.js AGENTS.mdvercel/next.js | Instructions file | 144k | today | MIT | A | 7,461 | Codex, OpenCode |
| vscode oss-third-party-notices.instructions.mdmicrosoft/vscode | Instructions file | 195k | today | MIT | A | 5,685 | GitHub Copilot |
| langchain AGENTS.mdlangchain-ai/langchain | Instructions file | 150k | today | MIT | A | 4,680 | Codex, OpenCode |
| vscode copilot-instructions.mdmicrosoft/vscode | Instructions file | 195k | today | MIT | A | 3,086 | GitHub Copilot |
| deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness | Instructions file | 282k | 3d ago | MIT | A | 4,335 | Codex, OpenCode |