Skip to main content
ClaudeWave

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

Subagents1.2k stars52 forksPythonMITUpdated today
ClaudeWave Trust Score
92/100
Verified
Passed
  • Open-source license (MIT)
  • Actively maintained (<30d)
  • Clear description
  • Topics declared
Last scanned: 9/11/2026
Install as a Claude Code subagent
Method: Clone
Terminal
git clone https://github.com/GanyuanRan/Aegis && cp Aegis/*.md ~/.claude/agents/
1. Clone the repository and copy the agent .md definitions into ~/.claude/agents (or .claude/agents inside a project).
2. Start a new Claude Code session to load the agents.
3. Delegate work to them with the Task/Agent tool or by name.

24 items in this repository

|

Install
brainstormSlash Command

Deprecated - use the aegis:brainstorming skill instead

Install
execute-planSlash Command

Deprecated - use the aegis:executing-plans skill instead

Install
write-planSlash Command

Deprecated - use the aegis:writing-plans skill instead

Install

Use when touching retiring old logic, collapsing duplicate owners, removing fallbacks, or schema/persistence/source-of-truth boundaries; identify opportunities automatically; destructive execution requires explicit confirmation.

Install

Use when defining ambiguous or high-complexity new features, product behavior, UI/component design, architecture choices, contract changes, or when grilling/pressure-testing a plan or design. Routine small requests stay on the fast path.

Install

Use when the user asks for caveman mode, fewer tokens, brief responses, compressed communication, or otherwise explicitly requests a much shorter answer.

Install

Use when facing 2+ independent tasks without a written plan, with no shared state or sequential dependencies, where parallel delegation beats inline cost; otherwise inline. Planned tasks use subagent-driven-development.

Install

Use when the user asks to establish shared project language, or project work exposes a conflicting, renamed, or deprecated domain term that needs active semantic modeling. Routine small tasks stay on the fast path.

Install

Use when executing a written implementation plan across sessions or with review checkpoints. Small or single-slice plans stay inline. For same-session independent tasks, use subagent-driven-development instead.

Install

Use when verified work needs integration or cleanup of an existing task-created branch/worktree, or the user explicitly requests merge, PR, or branch lifecycle handling.

Install

Use when asked for first-principles or Occam's-razor review, or when high-risk decisions involve competing constraints, fallback growth, duplicate owners, or architecture direction risk. Ordinary bug fixes stay on the fast path.

Install

Use when the user explicitly sets an Aegis goal with /aegis-goal, Aegis goal:, or asks to define goal, success evidence, stop condition, or task boundaries before work.

Install

Use when a task is multi-step, may span context resets or sessions, uses subagents, or risks losing state before completion.

Install

Use when receiving code review feedback before implementing suggestions, especially when feedback is unclear, risky, disputed, or technically questionable.

Install

Use when the user asks to create, write, update, amend, supersede, or evaluate an ADR, architecture decision record, durable architecture decision, decision log, or baseline sync after architecture-changing work.

Install

Use when requesting independent code review, after implementation slices, before merging high-risk work, or when verification exposes evidence, baseline, architecture, compatibility, or retirement uncertainty.

Install

Use when executing a written implementation plan with independent tasks in the current session where delegation beats inline coordination cost; otherwise inline. Ad-hoc 2+ tasks without a plan use dispatching-parallel-agents.

Install

Use when encountering a bug, test failure, or unexpected behavior, before proposing fixes

Install

Use when the user explicitly requests strict or test-first TDD, or when the current conversation already contains an explicit `TDD Route: strict` decision from another Aegis workflow.

Install

Use when the user says `aegis:update`, asks to update or upgrade an installed Aegis method-pack, wants the latest Aegis version, or asks whether Aegis is current on this host.

Install

Use when starting a turn or checking Aegis skill routing.

Install

Use when a coding task needs a concurrent checkout, unrelated dirty state blocks safe branch switching, or the user or repository explicitly requires a worktree.

Install

Use when about to claim work is complete, fixed, passing, verified, release-ready, or ready to commit, merge, publish, or hand off.

Install
Use cases

Subagents overview

README preview not available. Visit the repo on GitHub for full documentation.
agent-skillsai-agentsai-codingarchitecture-driven-developmentawsome-coding-pluginbaseline-firstclaude-codecodexcoding-agentsdivedsh-pluginevidence-drivenfirst-principlesopencodesoftware-architecturespec-driven-developmentspec-kit

What people ask about Aegis

What is GanyuanRan/Aegis?

+

GanyuanRan/Aegis is subagents for the Claude AI ecosystem. Make AI coding agents architecture-aware: baseline-first, evidence-verified, drift-checked, and safe across long tasks. It has 1.2k GitHub stars and its last recorded update is dated 2026-09-10.

How do I install Aegis?

+

You can install Aegis by cloning the repository (https://github.com/GanyuanRan/Aegis) or following the README instructions on GitHub. ClaudeWave also provides quick install blocks on this page.

Is GanyuanRan/Aegis safe to use?

+

Our security agent has analyzed GanyuanRan/Aegis and assigned a Trust Score of 92/100 (tier: Verified). See the full breakdown of passed checks and flags on this page.

Who maintains GanyuanRan/Aegis?

+

GanyuanRan/Aegis is maintained by GanyuanRan. The last recorded GitHub activity is dated 2026-09-10, with 1 open issues.

Are there alternatives to Aegis?

+

Yes. On ClaudeWave you can browse similar subagents at /categories/agents, sorted by popularity or recent activity.

Deploy Aegis to your cloud

Ship this repo to production in minutes. Each platform spins up its own environment with editable env vars.

Maintain this repo? Add a badge to your README

Drop the badge into your GitHub README to show it's tracked on ClaudeWave. Each badge links back to this page and reflects the live Trust Score.

Featured on ClaudeWave: GanyuanRan/Aegis
[![Featured on ClaudeWave](https://claudewave.com/api/badge/ganyuanran-aegis)](https://claudewave.com/repo/ganyuanran-aegis)
<a href="https://claudewave.com/repo/ganyuanran-aegis"><img src="https://claudewave.com/api/badge/ganyuanran-aegis" alt="Featured on ClaudeWave: GanyuanRan/Aegis" width="320" height="64" /></a>

More Subagents