GroundRules AGENTS.md

GroundRules AGENTS.md is an instructions file for Codex, OpenCode from chama-x/GroundRules. It costs 75 tokens per session, scanned A, original, MIT.

A set of project instructions that tells an coding agent which guardrail files to read before changing a codebase.

In plain words
What is it for?
Use it when working in a codebase that has identity and grounding documents under .agents/rules/.
Why use it?
It helps the agent understand the project's rules, boundaries, tools, and working practices before taking action.

Instructions file for CodexOpenCode

Install

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.

agentmods
npx agentmods add instructions/chama-x/groundrules/agents-md
Clone the repo
git clone --depth 1 https://github.com/chama-x/GroundRules

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

README.md
[![agentmods](https://agentmods.dev/badge/instructions/chama-x/groundrules/agents-md.svg)](https://agentmods.dev/instructions/chama-x/groundrules/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/chama-x/groundrules/agents-md"><img src="https://agentmods.dev/badge/instructions/chama-x/groundrules/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 75 This file is loaded in full into every session.
When invoked 75 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
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.00075 $0.00075
Opus 5 $0.00037 $0.00037
Sonnet 5 $0.00015 $0.00015
Haiku 4.5 $0.00007 $0.00007

Measured 2d ago against content hash ea4afadbbece, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

GroundRules 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 2d 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 · 5 lines

What it actually says

Agent Context Router

Before taking any action on this codebase, read the following guardrail files:

  1. .agents/rules/IDENTITY.md — Project stack, test command, and non-negotiable boundaries ("What We Don't Do").
  2. .agents/rules/GROUNDING.md — Cognitive protocol, epistemic security, and ambiguity resolution rules.
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. 2d ago First seen · 5 lines · 75 tokens per session scan A ea4afadbbece

Subscribe to this mod's changes

GroundRules AGENTS.md is an instructions file published in the GitHub repository chama-x/GroundRules (5 stars, last pushed 22d ago), licensed MIT. It adds 75 tokens to every session, about $0.0004 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-09-03.

Related

Other instructions, from other repositories

pentagi CLAUDE.md

Claude Code instructions for vxcontrol/pentagi, covering claude.md, core interaction rules, project overview, build & development commands and backend (run from backend/).

vxcontrol/pentagi · 2,308 tokens

codex-autoresearch AGENTS.md

Instructions for TheGreenCedar/codex-autoresearch, covering agents.md, purpose and scope, canonical sources, stable product boundaries and source and package boundaries.

TheGreenCedar/codex-autoresearch · 2,034 tokens

OwnPilot AGENTS.md

Instructions for ownpilot/OwnPilot, covering ownpilot, architecture, key patterns, commands and tech stack.

ownpilot/OwnPilot · 1,260 tokens

autogen copilot-instructions.md

Copilot instructions for microsoft/autogen, covering autogen multi-agent ai framework, working effectively, prerequisites and environment setup, python development workflow and quick validation (under 1 second each).

microsoft/autogen · 2,174 tokens

nightshift AGENTS.md

AGENTS.md instructions for orwa-mahmoud/nightshift: AI-assisted contributions are welcome. The same correctness, security, licensing, testing, and quality standards apply regardless of which tools are used.

orwa-mahmoud/nightshift · 193 tokens

Agent-Worlds CLAUDE.md

Claude Code instructions for hjl2004-10/Agent-Worlds, covering ai夸父 开发规范文档 (v2.0 - skill化重构), 架构总览:概念坐标系(先看这张图), 横向:子系统(业界术语 ↔ 本项目目录), 纵向:作用域分层(每个子系统内部都按此三层) and 正交二维(横×纵 = 网格,不是树).

hjl2004-10/Agent-Worlds · 7,125 tokens