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.
npx agentmods add instructions/hendryavila/hoofy/agents-mdgit clone --depth 1 https://github.com/HendryAvila/HoofyWrote 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/hendryavila/hoofy/agents-md)<a href="https://agentmods.dev/instructions/hendryavila/hoofy/agents-md"><img src="https://agentmods.dev/badge/instructions/hendryavila/hoofy/agents-md.svg" alt="Measured on agentmods" 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 | $0.02790 | $0.02790 |
| Opus 5 | $0.01395 | $0.01395 |
| Sonnet 5 | $0.00558 | $0.00558 |
| Haiku 4.5 | $0.00279 | $0.00279 |
Grade A, and why
Hoofy 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 4d 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 — 202 lines — stays where its author put it; the contents beside it link to each section on GitHub.
AGENTS.md — Hoofy Development Guide
Project Overview
Hoofy is an AI development companion — an MCP server written in Go 1.25 that provides persistent memory, adaptive change management, and spec-driven development. It prevents AI hallucinations by forcing structured requirements before coding, remembers context across sessions, and adapts its workflow to the size and type of each change.
Binary: hoofy (CLI with serve, update, version commands)
Transport: stdio (MCP protocol)
Dependency: mcp-go v0.44.0 (Mark3Labs MCP SDK)
Architecture
Directory Structure
cmd/hoofy/ Entry point — CLI argument parsing, server startup, graceful shutdown
internal/
├── changes/ Change pipeline — types, flows, store, state machine
├── config/ Project config persistence (hoofy.json) — types, Store interface, FileStore
├── memory/ Persistent memory — SQLite store, FTS5 search, sessions, observations
├── memtools/ MCP memory tool handlers — 19 tools for save, search, context, sessions, relations, progress
├── pipeline/ Pipeline state machine — stage transitions, Clarity Gate thresholds
├── prompts/ MCP prompts — /sdd-start, /sdd-status, /sdd-stage-guide, /sdd-memory-guide, /sdd-change-guide, /sdd-bootstrap-guide
├── resources/ MCP resources — project status resource
├── server/ Composition root — wires all dependencies, registers tools/prompts/resources
├── templates/ Go templates for stage artifacts (guided + expert mode variants)
├── tools/ MCP tool handlers — one file per tool (init, principles, charter, specify, clarify, design, tasks, validate, context, change, adr, audit, bridge, suggest_context, review)
└── updater/ Self-update system — GitHub releases API, binary replacement
Design Principles
- SRP: One file = one tool. Config handles persistence, pipeline handles business rules.
- DIP: Tools depend on interfaces (
config.Store, template renderer), not concretions.server.gois the composition root that wires everything. - OCP: New tools/stages are added without modifying existing ones.
- Liskov: Both modes (guided/expert) use the same pipeline interface, differing only in thresholds and templates.
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.
- 4d ago First seen · 202 lines · 2,790 tokens per session scan A 0a5b6d6229a3
Hoofy AGENTS.md is an instructions file published in the GitHub repository HendryAvila/Hoofy (15 stars, last pushed 5mo ago), licensed MIT. It adds 2,790 tokens to every session, about $0.0140 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-30.
Other instructions, from other repositories
graymatter AGENTS.md
AGENTS.md instructions for angelnicolasc/graymatter, covering agents.md, your tools, when to call which, first call and identity.
graymatter CLAUDE.md
Claude Code instructions for angelnicolasc/graymatter, covering claude.md, a user asked you to set graymatter up, you are working in a project that already uses graymatter and you are contributing to graymatter itself.
gridctl AGENTS.md
AGENTS.md instructions for gridctl/gridctl, covering agents.md, what gridctl is, build and run, code architecture and constitution.
gopls-mcp CLAUDE.md
Instructions for xieyuschen/gopls-mcp, a project described as: MCP server for golang projects development: Expand AI Code Agent ability boundary to have a semantic understanding and determinisic information for golang projects.
symbolpeek-mcp CLAUDE.md
Instructions for pioner92/symbolpeek-mcp: SymbolPeek's whole value is context economy: an agent gets one symbol, not the file. The rule applies to the code too — including this file, which loads into every session, so hold it to its own bar.
go-job CLAUDE.md
Claude Code instructions for anatolykoptev/go-job, a project described as: Job, Remote & Freelance Search MCP server.