AGENTS.mdA

AGENTS.md from hlintel/headron is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add hlintel/headron/AGENTS.md@git:20261117.aee44af

Pins git:20261117.aee44af in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
hlintel/headron
Path
AGENTS.md
Versions recorded
5
Latest version
git:20261117.aee44af, committed Nov 17, 2026
First version recorded
Nov 13, 2026
Size
3,622 bytes
Repository stars
4
License
MIT

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# AGENTS.md — Headron Software, contract v3.64.0

**GENERATED by `python scripts/atlas.py index --write`; `atlas.py check` fails on any hand
edit.** It comes from `atlas.yaml`, `VERSION` and the tree: change the declaration, not this file.

## Ask, do not read

**Never read this repository breadth-first.** Ask where to go, then load only what the answer names.

**Plug in:** `python scripts/atlas.py port <file|dir|.> --frame agent`: route, tier, gates, lessons, next steps. Hooks: shell `headron shell --json "<cmd>"` · edit `headron port <file> --line` · done `headron verify`.

```bash
python scripts/atlas.py gate  <path> <gate>    # ONE command: cheapest answer, most accurate
python scripts/atlas.py plan  <path> --task <task> --change <class> [--modifier <m>] --json
python scripts/atlas.py check                  # exit code IS the verdict; doctor: can it run here
```

Asked to *use, install, open, run, pull, report* this repository? `llms.txt` → *When asked to*.
Directed into a role? `headron role`. Picking up interrupted work? `headron resume`. `--json` records
are frozen in `tools/atlas-output.schema.json`: depend on those ids.

## Rules that fail the build
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add hlintel/headron/AGENTS.md@sha256:2ddc5bd903c829f5

The line at the top of this page pins the label git:20261117.aee44af, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_fetx5ts4fvz7mhie.svg)](https://markdownregistry.com/a/art_fetx5ts4fvz7mhie)

1 badge image fetches in 30 days. What the badge shows.

Ask from your agent
claude mcp add --transport http markdownregistry https://markdownregistry.com/mcp/registry

Then ask it: what changed in hlintel/headron/AGENTS.md since the version I have? It reads every saved version here, no key and no account. Any agent that speaks MCP can add it.

Got a copy of AGENTS.md from somewhere else? Ask it: where did my AGENTS.md come from, and what was changed? It names the public original, the version yours is closest to and every changed line. The text is not kept.

Versions

The registry has recorded 5 versions of this file, between Nov 13, 2026 and Nov 17, 2026, about one every day.

Watch this file (sign in, one email per new version)

versioncommittedcommitsizeaudit
git:20261117.aee44af latest2026-11-17 aee44af 3,622 BA view · diff
git:20261117.13feb012026-11-17 13feb01 3,622 BA view · diff
git:20261117.c3795df2026-11-17 c3795df 3,623 BA view · diff
git:20261117.644c4812026-11-17 644c481 3,623 BA view · diff
git:20261113.206e6c22026-11-13 206e6c2 3,623 BA view
Check a whole project

From the root of your project, one line hashes each installed skill's SKILL.md, your AGENTS.md and your CLAUDE.md, and asks the registry once. Only the fingerprints and paths are sent.

sha256sum .claude/skills/*/SKILL.md AGENTS.md CLAUDE.md | curl -s --data-binary @- https://markdownregistry.com/api/v1/check-copies

In CI, add --fail-with-body: the answer is 409 when any file is behind, so the step fails and still prints which files.

sha256sum .claude/skills/*/SKILL.md AGENTS.md CLAUDE.md | curl -s --fail-with-body --data-binary @- https://markdownregistry.com/api/v1/check-copies

No sha256sum on your machine? shasum -a 256 prints the same lines.

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (3622 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

hlintel/headron · 4 stars · license MIT · pushed 2026-11-18 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_fetx5ts4fvz7mhie
GET https://markdownregistry.com/api/v1/resolve?ref=hlintel/headron/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/2ddc5bd903c829f557dc4efa1d76c762d6c22247beec3d8d7f61ef2ecf14f718

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from hlintel/headron

headron SKILL.md skill
hlintel/headron · .agents/skills/headron/SKILL.md · Route, gate, verify and search the Headron engineering atlas. Use before editing any file in a Headron checkout, to…
git:20261117.6f99b9f · audit A · 4 stars
CLAUDE.md CLAUDE.md file
hlintel/headron · CLAUDE.md
git:20261027.9024dde · audit A · 4 stars
llms.txt llms.txt file
hlintel/headron · llms.txt
git:20261117.aee44af · audit A · 4 stars
headron SKILL.md skill
hlintel/headron · models/chat/headron/SKILL.md · Engineering discipline for code, plans, reviews, debugging and done-claims: label evidence, name the proving gate…
git:20261117.aee44af · audit A · 4 stars
headron-verification SKILL.md skill
hlintel/headron · skills/headron-verification/SKILL.md · Verify a change with Headron before calling it done. Use when finishing a coding task in a repo with an atlas.yaml, or…
git:20261113.988de7a · audit A · 4 stars
headron SKILL.md skill
hlintel/headron · skills/headron/SKILL.md · Record AI mistakes in the Headron ledger.
git:20261117.6f99b9f · audit A · 4 stars
land SKILL.md skill
hlintel/headron · skills/land/SKILL.md · Land this topic branch — rebase, run the suite, push, open the pull request and arm auto-merge, as one step.
git:20261117.6f99b9f · audit A · 4 stars
rekick SKILL.md skill
hlintel/headron · skills/rekick/SKILL.md · Restart the checks a forge outage stranded on an open pull request.
git:20261117.6f99b9f · audit A · 4 stars
sync SKILL.md skill
hlintel/headron · skills/sync/SKILL.md · Pull the default branch, arm stranded pull requests and remove finished topic-branch worktrees.
git:20261117.6f99b9f · audit A · 4 stars
run-workflow SKILL.md skill
hlintel/headron · skills/system/run-workflow/SKILL.md · How to write and run a dynamic workflow script with the `run_workflow` tool: a Python script that orchestrates many…
git:20261104.5d19a74 · audit A · 4 stars

Every file in hlintel/headron

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261118.b60836a · audit A · 469,585 stars
AGENTS.md AGENTS.md file
mattpocock/skills · AGENTS.md
git:20260713.697d4ce · audit B · 327,521 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20261020.b739a8a · audit A · 319,649 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261116.597d103 · audit A · 305,967 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 202,441 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 190,846 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 149,864 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261115.8837fda · audit A · 141,854 stars

Browse by kind, by grade A, or by owner.