Home / ganyuanran / aegis · AGENTS.md · GitHub

AGENTS.md agentsA

AGENTS.md is agent-read markdown (agents) from ganyuanran/aegis.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns 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

Latest version
mdr add ganyuanran/aegis/AGENTS.md@git:20260813.0c73270
Exact content
mdr add ganyuanran/aegis/AGENTS.md@sha256:892cb64cdc864ba1

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

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

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260813.0c73270 latest2026-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. Deterministic, no model, same answer every run.
  • pass: Size between 200 bytes and 200 KB (5489 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,280 stars · license MIT · pushed 2026-09-24 · 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/892cb64cdc864ba1d912a0d227bf724e5b2c5f8a8ccaf516f5f1ce78557d6397

Your agent 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.

More from ganyuanran/aegis

CLAUDE.md claude
ganyuanran/aegis · CLAUDE.md
git:20260813.0c73270 · audit A · 1,280 stars
anti-entropy-governance skill
ganyuanran/aegis · skills/anti-entropy-governance/SKILL.md · Use when touching retiring old logic, collapsing duplicate owners, removing fallbacks, or…
git:20260830.8e0cee3 · audit A · 1,280 stars
brainstorming skill
ganyuanran/aegis · skills/brainstorming/SKILL.md · Use when defining ambiguous or high-complexity new features, product behavior, UI/component design, architecture…
git:20260916.9a51c7a · audit A · 1,280 stars
communicating-concisely 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,280 stars
dispatching-parallel-agents 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,280 stars
establishing-project-context 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,280 stars
executing-plans 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:20260828.f7ae3a7 · audit A · 1,280 stars
finishing-a-development-branch 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:20260809.f62395b · audit A · 1,280 stars
first-principles-review 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:20260905.878cac9 · audit A · 1,280 stars
goal-framing 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,280 stars
long-task-continuation 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:20260916.9a51c7a · audit A · 1,280 stars
receiving-code-review 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,280 stars

Every file in ganyuanran/aegis

Other files named AGENTS.md

AGENTS.md agents
obra/superpowers · AGENTS.md
git:20260919.5bf4e78 · audit A · 291,204 stars
AGENTS.md agents
affaan-m/ecc · AGENTS.md
git:20260919.91ba9b4 · audit A · 266,832 stars
AGENTS.md agents
firecrawl/firecrawl · AGENTS.md
git:20260613.d9a35c0 · audit A · 184,144 stars
AGENTS.md agents
dietrichgebert/ponytail · AGENTS.md
git:20260710.b6c0448 · audit A · 144,862 stars
AGENTS.md agents
garrytan/gstack · AGENTS.md
git:20260914.4a3c6a8 · audit A · 134,082 stars
AGENTS.md agents
graphify-labs/graphify · AGENTS.md
git:20260414.7ec92ec · audit A · 121,202 stars
AGENTS.md agents
juliusbrussee/caveman · AGENTS.md
git:20260902.d9faebc · audit A · 107,708 stars
AGENTS.md agents
addyosmani/agent-skills · AGENTS.md
git:20260709.b665c5c · audit A · 98,554 stars

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