pdf-spec-mcp: Instructions file for Claude Code

CLAUDE.md

pdf-spec-mcp CLAUDE.md is an instructions file for Claude Code from shuji-bonji/pdf-spec-mcp. It costs 6,275 tokens per session, scanned A, original, MIT.

Project instructions for developing pdf-spec-mcp, a tool that reads PDF specifications such as the ISO 32000 standard and extracts their requirements.

In plain words
What is it for?
Working on the pdf-spec-mcp project, including reading PDF standards, following its family conventions, and avoiding dependency-installation problems across macOS and Linux.
Why use it?
It records the project rules, known development pitfalls, and required specification checks so contributors make decisions from the source documents.

Instructions file for Claude Code

Written for Claude Code: Claude Code plugin machinery.

This is shuji-bonji/pdf-spec-mcp's own configuration. It tells Claude Code how to work on pdf-spec-mcp 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 pdf-spec-mcp configures →

Reuse

Borrowing it

Nothing to install: this file belongs to shuji-bonji/pdf-spec-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.

Copy the file
curl -O https://raw.githubusercontent.com/shuji-bonji/pdf-spec-mcp/main/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/shuji-bonji/pdf-spec-mcp

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 pdf-spec-mcp CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/shuji-bonji/pdf-spec-mcp/claude-md/github.svg)](https://agentmods.dev/instructions/shuji-bonji/pdf-spec-mcp/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/shuji-bonji/pdf-spec-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/shuji-bonji/pdf-spec-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.

agentmods 80×15 button for pdf-spec-mcp CLAUDE.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/shuji-bonji/pdf-spec-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/shuji-bonji/pdf-spec-mcp/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 6,275 This file is loaded in full into every session.
When invoked 6,275 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found 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.06275 $0.06275
Opus 5 $0.03138 $0.03138
Sonnet 5 $0.01255 $0.01255
Haiku 4.5 $0.00628 $0.00628

Measured yesterday against content hash 149e4b646a1c, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

pdf-spec-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 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.

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.

CLAUDE.md · 267 lines

How it starts

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

pdf-spec-mcp - 開発ガイド

プロジェクト概要

ISO 32000(PDF)等の仕様 PDF を構造的に読む MCP サーバ。PDF family における「仕様は何を要求するか」担当であり、 family 規約 §2.0 により writer / reader / verify の実装判断はここの原文照合を経る。 つまりこのリポジトリの抽出品質が family 全体の設計判断の質を決める

仕様 PDF は著作物のため配布しない。PDF_SPEC_DIR で置き場所を指定する(.gitignore 済み)。

⚠️ サンドボックスから npm install を実行しないこと

node_modules は macOS のホストと Linux サンドボックスで同一実体を共有している。 npm はプラットフォーム別の optionalDependencies を「今の環境に合う物だけ」入れて他を取り除くため、 サンドボックス(linux-x64)で npm install すると ホストの mac 用バイナリが消える

実際に起きた(2026-07-18): サンドボックスでの npm install@biomejs/cli-darwin-arm64 を落とし、 ホストの npm run formatCannot find module '@biomejs/cli-darwin-arm64/biome' で全滅した。 Biome は薄いラッパがプラットフォーム別バイナリを探す構成なので、本体があっても動かない。 同じ形の依存(@rollup/rollup-* / esbuild / @napi-rs/canvas-* / fsevents)すべてに当てはまる。

「どちらか一方の OS でしか動かない」状態になる。 ホストで npm install し直すと今度は サンドボックス側で biomevitest が両方落ちる(vitest は rollup のネイティブバイナリを要求する。 「vitest は純 JS だから動く」は誤り)。サンドボックスで純粋に動くのは tsc だけ。

  • エージェント: npm install / npm ci を実行しない。ホストが install した直後は npm test / biome も動かないので、テストと lint はホスト側で実行してもらう。 依存を変えたいときは package.json を編集し、ホストでの npm install を依頼する。 ただし npm run check:imports は素の node で動くので、import を触ったら必ず実行する (biome の organizeImports 違反はこれで事前に潰せる。ホストに投げて指摘されるのは無駄)
  • ホスト: 壊れた場合は npm install で直る(package-lock.json には全 8 プラットフォームの エントリがあるので lockfile は無傷。CI の npm ci も各 OS で正しく解決する)

落とし穴

1. セクション境界の「帯」(B-S1 → S-5 / 2026-07-18)

セクションのページ範囲は outline から [page, 次セクションの page - 1] として決まる。 最終ページを越えて溢れた分は次セクションの先頭ページの、見出しより上に取り残される。 この帯はどのセクションにも属さない — 自分の範囲外であり、かつ trimToSectionStart が 次セクションの内容から捨てるため、丸ごと消える。ISO 32000-2 では 412 セクションが 内容を落としており、271 が要件文を含んでいた。

getSectionContent が帯を回収する(adoptOrphanedStripextractOrphanedStrip)。 これで get_section / get_requirements / get_tables が一度に直るので、 表専用の境界処理は要らない(B-S1 の collectTrailingTableRows は S-5 で撤去した)。

Read the full file on GitHub · 267 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. yesterday Changed · -5 tokens per session 149e4b646a1c
  2. 12d ago First seen · 267 lines · 6,280 tokens per session scan A e5bac099d89d

Subscribe to this mod's changes

pdf-spec-mcp CLAUDE.md is an instructions file published in the GitHub repository shuji-bonji/pdf-spec-mcp (2 stars, last pushed yesterday), licensed MIT. It adds 6,275 tokens to every session, about $0.0314 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other instructions, from other repositories

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,126 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

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,153 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

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