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/pachca/openapi/agents-mdgit clone --depth 1 https://github.com/pachca/openapiWhat 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.01221 | $0.01221 |
| Opus 5 | $0.00611 | $0.00611 |
| Sonnet 5 | $0.00244 | $0.00244 |
| Haiku 4.5 | $0.00122 | $0.00122 |
Grade A, and why
openapi 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.
How it starts
The opening of the file, as written. The whole thing — 64 lines — stays where its author put it; the contents beside it link to each section on GitHub.
AGENTS.md
Guidance for AI coding agents working in this repository. (Using the Pachca
API instead of contributing here? See skill.md, /llms.txt, or the
skills/ directory — not this file.)
What this repo is
Monorepo (Turborepo + bun) for the Pachca API platform. TypeSpec is the single source of truth; everything else is generated from it.
| Path | What |
|---|---|
packages/spec |
TypeSpec (typespec.tsp) → openapi.yaml; overlay, workflows.ts, examples |
packages/cli |
oclif CLI @pachca/cli, generated from OpenAPI |
packages/generator |
Multi-language SDK generator |
packages/openapi-parser |
Shared OpenAPI parser |
apps/docs |
Next.js 16 docs site (dev.pachca.com): content/ MDX, lib/, scripts/ generators, public/ generated artifacts |
n8n-nodes-pachca |
n8n community node |
Build & check
npx turbo build # compiles TypeSpec + builds all packages + regenerates generated files
npx turbo check # lint + typecheck + knip + format:check + test — MUST pass before commit (CI runs this)
bun turbo dev # docs dev server (Next.js 16)
Standard loop: edit source → npx turbo build → npx turbo check →
review generated diffs → commit. Branch from origin/main; open a PR
(never push to main).
Do NOT hand-edit generated files — edit the generator
| Generated | Source of truth |
|---|---|
packages/spec/openapi.yaml |
packages/spec/typespec.tsp (then npx turbo build --filter=@pachca/spec --force) |
apps/docs/public/llms*.txt, public/**/*.md, public/skill.md, public/.well-known/**, public/workflows.arazzo.yaml, Postman collection, root SKILL.md + skill.json |
apps/docs/scripts/generate-llms.ts + scripts/skills/ |
packages/cli/src/commands/** (except auth/config), packages/cli/CHANGELOG.md |
packages/cli/scripts/generate-cli.ts; src/data/changelog.json |
| n8n node files | n8n-nodes-pachca generator |
AGENTS.md (this file) |
apps/docs/scripts/skills/generate.ts (generateAgentsMd()) |
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.
- yesterday First seen · 64 lines · 1,221 tokens per session scan A 03d15746eae4
openapi AGENTS.md is an instructions file published in the GitHub repository pachca/openapi (10 stars, last pushed 3d ago), licensed MIT. It adds 1,221 tokens to every session, about $0.0061 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.
Other instructions, from other repositories
gorest AGENTS.md
Instructions for pilinux/gorest, covering agents.md, project overview, build and run commands, build and tidy dependencies.
gorest CLAUDE.md
Instructions for pilinux/gorest, covering claude.md, authoritative references, files to never read or modify, common commands and architecture (the big picture).
ollama CLAUDE.md
Instructions for ollama/ollama: See AGENTS.md for the shared agent instructions for this repository.
azure-sdk-for-go go-code.instructions.md
Instructions for Azure/azure-sdk-for-go: All code should follow the guidelines from the Azure Go SDK Guidelines. This document is a summary of the most important guidelines to follow when contributing to the Azure Go SDK.
gmgn-skills CLAUDE.md
Instructions for GMGNAI/gmgn-skills, covering claude.md, critical rule — read this first, project overview, available skills and quick decision guide.
sceneview AGENTS.md
Instructions for sceneview/sceneview, covering agents.md — conventions for delegated coding agents, your role, git — you do not own it, secrets and hard technical rules.