Skip to content

Aegis

Make AI coding agents architecture-aware: baseline-first, evidence-verified, drift-checked, and safe across long tasks.

Install

$git clone https://github.com/GanyuanRan/Aegis

Install command taken from the project's README or registry entry. Always review code before running it.

Aegis

<strong>Aegis Method Pack</strong>
Make your AI coding agent trustworthy: fewer reworks, safer changes, proof before "done".

<strong>English</strong>
·
<strong>中文</strong>
·
Fast-Track Playbook
·
速通秘籍

Stop babysitting your agent. Aegis makes your agent plan against your real baseline before it edits, prove completion with fresh evidence, and leave simple tasks alone — you get fewer reworks, safer changes, and less blind trust in "done".

What You Get

Aegis is a method pack that makes AI coding agents work like disciplined engineers — so you don't have to watch them.

  • Fewer reworks. Your agent aligns with your project's real baseline — owners, contracts, boundaries — before touching code. It stops guessing, and so do you.
  • Safer changes. Measured on a frozen held-out A/B benchmark: contract pass rate 61.67% → 93.33%, unsafe outcomes 13.33% → 0%.
  • Proof before "done". Completion claims ship with fresh verification evidence, covered scope, and residual risk. You read evidence, not vibes.
  • No ghost code. Retired fallbacks and old paths are tracked or removed with a retirement trigger — technical debt stops accumulating silently.
  • Simple tasks stay simple. Trivial requests stay on the fast path; ceremony only appears when the task genuinely needs it.
  • UI/UX rules on demand. UI/UX governance carries project design rules, lower user effort, and scoped experience evidence through design, implementation, review, and verification.
  • One method pack, every host. The same discipline works across Codex, Claude Code, OpenCode, Kimi, and other skill-aware hosts.

These numbers are bounded advisory evidence from Aegis 2.7.6 (2026-08-11), not a measurement of this release, a universal-quality claim, or completion authority. See the full benchmark and its limitations.

Quick Install

New here? The fastest start is one prompt to your agent — the full install-and-verify flow is below.

Give this prompt to your AI coding agent:

Read https://github.com/GanyuanRan/Aegis, identify my current AI coding host, and install Aegis globally using the correct host guide. If the host is the official DeepSeek Harness (`dsh`), treat global/minimal installation as native profile-plugin installation with `dsh plugin --profile  add "git+https://github.com/GanyuanRan/Aegis.git"`; do not silently substitute the direct-child compatibility path unless the plugin manager is unavailable and I explicitly approve compatibility mode. Restart or reload the host if needed, then run complete-install verification from the installed Aegis method-pack root. Do not run the doctor command from the target project directory. First locate ``, then run `cd  && python scripts/aegis-doctor.py --write-config --json`. Treat the install as complete only if the JSON includes `"ok": true`, `"workspaceSupport": "available"`, and `"configStatus": "configured"`; if the host uses a separate skill discovery directory, also verify it with `--discovery-root `; if the host guide declares a skill directory name prefix, also pass `--discovery-name-prefix `. Also complete the selected host guide's native activation and automatic-entry checks; file discovery or a generic doctor result alone is not sufficient when the host provides a plugin, hook, or session-start bootstrap contract.

Similar plugs

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local…

Why use many token when few token do trick. Viral skill + proxy for coding agents that cuts 65% of tokens by talking like a caveman.

The 1st Collaborative AI Design Agent Workspace. Local-first and open source. Create prototypes, websites, apps, dashboards, presentations, images, and videos with your team…