AGENTS.md@agentsA

AGENTS.md@agents from mickeyyaya/evolve-loop is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add mickeyyaya/evolve-loop/agents/AGENTS.md@git:20260524.69626c6

Pins git:20260524.69626c6 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
mickeyyaya/evolve-loop
Path
agents/AGENTS.md
Versions recorded
3
Latest version
git:20260524.69626c6, committed May 24, 2026
First version recorded
May 20, 2026
Size
4,131 bytes
Repository stars
6
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

# agents/ — Persona Convention Guide

> **Directory purpose**: Each `evolve-<role>.md` file defines a named agent
> persona — its perspective, workflow, output contract, and behavioral rules.
> As of v12.0.0, personas are loaded by the Go binary's `prompts.Loader`
> (`go/internal/prompts/`) and fed to the configured CLI subprocess via the
> bridge adapter. The `evolve subagent run` CLI provides equivalent manual
> dispatch. This file documents the conventions every persona author must
> follow.

## Frontmatter schema

Every persona file MUST begin with a YAML frontmatter block:

```yaml
---
name: <role>                  # matches the filename stem: evolve-<role>.md
perspective: <one-line role description>
output-format: <primary artifact name>
challenge-token: required     # always "required" for pipeline roles
---
```

Required fields: `name`, `perspective`, `output-format`, `challenge-token`.
Optional: `cross-family-with` (name of role whose model tier must differ).

## Naming convention

| Pattern | Example | Notes |
|---|---|---|
| `evolve-<role>.md` | `evolve-builder.md` | Primary persona file |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add mickeyyaya/evolve-loop/agents/AGENTS.md@sha256:d02558ebe321d312

The line at the top of this page pins the label git:20260524.69626c6, 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_cvos37toiyrlbzvh.svg)](https://markdownregistry.com/a/art_cvos37toiyrlbzvh)

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

Versions

The registry has recorded 3 versions of this file, between May 20, 2026 and May 24, 2026, about one every 2 days.

versioncommittedcommitsizeaudit
git:20260524.69626c6 latest2026-05-24 69626c6 4,131 BA view · diff
git:20260522.c3e6cfb2026-05-22 c3e6cfb 4,015 BA view · diff
git:20260520.5afc4822026-05-20 5afc482 4,001 BA view

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 (4131 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

mickeyyaya/evolve-loop · 6 stars · license Apache-2.0 · pushed 2026-11-03 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_cvos37toiyrlbzvh
GET https://markdownregistry.com/api/v1/resolve?ref=mickeyyaya/evolve-loop/agents/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/d02558ebe321d312e5d3ec0d18c978f8d4fb47bc82a0631dbd80b5a726773d64

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 mickeyyaya/evolve-loop

AGENTS.md@.evolve/profiles AGENTS.md file
mickeyyaya/evolve-loop · .evolve/profiles/AGENTS.md
git:20261008.0936a73 · audit A · 6 stars
AGENTS.md AGENTS.md file
mickeyyaya/evolve-loop · AGENTS.md
git:20261027.4a1d025 · audit A · 6 stars
CLAUDE.md CLAUDE.md file
mickeyyaya/evolve-loop · CLAUDE.md
git:20261027.4a1d025 · audit A · 6 stars
llms.txt@landing/shared llms.txt file
mickeyyaya/evolve-loop · landing/shared/llms.txt
git:20261008.46aa746 · audit B · 6 stars
adversarial-testing SKILL.md skill
mickeyyaya/evolve-loop · skills/adversarial-testing/SKILL.md · Use when authoring evals/predicates (Scout, TDD-Engineer), framing an audit (Auditor), or justifying which phases run…
git:20260914.80b348e · audit A · 6 stars
architecture-review SKILL.md skill
mickeyyaya/evolve-loop · skills/architecture-review/SKILL.md · Use when reviewing the structure of a code change read-only — single sources and duplicated beliefs, dependency…
git:20261007.f16bf48 · audit A · 6 stars
audit SKILL.md skill
mickeyyaya/evolve-loop · skills/audit/SKILL.md · Use after build has produced build-report.md. Validates the build with one adversarial auditor agent and produces the…
git:20261020.f4ba3ee · audit A · 6 stars
code-review-simplify SKILL.md skill
mickeyyaya/evolve-loop · skills/code-review-simplify/SKILL.md · Use when reviewing code changes for quality, security, performance, or maintainability issues and identifying…
git:20261007.e134ff4 · audit A · 6 stars
commit SKILL.md skill
mickeyyaya/evolve-loop · skills/commit/SKILL.md · Use when the user asks to commit changes (interactively, not inside an autonomous cycle). Runs code-simplifier + one…
git:20261027.f0f1a5a · audit A · 6 stars
diff-review SKILL.md skill
mickeyyaya/evolve-loop · skills/diff-review/SKILL.md · Budget-capped adversarial review + simplification pass over a STAGED DIFF only — one agent, two lenses, findings-first…
git:20261027.f0f1a5a · audit A · 6 stars
docs-review SKILL.md skill
mickeyyaya/evolve-loop · skills/docs-review/SKILL.md · Use when a change touches only documents (every changed path ends in .md) — research dossiers, plans, ADRs…
git:20261020.bec061a · audit A · 6 stars
docs-write SKILL.md skill
mickeyyaya/evolve-loop · skills/docs-write/SKILL.md · Use when you write or change any document for people to read — research dossiers, plans, ADRs, architecture specs…
git:20261020.33db5c7 · audit A · 6 stars

Every file in mickeyyaya/evolve-loop

Other files named AGENTS.md@agents

AGENTS.md@agents AGENTS.md file
vasilyu1983/ai-agents-public · agents/AGENTS.md
git:20261005.5db538c · audit A · 101 stars
AGENTS.md@agents AGENTS.md file
vincentchuwaichow/vanguard-frontier-agentic · agents/AGENTS.md
git:20261030.246754b · audit A · 24 stars
AGENTS.md@agents AGENTS.md file
andreibesleaga/gabbe · agents/AGENTS.md
git:20261029.ce4317a · audit A · 23 stars
AGENTS.md@agents AGENTS.md file
liatrio-labs/claude-code-gauntlet · agents/AGENTS.md
git:20261006.0c6a8b0 · audit A · 13 stars
AGENTS.md@agents AGENTS.md file
lyalindotcom/gemini-anything-agent · agents/AGENTS.md
git:20261014.ec7a5d0 · audit A · 11 stars
AGENTS.md@agents AGENTS.md file
tayyabexe/skills · agents/AGENTS.md
git:20260302.f55e49d · audit A · 4 stars

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