AGENTS.md@tools/spec-loopB

AGENTS.md@tools/spec-loop from apache/magpie is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add apache/magpie/tools/spec-loop/AGENTS.md@git:20260704.383378b

Pins git:20260704.383378b in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 13 of 14 checks passed
Kind
AGENTS.md file
Repository
apache/magpie
Path
tools/spec-loop/AGENTS.md
Versions recorded
5
Latest version
git:20260704.383378b, committed Jul 4, 2026
First version recorded
May 26, 2026
Size
4,161 bytes
Repository stars
138
License
Apache-2.0

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

<!-- SPDX-License-Identifier: Apache-2.0
     https://www.apache.org/licenses/LICENSE-2.0 -->

# AGENTS — spec-loop operational context

This file is the **operational** context for the spec-loop only:
build/validate commands, the repository map, and the branch rules. It is
loaded by the loop's prompts in addition to the repository-wide
[`/AGENTS.md`](../../AGENTS.md), which still governs everything (commit
trailers, placeholder convention, privacy/security posture). Where the
two overlap, the repo-wide `AGENTS.md` wins.

## Repository map (what the loop edits)

This repo has no `src/` tree. Work lands in one of:

- `.claude/skills/<name>/SKILL.md` — agent-readable skills (Markdown +
  YAML frontmatter; required keys `name`, `description`, `license`).
- `tools/<tool>/` — deterministic Python tools (`uv`, hatchling,
  `src/` + `tests/`, `dependencies = []` where possible).
- `docs/` — human-facing documentation. `docs/rfcs/` is the **separate**
  governance layer — the loop never edits it.
- `tools/spec-loop/specs/` — the specs this loop consumes.

## Validation commands (the build "backpressure" step)

Run the spec's own **Validation** block first. General checks:

```bash
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add apache/magpie/tools/spec-loop/AGENTS.md@sha256:b0350917b41113b4

The line at the top of this page pins the label git:20260704.383378b, 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_weynz4csmusfcypw.svg)](https://markdownregistry.com/a/art_weynz4csmusfcypw)

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

Versions

The registry has recorded 5 versions of this file, between May 26, 2026 and Jul 4, 2026, about one every 10 days.

versioncommittedcommitsizeaudit
git:20260704.383378b latest2026-07-04 383378b 4,161 BB view · diff
git:20260703.0fca2ee2026-07-03 0fca2ee 3,998 BB view · diff
git:20260703.62c39652026-07-03 62c3965 3,873 BB view · diff
git:20260528.b62a1592026-05-28 b62a159 3,812 BB view · diff
git:20260526.5c6bd322026-05-26 5c6bd32 3,794 BB view

Audit of the latest version

B  13 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No script tag (matched: <script)
  • pass: Size between 200 bytes and 200 KB (4161 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

Starting a new one? Use a template for AGENTS.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

apache/magpie · 138 stars · license Apache-2.0 · pushed 2026-11-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_weynz4csmusfcypw
GET https://markdownregistry.com/api/v1/resolve?ref=apache/magpie/tools/spec-loop/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/b0350917b41113b43d5a19c6ffa355b998f74d15f119a22128db16b116065497

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 apache/magpie

AGENTS.md AGENTS.md file
apache/magpie · AGENTS.md
git:20261027.5bb1ea3 · audit F · 138 stars
activity-sweep SKILL.md skill
apache/magpie · plugins/magpie-contributor-growth/skills/activity-sweep/SKILL.md · Read-only activity card for a named contributor on `<upstream>` across code-host and tracker surfaces. Code-host and…
git:20261027.5395957 · audit A · 138 stars
calibrate SKILL.md skill
apache/magpie · plugins/magpie-contributor-growth/skills/calibrate/SKILL.md · Derive committer and <governance-body> reference levels from the project's own past nomination decisions on…
git:20261101.f3adbcc · audit A · 138 stars
candidate-screen SKILL.md skill
apache/magpie · plugins/magpie-contributor-growth/skills/candidate-screen/SKILL.md · Surface activity data about recent contributors who pass a long-tail pre-filter — for committer and…
git:20261031.ff839a6 · audit A · 138 stars
committer-onboarding SKILL.md skill
apache/magpie · plugins/magpie-contributor-growth/skills/committer-onboarding/SKILL.md · Post-vote committer and PMC onboarding for Apache projects, podling or top-level: walks the nominator from ICLA check…
git:20261027.5395957 · audit B · 138 stars
contributor-to-committer SKILL.md skill
apache/magpie · plugins/magpie-contributor-growth/skills/contributor-to-committer/SKILL.md · Read-only brief showing a contributor's activity next to the project's committer or PMC reference levels, as plain…
git:20261101.f3adbcc · audit A · 138 stars
identity-map SKILL.md skill
apache/magpie · plugins/magpie-contributor-growth/skills/identity-map/SKILL.md · Map a contributor's code-host or community handle to their Slack, Discord, Matrix, mailing-list, and social-media…
git:20261027.5395957 · audit B · 138 stars
nomination SKILL.md skill
apache/magpie · plugins/magpie-contributor-growth/skills/nomination/SKILL.md · Read-only nomination brief for a named contributor on <upstream>. Aggregates code-host and tracker activity across…
git:20261027.5395957 · audit A · 138 stars
onboarding-concierge SKILL.md skill
apache/magpie · plugins/magpie-contributor-growth/skills/onboarding-concierge/SKILL.md · Answer newcomer contribution questions grounded in `CONTRIBUTING.md` and docs. Classifies questions into setup…
git:20261027.5395957 · audit A · 138 stars
sentiment SKILL.md skill
apache/magpie · plugins/magpie-contributor-growth/skills/sentiment/SKILL.md · Measure contributor-sentiment signals on `<upstream>` over a window: thread tone, time-to-first-reply, first-PR…
git:20261027.5395957 · audit A · 138 stars
backlog-stats SKILL.md skill
apache/magpie · plugins/magpie-issue/skills/backlog-stats/SKILL.md · Read-only maintainer dashboard for the open general-issue backlog of <issue-tracker>. Surfaces a health rating…
git:20261027.5395957 · audit A · 138 stars
deduplicate SKILL.md skill
apache/magpie · plugins/magpie-issue/skills/deduplicate/SKILL.md · Merge two open `<issue-tracker>` issues that describe the same root cause, preserving both reporters' context. Proposes…
git:20261027.5395957 · audit A · 138 stars

Every file in apache/magpie

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