Skip to content

Add the retrieval contract and escalation to AGENTS.md - #2

Merged
neuromechanist merged 1 commit into
mainfrom
feat/agents-retrieval-and-escalation
Sep 14, 2026
Merged

neuromechanist merged 1 commit into
mainfrom
feat/agents-retrieval-and-escalation

Conversation

@neuromechanist

Copy link
Copy Markdown
Contributor

Applies the pattern nemar-cli settled in epic nemarOrg/nemar-cli#1336 (phase 6, nemarOrg/nemar-cli#1378) to this repository.

Additive, and that is the correct result

This AGENTS.md does not duplicate the documentation site, so nothing moved out. The pattern is "do not keep a second copy of docs.nemar.org", not "make the file shorter", and applying it honestly here means adding the two things that were missing.

What was missing

A retrieval contract. docs.nemar.org is the canonical surface now and roughly half of it is gated, so pointing at it without saying how to read it would be a hollow instruction. The file now states that every page has a Markdown mirror at <path>.md, that llms.txt indexes them, and that nemar admin docs <path...> reads a gated page without a browser by trading a CLI key for a short-lived, read-only documentation session.

The escalation instruction. A contributor who hits an admin-adjacent problem, or needs a runbook they cannot open, files the issue anyway, says what they could not read, and tags @nemarOrg/admins. Escalation replaces read access; silence does not - a blocked agent that stops without saying so leaves the problem real and unreported.

Verification

The referenced docs.nemar.org URL was checked live and returns 200, including its Markdown mirror form.

Applies the pattern nemar-cli settled in epic nemarOrg/nemar-cli#1336
phase 6. Additive: this file does not duplicate the documentation site, so
nothing moved out.

Two things it was missing. A retrieval contract, because docs.nemar.org is
the canonical surface now and half of it is gated, so pointing at it
without saying how to read it would be a hollow instruction: every page
has a Markdown mirror at <path>.md, llms.txt indexes them, and
`nemar admin docs <path...>` reads a gated page without a browser.

And the escalation instruction. A contributor who hits an admin-adjacent
problem, or needs a runbook they cannot open, files the issue anyway and
tags @nemarOrg/admins. Escalation replaces read access; silence does not.

Verified the referenced docs URL resolves.
@neuromechanist
neuromechanist merged commit 2bc646f into main Sep 14, 2026
@neuromechanist
neuromechanist deleted the feat/agents-retrieval-and-escalation branch September 14, 2026 14:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant