pair: Instructions file for Codex

AGENTS.md

pair AGENTS.md is an instructions file for Codex, OpenCode from viames/pair. It costs 1,503 tokens per session, scanned A, original, MIT.

A repository guide for coding agents working on Pair Framework v4, a software framework. It explains the required reading order, safe-change workflow, architecture references, and version boundaries.

In plain words
What is it for?
It is for planning and implementing small framework changes, bug fixes, migrations, and documentation updates.
Why use it?
It reduces accidental breaking changes by telling agents how to inspect existing code, tests, APIs, and framework patterns before editing.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md. Also seen: mentions AGENTS.md.

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

Reuse

Borrowing it

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

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

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

Your own site · 80×15
<a href="https://agentmods.dev/instructions/viames/pair/agents-md"><img src="https://agentmods.dev/badge/instructions/viames/pair/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 1,503 This file is loaded in full into every session.
When invoked 1,503 The same file — it is already loaded in full.
Security scan A 1 finding. 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.01503 $0.01503
Opus 5.5 $0.00601 $0.00601
Sonnet 5.5 $0.00301 $0.00301
Haiku 4.5 $0.00150 $0.00150

Measured today against content hash 7f387bec7c54, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

pair AGENTS.md scanned grade A with 1 finding 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 today.

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.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

- Required Composer extensions: `curl`, `intl`, `json`, `mbstring`, `PDO` and
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 — Pair Framework v4

Primary entrypoint for automated agents working on this repository. Read this first, then SKILL.md for the source map and local commands. Do not add agent-specific shim files unless they contain genuinely non-duplicated operational requirements.

The default branch implements and documents Pair v4, the stable line used by the maintainer's applications. The v3 branch is the previous maintenance line; v4 guidance may not apply to it.

Mission

Make small, safe, reviewable changes consistent with existing Pair architecture. Preserve backward compatibility unless explicitly asked otherwise. When guidance conflicts, favor the smallest safe change aligned with existing patterns and the precedence below.

Workflow

Before making any change:

  1. Inspect src/ to understand the namespace layout.
  2. Find the closest component solving a similar problem and read at least one full class in it.
  3. Check for existing utilities before creating helpers or architectural patterns.
  4. Inspect tests/ to understand expected behavior.
  5. Verify public API usage before modifying framework classes.

Then:

  1. Implement the smallest change in the owning component, following nearby code and the conventions below.
  2. Add or update deterministic tests when behavior changes. Never modify tests merely to make a broken implementation pass.
  3. Run relevant checks and verify compatibility, security and performance. If tests are absent, use the closest manual/local validation and report that limit.
  4. Update the owning documentation when commands, configuration or public behavior change; public framework changes require the relevant sibling pair.wiki pages, especially API and .env references.
  5. Review the diff for unrelated files, dependencies and secrets, then report the result using the completion format below.

For an ambiguous or overly broad request, or one risking an architectural or compatibility mistake, ask for clarification before changing code.

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. today First seen · 159 lines · 1,503 tokens per session scan A 7f387bec7c54

Subscribe to this mod's changes

pair AGENTS.md is an instructions file published in the GitHub repository viames/pair (11 stars, last pushed 3d ago), licensed MIT. It adds 1,503 tokens to every session, about $0.0060 per session on Opus 5.5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-11-15.

Related

pair AGENTS.md compared with instructions from other repositories

pair AGENTS.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
pair AGENTS.mdviames/pairInstructions file113d agoMITA1,503Codex, OpenCode
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file144ktodayMITA7,461Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA5,685GitHub Copilot
langchain AGENTS.mdlangchain-ai/langchainInstructions file150ktodayMITA4,680Codex, OpenCode
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA3,086GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harnessInstructions file282k3d agoMITA4,335Codex, OpenCode