mediumpublishabilitypublishability.link.missing.websiteURL
websiteURL should be present for marketplace readiness.
Aegis
Make AI coding agents architecture-aware: baseline-first, evidence-verified.
AI coding agents guess, break architecture, and say "done" with no proof. Aegis is a Method Pack (runtime-ready, not a runtime core) that makes agents work like disciplined engineers: baseline-first planning, verification-before-completion, plus TDD, systematic-debugging, and collaboration workflows. Simple tasks stay on fast-path, ceremony only when needed. One pack, every host: Codex, Claude Code, OpenCode, Kimi and other skill-aware hosts. v2.9.6 fixes Codex 0.147 frozen skill-path spellings and binds delegated work back to baseline/checkpoint instead of trusting child output. Bounded evidence: frozen A/B benchmark contract pass 61.67% → 93.33%, unsafe 13.33% → 0%. Advisory only, not completion authority.
aegis-maintainers/aegis · v2.12.1 · Development & Workflow
Aegis MaintainersOwner verifiedcaution
Trust Score
62
Security
59
Surfaces
23
v2.9.6 Live launch
Make AI coding agents architecture-aware: baseline-first, evidence-verified.
- Launched
- Sep 4, 2026
- Pricing
- free
- Availability
- available
What is Aegis?
Aegis is a published development & workflow plugin for AI coding agents in the codex ecosystem, developed by Aegis Maintainers and distributed through the HOL AI plugin registry. An agentic skills framework & software development methodology that works: planning, TDD, debugging, and collaboration workflows.
- Canonical slug
- aegis-maintainers/aegis
- Version
- v2.12.1 · updated Oct 3, 2026
- Open data
- entity.json (JSON-LD)
Trust & Reputation
HOL Trust Score
62
Factor Analysis
Per-metric points (0–100 each) combined via a weighted average into the overall score.
Installability
64ptsMaintenance
80ptsMCP Posture
100ptsPlugin Security
59ptsProvenance
70ptsPublisher Quality
75ptsRegistry Snapshot
- Repository
- https://github.com/GanyuanRan/Aegis
- Canonical profile
- https://hol.org/registry/plugins/aegis-maintainers%2Faegis
- Publisher verification
- No
- Marketplace source
- Unknown
- Scanner
- Broker fallback
- Safety label
- caution
- Digest verified
- Yes
Trust & reputation
Trust & Reputation
HOL Trust Score
62
Factor Analysis
Per-metric points (0–100 each) combined via a weighted average into the overall score.
Installability
64ptsMaintenance
80ptsMCP Posture
100ptsPlugin Security
59ptsProvenance
70ptsPublisher Quality
75ptsProvenance
- Plugin root
- .
- Source repo
- https://github.com/GanyuanRan/Aegis
- Source commit
- 4edf34e6441b…
- Publisher verified
- No
- Owner verified
- @GanyuanRan
Continuous scanner CI not detected
This plugin remains listed. Its overall trust score is reduced by 10% because security checks are not maintained in the source repository's CI.
Optional: maintain the scanner in the source repository's CI to receive the full trust score. Listing does not require that change.
Verified badge not detected
Add the HOL verified badge to the repository README to score +2% trust. Plugin owners can open that pull request from Guard Plugins.
Security Posture
caution
Safety label
59
Security score
0
High findings
- Provider
- registry-broker-fallback
- Grade
- F · caution
- Version
- Unknown
cisco-skill-scanner: unknown
Findings
mediumpublishabilitypublishability.link.missing.privacyPolicyURL
privacyPolicyURL should be present for marketplace readiness.
mediumpublishabilitypublishability.link.missing.termsOfServiceURL
termsOfServiceURL should be present for marketplace readiness.
lowoperational-securitysupply-chain.lockfile-missing
Repository snapshot does not include a lockfile.
infoskill-securityskill-scan.unavailable
Cisco skill scanner timed out after 60000 ms
infoskill-securityskill-scan.unavailable
Cisco skill scanner timed out after 60000 ms
infoskill-securityskill-scan.unavailable
Cisco skill scanner timed out after 60000 ms
infoskill-securityskill-scan.unavailable
Cisco skill scanner timed out after 60000 ms
infoskill-securityskill-scan.unavailable
Cisco skill scanner timed out after 60000 ms
infoskill-securityskill-scan.unavailable
Cisco skill scanner timed out after 60000 ms
infoskill-securityskill-scan.unavailable
Cisco skill scanner timed out after 60000 ms
infoskill-securityskill-scan.unavailable
Cisco skill scanner timed out after 60000 ms
infoskill-securityskill-scan.unavailable
Cisco skill scanner timed out after 60000 ms
infoskill-securityskill-scan.unavailable
Cisco skill scanner timed out after 60000 ms
infoskill-securityskill-scan.unavailable
Cisco skill scanner timed out after 60000 ms
infoskill-securityskill-scan.unavailable
Cisco skill scanner timed out after 60000 ms
infoskill-securityskill-scan.unavailable
Cisco skill scanner timed out after 60000 ms
infoskill-securityskill-scan.unavailable
Cisco skill scanner timed out after 60000 ms
infoskill-securityskill-scan.unavailable
Cisco skill scanner timed out after 60000 ms
infoskill-securityskill-scan.unavailable
Cisco skill scanner timed out after 60000 ms
infoskill-securityskill-scan.unavailable
Cisco skill scanner timed out after 60000 ms
infoskill-securityskill-scan.unavailable
Cisco skill scanner timed out after 60000 ms
infoskill-securityskill-scan.unavailable
Cisco skill scanner timed out after 60000 ms
infoskill-securityskill-scan.unavailable
Cisco skill scanner timed out after 60000 ms
infoskill-securityskill-scan.unavailable
Cisco skill scanner timed out after 60000 ms
infoskill-securityskill-scan.unavailable
Cisco skill scanner timed out after 60000 ms
infoskill-securityskill-scan.unavailable
Cisco skill scanner timed out after 60000 ms
Aegis — Frequently asked questions
- What is Aegis?
- Aegis is an AI plugin in the HOL registry. AI coding agents guess, break architecture, and say "done" with no proof. Aegis is a Method Pack (runtime-ready, not a runtime core) that makes agents work like disciplined engineers: baseline-first planning, verification-before-completion, plus TDD, systematic-debugging,…
- How do I install Aegis?
- Install Aegis in your harness: Codex — codex plugin marketplace add GanyuanRan/Aegis; Claude Code — /plugin marketplace add GanyuanRan/Aegis; Cursor — npx skills add GanyuanRan/Aegis. Full step-by-step guidance is on the HOL plugin page.
- How do I install Aegis in Codex?
- To install Aegis in Codex, start with codex plugin marketplace add GanyuanRan/Aegis. The complete step-by-step install guide for Codex is on the HOL plugin page.
- How do I install Aegis in Claude Code?
- To install Aegis in Claude Code, start with /plugin marketplace add GanyuanRan/Aegis. The complete step-by-step install guide for Claude Code is on the HOL plugin page.
- How do I install Aegis in Cursor?
- To install Aegis in Cursor, start with npx skills add GanyuanRan/Aegis. The complete step-by-step install guide for Cursor is on the HOL plugin page.
- Is Aegis free?
- Aegis is listed as free on HOL.
- Who publishes Aegis?
- Aegis is published by Aegis Maintainers and listed on HOL.
- Is Aegis available now?
- Aegis is currently available according to its latest public launch.
Install Guidance
Install in Claude Code
Install through the Claude Code plugin marketplace.
- 1
Add the marketplace
Run this inside a Claude Code session.
claude code - 2
Install the plugin
Use the plugin name and the marketplace name shown by the previous command.
claude code - 3
Scripted alternative
Non-interactive equivalent for scripts and CI pipelines. Add --scope project to pin the install to one repository.
shell
1 / 2
01 cover 1270x760
Plugin Manifest
{
"name": "aegis",
"version": "2.12.1",
"description": "An agentic skills framework & software development methodology that works: planning, TDD, debugging, and collaboration workflows.",
"author": {
"name": "Aegis Maintainers",
"url": "https://github.com/GanyuanRan/Aegis"
},
"homepage": "https://github.com/GanyuanRan/Aegis",
"repository": "https://github.com/GanyuanRan/Aegis",
"license": "MIT",
"keywords": [
"brainstorming",
"first-principles",
"subagent-driven-development",
"skills",
"planning",
"tdd",
"debugging",
"code-review",
"workflow"
],
"skills": "./",
"interface": {
"displayName": "Aegis",
"developerName": "Aegis Maintainers",
"shortDescription": "Planning, TDD, debugging, and delivery workflows for coding agents",
"longDescription": "Use Aegis to guide agent work through first-principles review, brainstorming, implementation planning, test-driven development, systematic debugging, parallel execution, code review, and finish-the-branch workflows.",
"category": "Coding",
"capabilities": [
"Interactive",
"Read",
"Write"
],
"defaultPrompt": [
"I've got an idea for something I'd like to build.",
"Let's add a feature to this project."
],
"brandColor": "#F59E0B",
"composerIcon": "./assets/aegis-small.svg",
"logo": "./assets/app-icon.png",
"screenshots": []
},
"registryIndexVersion": 5
}Marketplace Source
- Repo URL
- https://github.com/GanyuanRan/Aegis
- Marketplace path
- Unknown
- Source path
- plugins/GanyuanRan/Aegis
- Install policy
- AVAILABLE
Skills
23 SKILL.md files ship with this plugin. Preview, copy, or download each one, then install them with the Skills CLI.
skills-cli
anti-entropy-governance
skills/anti-entropy-governance/SKILL.md
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.
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
brainstorming
skills/brainstorming/SKILL.md
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.
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
communicating-concisely
skills/communicating-concisely/SKILL.md
Use when the user asks for caveman mode, fewer tokens, brief responses, compressed communication, or otherwise explicitly requests a much shorter answer.
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
dispatching-parallel-agents
skills/dispatching-parallel-agents/SKILL.md
Use when facing 2+ independent tasks without a written plan, with no conflicting shared mutable state or sequential dependencies, where parallel delegation beats inline cost; otherwise inline. Planned tasks use subagent-driven-development.
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
establishing-project-context
skills/establishing-project-context/SKILL.md
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.
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
executing-plans
skills/executing-plans/SKILL.md
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.
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
finishing-a-development-branch
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 requests merge, PR, or branch lifecycle handling.
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
first-principles-review
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, fallback growth, duplicate owners, or architecture direction risk. Ordinary bug fixes stay on the fast path.
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
goal-framing
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 evidence, stop condition, or task boundaries before work.
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
long-task-continuation
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 completion.
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
receiving-code-review
skills/receiving-code-review/SKILL.md
Use when receiving code review feedback before implementing suggestions, especially when feedback is unclear, risky, disputed, or technically questionable.
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
recording-architecture-decisions
skills/recording-architecture-decisions/SKILL.md
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.
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
requesting-code-review
skills/requesting-code-review/SKILL.md
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.
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
subagent-driven-development
skills/subagent-driven-development/SKILL.md
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.
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
systematic-debugging
skills/systematic-debugging/SKILL.md
Use when encountering a bug, test failure, or unexpected behavior, before proposing fixes
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
test-driven-development
skills/test-driven-development/SKILL.md
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.
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
ui-ux-governance
skills/ui-ux-governance/SKILL.md
Use when designing, changing, or reviewing user-facing interfaces or interaction flows, including API changes that alter visible states or recovery. Backend-only work without user-facing effects stays on its existing route.
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
update-aegis
skills/update-aegis/SKILL.md
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.
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
using-aegis
skills/using-aegis/SKILL.md
Use when starting a turn or checking Aegis skill routing.
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
using-git-worktrees
skills/using-git-worktrees/SKILL.md
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.
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
verification-before-completion
skills/verification-before-completion/SKILL.md
Use when about to claim work is complete, fixed, passing, verified, release-ready, or ready to commit, merge, publish, or hand off.
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
writing-plans
skills/writing-plans/SKILL.md
Use when you have an approved spec or written requirements for a multi-step task that needs a durable plan document before touching code. Small, single-owner, or fast-path tasks do not need this skill.
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
writing-skills
skills/writing-skills/SKILL.md
Use when creating new skills, editing existing skills, or verifying skills work before deployment
SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.
File Inventory
.claude-plugin/plugin.json
file
465 bytes
f9365e447d970c1e…
.codex-plugin/plugin.json
plugin-manifest
1,243 bytes
19fbad244a3b0ef5…
.cursor-plugin/plugin.json
file
569 bytes
1d028a1f2aa8c7b3…
.opencode/plugins/aegis.js
file
22,750 bytes
95de590ac420aed0…
AGENTS.md
file
5,489 bytes
892cb64cdc864ba1…
assets/aegis-small.svg
asset
1,733 bytes
54a632d9ee6197cc…
assets/app-icon.png
asset
64,308 bytes
2f9c36e0d13d28e0…
CLAUDE.md
file
6,539 bytes
a0f52b5dab1c4e3a…
commands/brainstorm.md
file
250 bytes
6bda2e441a358e90…
commands/execute-plan.md
file
254 bytes
062cf455d50d7976…
commands/write-plan.md
file
250 bytes
947dcf1a23a72a58…
hooks/hooks-cursor.json
file
124 bytes
7ea8854c2b2b1ab2…
hooks/hooks.json
file
305 bytes
01616c57b96cc234…
kimi.plugin.json
file
689 bytes
9059870549b19019…
package.json
file
900 bytes
09c5572cd186cc95…
README.md
file
18,217 bytes
ca42ee9d1ebf5d2b…
SECURITY.md
file
1,971 bytes
c260d18f16cee3b2…
skills/anti-entropy-governance/SKILL.md
skill
12,412 bytes
1d2f4d7c2c0c14b9…
skills/brainstorming/expanded-design-guidance.md
skill
9,630 bytes
949b61283b13e006…
skills/brainstorming/SKILL.md
skill
24,757 bytes
2d6739b6c90b72fd…
skills/brainstorming/spec-document-reviewer-prompt.md
skill
1,742 bytes
62d38ea2cda36ba1…
skills/communicating-concisely/SKILL.md
skill
2,227 bytes
d6ce712599567b58…
skills/dispatching-parallel-agents/SKILL.md
skill
3,886 bytes
daa68bc5e66cee51…
skills/establishing-project-context/CONTEXT-FORMAT.md
skill
2,227 bytes
a86caaf84cbe6ffa…
skills/establishing-project-context/SKILL.md
skill
5,826 bytes
9988bbfaa48a266a…
skills/executing-plans/SKILL.md
skill
9,144 bytes
5316a447ec89bc1d…
skills/finishing-a-development-branch/SKILL.md
skill
5,222 bytes
995a2a17fdb5dc33…
skills/first-principles-review/SKILL.md
skill
9,940 bytes
6ca49ee3e0bd44e9…
skills/goal-framing/SKILL.md
skill
4,646 bytes
24208ea7e3d6382a…
skills/long-task-continuation/durable-work-guidance.md
skill
5,783 bytes
7c32cee07594c332…
skills/long-task-continuation/SKILL.md
skill
9,375 bytes
6c69ea53dbe5520a…
skills/receiving-code-review/SKILL.md
skill
6,237 bytes
7003bc2c29925aca…
skills/recording-architecture-decisions/SKILL.md
skill
5,934 bytes
188c327973056ff7…
skills/requesting-code-review/code-reviewer.md
skill
7,416 bytes
2ea284345814009f…
skills/requesting-code-review/SKILL.md
skill
8,840 bytes
33a8f9a07a964b53…
skills/subagent-driven-development/code-quality-reviewer-prompt.md
skill
1,284 bytes
da05923f5e9d389c…
skills/subagent-driven-development/implementer-prompt.md
skill
5,451 bytes
b7e084474331f1fd…
skills/subagent-driven-development/SKILL.md
skill
9,090 bytes
0d7c1a36d5d01806…
skills/subagent-driven-development/spec-reviewer-prompt.md
skill
2,156 bytes
06e7063ddf213906…
skills/systematic-debugging/advanced-debugging-governance.md
skill
8,553 bytes
02b4a75dea4d461b…
skills/systematic-debugging/condition-based-waiting-example.ts
skill
5,054 bytes
40ae5ebe497fdf31…
skills/systematic-debugging/condition-based-waiting.md
skill
3,516 bytes
e89fec8400d6cd50…
skills/systematic-debugging/defense-in-depth.md
skill
3,650 bytes
1e175fb86fc357e5…
skills/systematic-debugging/feedback-loop-construction.md
skill
2,479 bytes
f94427a82eb59a31…
skills/systematic-debugging/find-polluter.sh
skill
1,528 bytes
6462747eae9b175a…
skills/systematic-debugging/root-cause-claim-contract.md
skill
13,870 bytes
4877b62fefebaad7…
skills/systematic-debugging/root-cause-tracing.md
skill
5,615 bytes
7d2710280e532394…
skills/systematic-debugging/SKILL.md
skill
11,089 bytes
d251d254da3f8170…
skills/test-driven-development/SKILL.md
skill
17,258 bytes
ad1bb364c87357ec…
skills/ui-ux-governance/references/experience-rules.md
skill
5,761 bytes
0cdd01b17777752a…
skills/ui-ux-governance/references/verification.md
skill
4,449 bytes
3d9f7796ec615fc8…
skills/ui-ux-governance/SKILL.md
skill
4,813 bytes
7d7e73fca9d08fa7…
skills/update-aegis/SKILL.md
skill
5,732 bytes
da3128e1b0aba188…
skills/using-aegis/references/antigravity-tools.md
skill
3,331 bytes
40d21668abf31c59…
skills/using-aegis/references/codex-tools.md
skill
8,377 bytes
94e13533ef405650…
skills/using-aegis/references/complexity-governance.md
skill
4,088 bytes
a21434d7806488ef…
skills/using-aegis/references/copilot-tools.md
skill
2,227 bytes
9f5d5c6c25448e84…
skills/using-aegis/references/skill-discipline.md
skill
11,131 bytes
025c56f6cdc4cbc1…
skills/using-aegis/SKILL.md
skill
2,794 bytes
bf282cec29ce9623…
skills/using-git-worktrees/SKILL.md
skill
7,779 bytes
23e832a61b1b5b23…
skills/verification-before-completion/expanded-closeout.md
skill
5,638 bytes
56f2c51fbed135e0…
skills/verification-before-completion/SKILL.md
skill
8,475 bytes
2fd48107ce3aa3ad…
skills/writing-plans/expanded-planning-guidance.md
skill
6,855 bytes
3ecbd22e98264283…
skills/writing-plans/plan-document-reviewer-prompt.md
skill
1,714 bytes
6fce2aa83c637156…
skills/writing-plans/SKILL.md
skill
13,149 bytes
491529dbd918cd8d…
skills/writing-skills/SKILL.md
skill
5,315 bytes
9e74b7e83faacbd2…
skills/writing-skills/testing-skills-with-subagents.md
skill
2,801 bytes
bc346e0a62eddfb6…
History, reviews, and alternatives
Launch history
User reviews
—from 0 reviews
The first substantive review can be added on this page.
Read or write reviewsMilestones and alternatives
Makers can publish releases and security milestones after claiming the plugin.