rust-faf-mcp AGENTS.md

rust-faf-mcp AGENTS.md is an instructions file for Codex, OpenCode from Wolfe-Jam/rust-faf-mcp. It costs 2,170 tokens per session, scanned A, original, MIT.

Repository instructions for rust-faf-mcp, a Rust program that provides ten MCP tools for reading and managing FAF files. FAF is a structured format for storing context used by AI systems.

In plain words
What is it for?
Use it when building, testing, formatting, linting, or changing the Rust MCP server and its FAF tools.
Why use it?
It records the supported Rust version, build and test commands, project layout, and the requirement that the full test suite passes.

Instructions file for CodexOpenCode

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/wolfe-jam/rust-faf-mcp/agents-md
Clone the repo
git clone --depth 1 https://github.com/Wolfe-Jam/rust-faf-mcp

Made for: Codex, OpenCode.

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 rust-faf-mcp AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/wolfe-jam/rust-faf-mcp/agents-md.svg)](https://agentmods.dev/instructions/wolfe-jam/rust-faf-mcp/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/wolfe-jam/rust-faf-mcp/agents-md"><img src="https://agentmods.dev/badge/instructions/wolfe-jam/rust-faf-mcp/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 2,170 This file is loaded in full into every session.
When invoked 2,170 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
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 $0.02170 $0.02170
Opus 5 $0.01085 $0.01085
Sonnet 5 $0.00434 $0.00434
Haiku 4.5 $0.00217 $0.00217

Measured yesterday against content hash 225b216a7f8c, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

rust-faf-mcp AGENTS.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.

AGENTS.md · 185 lines

How it starts

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

AGENTS.md — rust-faf-mcp

This repository is the example of BEST on the FAF side of the ladder — not a slogan.

NONE → GOOD → BETTER → BEST

  • BETTER is protocol honesty (mcp-better main / mcp-better-better). No project.faf required.
  • BEST print slice (mcp-better better-best/* / mcp-better-best) is the same software plus project.faf. Falsifiable diff. That is the definition.
  • This crate is BEST on main: Trophy project.faf and this AGENTS.md. FAF defines. This file instructs. Sealed BLOCK from the DNA; working brief outside the markers. It is also a FAF MCP server, in Rust, one.faf/rust-faf-mcp — a crate people actually watch.

Do not collapse BETTER into BEST. Do not treat this markdown as the score. The score is project.faf (Mk4 100% ✪).

Read project.faf first. Do not edit the BLOCK. Refresh it with faf_agents. Everything below the BLOCK is how we work in this tree.

AGENTS.md — rust-faf-mcp

Rust MCP server for FAF (Foundational AI-context Format) — IANA-registered application/vnd.faf+yaml — Rust · v0.7.1

Authored by faf — do not edit the managed block; refresh with faf export --agents. Hand content outside <!-- faf:start --><!-- faf:end --> is preserved.

Setup & build

cargo build    # build
cargo fmt --check    # fmt
cargo publish    # publish

Run the tests

cargo test
cargo clippy -- -D warnings

Where things live

  • Cargo.toml
  • src/main.rs
  • src/server.rs
  • src/tools.rs
  • README.md
  • LICENSE

Guardrails

  • Always OK: read the tree · run the tests (cargo test) · build the project · cargo clippy -- -D warnings.
  • Ask first: dependency installs, deletions, migrations, schema changes, publish/release.
  • Never: force-push · push straight to main (branch and open a PR) · commit secrets.

Read the full file on GitHub · 185 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 · +53 lines · -30 tokens per session 225b216a7f8c
  2. 5d ago First seen · 132 lines · 2,200 tokens per session scan A e8822fafa1aa

Subscribe to this mod's changes

rust-faf-mcp AGENTS.md is an instructions file published in the GitHub repository Wolfe-Jam/rust-faf-mcp (4 stars, last pushed 2d ago), licensed MIT. It adds 2,170 tokens to every session, about $0.0109 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.