sanctuary-framework: Instructions file for Codex

AGENTS.md

sanctuary-framework AGENTS.md is an instructions file for Codex, OpenCode from eriknewton/sanctuary-framework. It costs 6,258 tokens per session, scanned A, original, Apache-2.0.

Repository instructions for Sanctuary and Concordia that tell coding agents how to handle attribution, tests, commits, architecture, and writing conventions.

In plain words
What is it for?
Use them when editing these repositories to check the relevant guidance, run required type checks and tests before commits, and follow project-specific documentation and code conventions.
Why use it?
They keep agent changes aligned with the project's authorship rules, required test baseline, and established codebase practices.

Instructions file for CodexOpenCode

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

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

Reuse

Borrowing it

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

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 sanctuary-framework AGENTS.md

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

Your own site · 80×15
<a href="https://agentmods.dev/instructions/eriknewton/sanctuary-framework/agents-md"><img src="https://agentmods.dev/badge/instructions/eriknewton/sanctuary-framework/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 6,258 This file is loaded in full into every session.
When invoked 6,258 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.06258 $0.06258
Opus 5.5 $0.02503 $0.02503
Sonnet 5.5 $0.01252 $0.01252
Haiku 4.5 $0.00626 $0.00626

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

Security

Grade A, and why

sanctuary-framework 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 8d 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 · 116 lines

How it starts

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

AGENTS.md: Sanctuary & Concordia Security and Sovereignty Review Context

This file is a briefing for any AI coding agent working in these codebases. Read it before making any changes. It is the canonical, model-neutral source of truth for how to work in this repo; tool-specific files (for example CLAUDE.md) import this file rather than duplicating it.

Attribution Rule (MANDATORY)

No public-facing document, README, blog post, plugin manifest, package metadata, or software artifact may reference or attribute CIMC as author or creator of Sanctuary or Concordia. Erik Newton is the sole author. CIMC may be mentioned in internal/biographical context only.

Commit discipline: test baseline enforcement (MANDATORY)

Every commit to Sanctuary main MUST run npm run typecheck && npm test against a clean working tree before staging; block the commit if either fails, if any transform/collection error appears in vitest output, or if the passing-test count drops below the integer in .test-baseline at repo root.

This rule is now backed by structural enforcement, not just instruction, split across two local hooks by cost (2026-09-26):

  • Pre-commit hook at .githooks/pre-commit runs the fast tier locally on every git commit: npm run typecheck, then npx vitest related --run scoped to the commit's own staged .ts/.tsx files under server/, with the same transform/collection-error scan. It does NOT check .test-baseline (measured shape is under a minute on a modern Mac). Bypass with git commit --no-verify.
  • Pre-push hook at .githooks/pre-push runs the full tier on every git push: the complete npm test, the transform/collection-error scan, the silent-test-file-drop check, and the .test-baseline floor comparison (both directions), unchanged logic from what used to run inline in pre-commit. Measured shape is the full suite's own wall-clock time, roughly 8 to 19 minutes depending on the machine. Emergency bypass: SKIP_TEST_BASELINE=1 git push ... (logged to .test-baseline-overrides.log for audit).
  • Install both once with cd server && npm run install-hooks (copies both files into the real hooks directory git will execute from).
  • CI check at .github/workflows/test-baseline-guard.yml is UNCHANGED by this split: it runs the same full-suite gates on every PR and every push to main, and remains the merge gate. This is the enforcement layer for pushes that bypass the local pre-push hook with --no-verify, SKIP_TEST_BASELINE=1, or from an uninstalled environment. See docs/audit/branch-protection-setup.md for the Git branch-protection runbook required to make this check a hard merge gate.
  • Written instruction (this block) remains the human-facing contract. The structural layers make violations hard; this rule makes the intent explicit so a reviewer or auditor can cite it.

Read the full file on GitHub · 116 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. 8d ago Changed e01fa46ec7e4
  2. 9d ago Changed 0dbc722f64fb
  3. 13d ago Changed · +4 tokens per session 2262fc25ad48
  4. 17d ago Changed · +2 lines · +295 tokens per session ab784857d82a
  5. 20d ago Changed · -4 tokens per session a4fa9cc0f47c
  6. 1mo ago Changed · +4 lines · +270 tokens per session f877927fed69
  7. 1mo ago Changed · +219 tokens per session 8281b33e6522
  8. 1mo ago First seen · 110 lines · 5,474 tokens per session scan A 49819c052fdc

Subscribe to this mod's changes

sanctuary-framework AGENTS.md is an instructions file published in the GitHub repository eriknewton/sanctuary-framework (9 stars, last pushed today), licensed Apache-2.0. It adds 6,258 tokens to every session, about $0.0250 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

Other instructions, from other repositories