AGENTS.mdA

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

Install it, pinned
mdr add ganyuanran/aegis/AGENTS.md@git:20261011.c8e05b4

Pins git:20261011.c8e05b4 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
ganyuanran/aegis
Path
AGENTS.md
Versions recorded
7
Latest version
git:20261011.c8e05b4, committed Oct 11, 2026
First version recorded
May 5, 2026
Size
6,005 bytes
Repository stars
1,417
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

# Aegis Repository Agent Guide

Status: `Approved`

## 1. Purpose

This file is the public repository guide for AI coding agents working in the
`Aegis` repository.

It defines:

- what this repository is and is not
- which authority docs to read before changing behavior
- how to keep changes small, verifiable, and public-safe
- which boundaries must not drift while improving Aegis

It does not replace:

- `docs/current/README.md` for the current authority map
- approved ADRs in `docs/adr/`
- task-specific baseline docs in `docs/current/`
- installed Aegis skills and workflows
- host-specific installation docs such as `docs/README.codex.md`,
  `docs/README.opencode.md`, `docs/README.claude-code.md`,
  `docs/README.codebuddy.md`, `docs/README.deepseek-tui.md`, and
  `docs/README.trae.md`

## 2. Authority Order

When instructions conflict, use this order:

1. The user's current explicit instruction
2. this root `AGENTS.md`
3. `docs/current/README.md`
4. approved ADRs in `docs/adr/`
5. task-specific approved docs in `docs/current/`
6. host-specific docs and tests
7. installed Aegis skills and workflow guidance

If the authority source is unclear, state the gap and choose the smallest
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ganyuanran/aegis/AGENTS.md@sha256:d051cf463ae5ad82

The line at the top of this page pins the label git:20261011.c8e05b4, 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_quuuicyjtj3iml2a.svg)](https://markdownregistry.com/a/art_quuuicyjtj3iml2a)

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

Versions

The registry has recorded 7 versions of this file, between May 5, 2026 and Oct 11, 2026, about one every 26 days.

versioncommittedcommitsizeaudit
git:20261011.c8e05b4 latest2026-10-11 c8e05b4 6,005 BA view · diff
git:20261011.d34934a2026-10-11 d34934a 6,196 BA view · diff
git:20260813.0c732702026-08-13 0c73270 5,489 BA view · diff
git:20260506.dd6eae82026-05-06 dd6eae8 5,515 BA view · diff
git:20260506.01d09be2026-05-06 01d09be 5,516 BA view · diff
git:20260506.128fe5a2026-05-06 128fe5a 5,407 BA view · diff
git:20260505.00f2eba2026-05-05 00f2eba 5,488 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 (6005 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

ganyuanran/aegis · 1,417 stars · license MIT · pushed 2026-11-04 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_quuuicyjtj3iml2a
GET https://markdownregistry.com/api/v1/resolve?ref=ganyuanran/aegis/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/d051cf463ae5ad823546509b684b8769fd57f1e326905b12e05774eb993e63b0

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 ganyuanran/aegis

CLAUDE.md CLAUDE.md file
ganyuanran/aegis · CLAUDE.md
git:20260813.0c73270 · audit A · 1,417 stars
anti-entropy-governance SKILL.md skill
ganyuanran/aegis · skills/anti-entropy-governance/SKILL.md · Use when touching retiring old logic, collapsing duplicate owners, removing fallbacks, or…
git:20260927.6d97ed0 · audit A · 1,417 stars
brainstorming SKILL.md skill
ganyuanran/aegis · skills/brainstorming/SKILL.md · Use when defining ambiguous or high-complexity new features, product behavior, UI/component design, architecture…
git:20261104.8dcabf5 · audit A · 1,417 stars
communicating-concisely SKILL.md skill
ganyuanran/aegis · skills/communicating-concisely/SKILL.md · Use when the user asks for caveman mode, fewer tokens, brief responses, compressed communication, or otherwise…
git:20260723.88b8ec9 · audit A · 1,417 stars
dispatching-parallel-agents SKILL.md skill
ganyuanran/aegis · skills/dispatching-parallel-agents/SKILL.md · Use when facing 2+ independent tasks without a written plan, with no conflicting shared mutable state or sequential…
git:20260920.8265b5c · audit A · 1,417 stars
establishing-project-context SKILL.md skill
ganyuanran/aegis · skills/establishing-project-context/SKILL.md · Use when the user asks to establish shared project language, or project work exposes a conflicting, renamed, or…
git:20260809.f62395b · audit A · 1,417 stars
executing-plans SKILL.md skill
ganyuanran/aegis · skills/executing-plans/SKILL.md · Use when executing a written implementation plan across sessions or with review checkpoints. Small or single-slice…
git:20261001.ed3a0a7 · audit A · 1,417 stars
finishing-a-development-branch SKILL.md skill
ganyuanran/aegis · skills/finishing-a-development-branch/SKILL.md · Use when verified work needs integration or cleanup of an existing task-created branch/worktree, or the user explicitly…
git:20261010.8d5b88e · audit A · 1,417 stars
first-principles-review SKILL.md skill
ganyuanran/aegis · skills/first-principles-review/SKILL.md · Use when asked for first-principles or Occam's-razor review, or when high-risk decisions involve competing constraints…
git:20261025.21787f7 · audit A · 1,417 stars
goal-framing SKILL.md skill
ganyuanran/aegis · skills/goal-framing/SKILL.md · Use when the user explicitly sets an Aegis goal with /aegis-goal, Aegis goal:, or asks to define goal, success…
git:20260723.88b8ec9 · audit A · 1,417 stars
long-task-continuation SKILL.md skill
ganyuanran/aegis · skills/long-task-continuation/SKILL.md · Use when a task is multi-step, may span context resets or sessions, uses subagents, or risks losing state before…
git:20261025.21787f7 · audit A · 1,417 stars
receiving-code-review SKILL.md skill
ganyuanran/aegis · skills/receiving-code-review/SKILL.md · Use when receiving code review feedback before implementing suggestions, especially when feedback is unclear, risky…
git:20260723.88b8ec9 · audit A · 1,417 stars

Every file in ganyuanran/aegis

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261102.920d634 · audit A · 433,876 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20261020.b739a8a · audit A · 314,583 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261030.f29e332 · audit A · 299,696 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 199,595 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 185,249 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 144,492 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261107.ef99eb5 · audit A · 140,694 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20261106.e45976c · audit A · 118,366 stars

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