predicate: Instructions file for Codex

AGENTS.md

predicate AGENTS.md is an instructions file for Codex, OpenCode from nrdxp/predicate. It costs 2,081 tokens per session, scanned A, original, MIT.

Repository instructions for Predicate, a framework that helps coding agents stay focused on their goals over long tasks. They describe its purpose, requirements, and correctness rules.

In plain words
What is it for?
Use them when working on Predicate’s skills, rules, ambient guidance, conditioning system, or orientation workflow.
Why use it?
They give agents durable guidance about the project and define how results should be checked, reducing drift during extended work.

Instructions file for CodexOpenCode

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

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

Reuse

Borrowing it

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

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

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

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

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

Security

Grade A, and why

predicate 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 · 162 lines

How it starts

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

AGENTS.md — Predicate

This repository is Predicate, the upstream. skills/, rules.md, and ambient.md live at the root because other projects consume them as an installed plugin — see README.md and docs/getting-started.md.

Goal

Predicate is a self-hosting, harness-agnostic framework that keeps AI coding agents anchored to the true goal across long-horizon work. It has two synergistic halves:

  • Correction — externalize correctness to the strongest evaluator (the Verification Dual: verify, then trust — no condition closed by an agent's say-so). Authority: rules.md.
  • Prevention — externalize the goal, requirements, unknowns, and available tools as a durable, selectively-projected conditioning layer (the always-on conditioning/ system-prompt law, the /orient workflow, the nested AGENTS.md hierarchy), so a walk stays focused before drift compounds.

Correction without prevention corrects toward the wrong goal; prevention without correction drifts anyway over a long horizon. Together they bound drift.

Directions

A direction is a coherent, non-terminal motivation the project moves toward and never completes. Directions are deliberately few; minting a new one is reserved to a human ruling, while serving an existing one is free. They are distinct from the goal hierarchy above: that hierarchy is containment (ecosystem ⊃ project ⊃ component) and governs where a defeater escalates, while directions are concern and form a lattice — a single piece of work can serve more than one, and cross-cutting work is usually where the leverage is. Work does not converge on a direction; it converges on a terminal claim, a checkable statement that, once corroborated, means that line of work is finished. A terminal claim carries the same backing discipline as any other claim under the Verification Dual — "is this done" is answered with evidence, never a bare assertion — and the fraction of a direction's terminal claims that have been discharged is the project's convergence signal.

Read the full file on GitHub · 162 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 Changed · +38 lines · +530 tokens per session b7122fbe3fff
  2. 2mo ago First seen · 124 lines · 1,551 tokens per session scan A ef03c74bac85

Subscribe to this mod's changes

predicate AGENTS.md is an instructions file published in the GitHub repository nrdxp/predicate (10 stars, last pushed 2mo ago), licensed MIT. It adds 2,081 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

predicate AGENTS.md compared with instructions from other repositories

predicate AGENTS.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
predicate AGENTS.mdnrdxp/predicateInstructions file102mo agoMITA2,081Codex, OpenCode
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143kyesterdayMITA7,461Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA5,516GitHub Copilot
langchain AGENTS.mdlangchain-ai/langchainInstructions file149kyesterdayMITA4,680Codex, OpenCode
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA3,093GitHub Copilot
vscode ai-customization.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA1,907GitHub Copilot