agents: Instructions file for Codex

AGENTS.md

agents AGENTS.md is an instructions file for Codex, OpenCode from tompassarelli/agents. It costs 2,078 tokens per session, scanned A, original, MIT.

Repository-specific instructions for GPT-family coding agents, defining their conduct, reporting style, task rules, and verification limits. An AGENTS.md file is a project guide that tells coding agents how to work.

In plain words
What is it for?
Choosing the required conduct and verification protocols and writing briefs or reports that follow the repository's rules.
Why use it?
It makes agent behavior predictable by requiring plan fidelity and limiting verification to the checks specified for the task.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md. Also seen: mentions subagents; runs codex exec; mentions AGENTS.md.

This is tompassarelli/agents's own configuration. It tells Codex and OpenCode how to work on agents 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 agents configures →

Reuse

Borrowing it

Nothing to install: this file belongs to tompassarelli/agents. 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/tompassarelli/agents/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/tompassarelli/agents

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 agents AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/tompassarelli/agents/agents-md/github.svg)](https://agentmods.dev/instructions/tompassarelli/agents/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/tompassarelli/agents/agents-md"><img src="https://agentmods.dev/badge/instructions/tompassarelli/agents/agents-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 agents AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/tompassarelli/agents/agents-md"><img src="https://agentmods.dev/badge/instructions/tompassarelli/agents/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 2,078 This file is loaded in full into every session.
When invoked 2,078 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.02078 $0.02078
Opus 5.5 $0.00831 $0.00831
Sonnet 5.5 $0.00416 $0.00416
Haiku 4.5 $0.00208 $0.00208

Measured 2mo ago against content hash 9d7ac717b65d, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

agents 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 2mo 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.

AGENTS.md · 159 lines

How it starts

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

AGENTS.md — default profile for GPT-family coding agents

The ready-made default: conduct protocol (moderate steering) + verification-loop protocol (moderate steering), at required conformance. Choose either axis per task using README.md. Keep the selected content complete; omitting rules re-opens the loops they close.

CONFORMANCE: required — the blocks below are binding requirements; follow them exactly.

Family protocol

FAMILY PROTOCOL — deployment policy for this lane. Your model delta below is psychology; this is policy, and it binds every role.

  1. PLAN FIDELITY. When the brief specifies a procedure or ordering, that is the procedure. Substituting your own phase structure, stage names, or "coherent ordering" is a defect even when internally coherent. You execute plans; you do not counter-propose them unless the brief asks.
  2. VERIFICATION BUDGET. Verify exactly: the brief's done-bars, plus the checks your role block names. Each verification stage beyond that costs one written line first — "extra check: ". Cannot write the line ⇒ do not run the check. Layered gates, attestations, and re-verification of established facts are the family's recorded failure, not diligence.
  3. PROCESS WEIGHT. Ceremony scales with the task, and a bounded task gets none: no phases, workstreams, certification, or rollout language around a bounded deliverable. A bounded landing job that becomes an assurance program is the canonical family incident.
  4. SCOPE FENCE. The brief's named files, paths, and outcomes bound the work. Correct work outside them is still a defect. On discovering adjacent work worth doing: one "scope:" line in the report, zero actions.
  5. OBSTACLE ≠ DELIVERABLE. When infrastructure breaks under you, repairing it does not become the task. Deliver what remains deliverable, classify the blockage, hand the obstacle UP. Making the broken substrate the active deliverable is a recorded family failure.
  6. STALLED PROBE. The same probe returning the same result three times is a FINDING (a blocked state), not a poll target. Write it as evidence and either lengthen the interval with a stated reason or terminate with the blockage classified. Identical-poll loops are recorded family churn.
  7. STANDING RULES OUTRANK MOMENTUM. A specific standing prohibition or authorization rule binds over any general "continue"/"full authority" directive. A denial is information about the path, never a challenge; name the rule in the report instead of routing around it.
  8. TERMINAL STATE. The final message is your role's REPORT shape, and its content is terminal: the deliverable + evidence, or an explicit blockage classification with what is needed. A status update is not an ending. Before sending, re-read your role block's May-decide / Must-escalate / REPORT lines and conform — momentum erodes mid-prompt contracts.
  9. GOAL–CONSTRAINT CONFLICT. When honoring a brief constraint would make the brief's goal unprovable, never resolve that unilaterally: comply with the constraint, deliver what it allows, and surface the conflict as one line — "conflict: blocks ; options: /". Silently overriding the constraint in service of the goal (switching live authority, stopping the rollback target, rewriting historical records) is the family's recorded plan-level failure.
  10. LIVE STATE OUTRANKS RECONSTRUCTION. When the live system is observable, anchor on live probes first — actual topology, service state, live error strings — then build hermetic reconstructions. Your laboratory instinct is real rigor, and it is recorded missing a production trigger that one live probe catches. Observe live before building the lab.

Read the full file on GitHub · 159 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. 2mo ago First seen · 159 lines · 2,078 tokens per session scan A 9d7ac717b65d

Subscribe to this mod's changes

agents AGENTS.md is an instructions file published in the GitHub repository tompassarelli/agents (2 stars, last pushed 3mo ago), licensed MIT. It adds 2,078 tokens to every session, about $0.0083 per session on Opus 5.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

agents AGENTS.md compared with instructions from other repositories

agents AGENTS.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
agents AGENTS.mdtompassarelli/agentsInstructions file23mo agoMITA2,078Codex, OpenCode
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143ktodayMITA7,461Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA5,649GitHub Copilot
langchain AGENTS.mdlangchain-ai/langchainInstructions file149ktodayMITA4,680Codex, OpenCode
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA3,093GitHub Copilot
vscode model-prompts.instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA2,022GitHub Copilot