aegis-dev
Development marketplace for Aegis method-pack skills library
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/ganyuanran--aegis)HTML
<a href="/listings/ganyuanran--aegis"><img src="/api/listings/ganyuanran--aegis/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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 <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 `<aegis-method-pack-root>`, then run `cd <aegis-method-pack-root> && 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 <path>`; if the host guide declares a skill directory name prefix, also pass `--discovery-name-prefix <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.
DeepSeek Harness also supports the official npm package `@ganyuan_ran/aegis`. Choose one channel per profile; see the [DSH installation, update and migration guide](docs/README.deepseek-harness.md#updating). The prompt above selects Git; npm installations use the scoped package name.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 18 lines
- {
- "name": "aegis-dev",
- "description": "Development marketplace for Aegis method-pack skills library",
- "owner": {
- "name": "Aegis Maintainers"
- },
- "plugins": [
- {
- "name": "aegis",
- "description": "Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques",
- "version": "2.15.2",
- "source": "./",
- "author": {
- "name": "Aegis Maintainers"
- }
- }
- ]
- }
README.md · README · 305 lines
- <p align="center">
- <a href="https://linux.do/t/topic/2108966/20" alt="LINUX DO">
- <img
- src="https://img.shields.io/badge/LINUX-DO-FFB003.svg?logo=data:image/svg%2bxml;base64,DQo8c3ZnIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAiIHdpZHRoPSIxMDAiIGhlaWdodD0iMTAwIj48cGF0aCBkPSJNNjguMi0uMDU1aDYuMjVxMjMuOTY5IDIuMDYyIDM4IDIxLjQyNmM1LjI1OCA3LjY3NiA4LjIxNSAxNi4xNTYgOC44NzUgMjUuNDV2Ni4yNXEtMi4wNjQtMjMuOTY4LTIxLjQzIDM4LTExLjUxMiA3Ljg4NS0yNS40NDUgOC44NzRoLTYuMjVxLTIzLjk3LTIuMDY0LTM4LjAwNC0yMS40M1EuOTcxIDY3LjA1Ni0uMDU0IDUzLjE4di02LjQ3M0MxLjM2MiAzMC43ODEgOC41MDMgMTguMTQ4IDIxLjM3IDguODE3IDI5LjA0NyAzLjU2MiAzNy41MjcuNjA0IDQ2LjgyMS0uMDU2IiBzdHlsZT0ic3Ryb2tlOm5vbmU7ZmlsbC1ydWxlOmV2ZW5vZGQ7ZmlsbDojZWNlY2VjO2ZpbGwtb3BhY2l0eToxIi8+PHBhdGggZD0iTTQ3LjI2NiAyLjk1N3EyMi41My0uNjUgMzcuNzc3IDE1LjczOGE0OS43IDQ5LjcgMCAwIDEgNi44NjcgMTAuMTU3cS00MS45NjQuMjIyLTgzLjkzIDAgOS43NS0xOC42MTYgMzAuMDI0LTI0LjM4N2E2MSA2MSAwIDAgMSA5LjI2Mi0xLjUwOCIgc3R5bGU9InN0cm9rZTpub25lO2ZpbGwtcnVsZTpldmVub2RkO2ZpbGw6IzE5MTkxOTtmaWxsLW9wYWNpdHk6MSIvPjxwYXRoIGQ9Ik03Ljk4IDcwLjkyNmMyNy45NzctLjAzNSA1NS45NTQgMCA4My45My4xMTNRODMuNDI2IDg3LjQ3MyA2Ni4xMyA5NC4wODZxLTE4LjgxIDYuNTQ0LTM2LjgzMi0xLjg5OC0xNC4yMDMtNy4wOS0yMS4zMTctMjEuMjYyIiBzdHlsZT0ic3Ryb2tlOm5vbmU7ZmlsbC1ydWxlOmV2ZW5vZGQ7ZmlsbDojZjlhZjAwO2ZpbGwtb3BhY2l0eToxIi8+PC9zdmc+" /></a>
- <a href="https://dev.to/_879c5a0279451d52e43c3/aegis-a-method-pack-for-more-reliable-ai-coding-agents-1gfm" alt="DEV.to">
- <img src="https://img.shields.io/badge/DEV.to-Article-0A0A0A?logo=devdotto&logoColor=white" /></a>
- <a href="https://github.com/GanyuanRan/Aegis/actions/workflows/ci.yml" alt="CI">
- <img src="https://img.shields.io/github/actions/workflow/status/GanyuanRan/Aegis/ci.yml?branch=main&label=CI" /></a>
- <a href="https://github.com/GanyuanRan/Aegis/releases/latest" alt="Latest Release">
- <img src="https://badgen.net/github/release/GanyuanRan/Aegis?label=Latest%20Release" /></a>
- <a href="https://github.com/GanyuanRan/Aegis" alt="GitHub Stars">
- <img src="https://img.shields.io/github/stars/GanyuanRan/Aegis?style=flat&label=Stars" /></a>
- <a href="https://atomgit.com/GanyuanRan/Aegis" alt="AtomGit Stars">
- <img src="https://atomgit.com/GanyuanRan/Aegis/star/badge.svg" alt="AtomGit Stars" /></a>
- <a href="https://olud.ai/project/ganyuanran-aegis.html" alt="Aegis on olud.ai">
- <img src="https://olud.ai/badge.php?tool=ganyuanran-aegis" alt="Aegis on olud.ai" /></a>
- </p>
- <p align="center">
- <img src="assets/aegis-hero.png" alt="Aegis architecture-driven AI coding agent hero banner" />
- </p>
- # Aegis
- <p align="center">
- <strong>Aegis Method Pack</strong><br/>
- Make your AI coding agent trustworthy: fewer reworks, safer changes, proof before "done".
- </p>
- <p align="center">
- <a href="README.md"><strong>English</strong></a>
- ·
- <a href="README.zh-CN.md"><strong>中文</strong></a>
- ·
- <a href="docs/current/AEGIS_FAST_TRACK_PLAYBOOK.md">Fast-Track Playbook</a>
- ·
- <a href="docs/current/AEGIS_FAST_TRACK_PLAYBOOK_ZH.md">速通秘籍</a>
- </p>
- > **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](skills/ui-ux-governance/SKILL.md)
- 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](#measured-agentic-benchmark).
- ## 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:
- ```text
- 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 <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 `<aegis-method-pack-root>`, then run `cd <aegis-method-pack-root> && 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 <path>`; if the host guide declares a skill directory name prefix, also pass `--discovery-name-prefix <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.
- ```
- DeepSeek Harness also supports the official npm package `@ganyuan_ran/aegis`.
- Choose one channel per profile; see the [DSH installation, update and migration guide](docs/README.deepseek-harness.md#updating).
- The prompt above selects Git; npm installations use the scoped package name.
- ## Measured Agentic Benchmark
- A frozen held-out A/B benchmark for Aegis 2.7.6 (2026-08-11) kept the Codex client, prompts, projects, tool policy, and requested the same `gpt-5.6-sol` / `xhigh` setting in both arms; only the Aegis projection differed. Across 120 valid runs on 20 cases,
- contract pass rate was **61.67% → 93.33% (+31.67 pp)** and unsafe outcomes were **13.33% → 0%**. The 95% case-cluster interval was **+15.00 pp to +50.00 pp**. This is bounded advisory evidence; review was arm-hidden technical review, not independent human review, and host events did not return the observed model identity.
- 
- [Sanitized JSON](benchmarks/results/gpt-5-6-sol-xhigh-extended-20260811-v2-7-6.json) · [English table](benchmarks/results/gpt-5-6-sol-xhigh-extended-20260811-v2-7-6.en.md) · [中文表格](benchmarks/results/gpt-5-6-sol-xhigh-extended-20260811-v2-7-6.zh-CN.md) · [Methodology](docs/current/AEGIS_AGENTIC_BENCHMARK_BASELINE.md)
- A newer [matrix-v7 standard snapshot for Aegis 2.10.8](benchmarks/results/gpt-5-6-sol-xhigh-standard-20260925-v2-10-8.en.md)
- covers 22 cases with one observation per arm and case. It uses a different run
- profile from the extended snapshot above and does not measure the changes in
- this release.
- ## Try Aegis Methods in a Coding Runtime
- [Autoloom](https://github.com/GanyuanRan/Autoloom) is our AI coding desktop
- client. It brings Aegis's change necessity analysis, complexity governance, and
- delivery review into development execution, helping you spend less time
- repeating instructions and inspect the evidence behind delivered changes.
- Currently available as a **Windows x64 Alpha**. The client is free; choose your
- model provider, which bills model usage separately.
- **[Explore Autoloom](https://github.com/GanyuanRan/Autoloom) ·
- [Download Alpha](https://github.com/GanyuanRan/Autoloom/releases)**
- ## Updating Aegis
- After a complete install has registered the current host, later updates can use
- natural language such as `update Aegis` or the explicit skill request
- `aegis:update`. The agent can route either form through the local update path:
- locate the installed method-pack root, use the host-scoped registry, and call
- `scripts/aegis-update.py` for the current host by default. Updating every
- registered host requires an explicit `--all` request. Aegis does not run
- background automatic updates by default.
- For DSH profile-managed bundles, use the host plugin manager instead of
- `scripts/aegis-update.py`: Git uses `aegis`, npm uses `@ganyuan_ran/aegis`.
- Follow the [channel-specific update steps](docs/README.deepseek-harness.md#updating)
- and verify the installed version after restarting the intended profile.
- ## Before You Use It
- Aegis is currently:
- > `Aegis Method Pack (runtime-ready)`
- It is **not** the full Aegis Platform, a daemon, a background runner, a runtime
- core, an authoritative `GateDecision`, an authoritative `PolicySnapshot`, or
- final completion authority. User instructions and target-project rules outrank
- Aegis guidance.
- The [global routing prefix](GLOBAL_USER_RULES_TEMPLATE.md) is an optional,
- manually copied host/profile projection. It does not install Aegis or prove
- skill discovery. If the host already has reliable Aegis bootstrap and routing,
- no extra global rule is usually needed. Otherwise, add the prefix at the very
- beginning of the existing global user rules without changing unrelated
- content.
- This copied prefix is not managed by `aegis:update`. Users who previously
- copied the retired Lite / Advanced profiles should replace only those old
- Aegis blocks with the unified prefix. The prefix follows the host or session
- activation mode, defaults to `auto` when none is declared, and leaves detailed
- workflow governance to the loaded Aegis skills. Host-native skill matching may
- still remain host-controlled.
- Activation mode defaults to automatic. To switch to explicit mode, run this
- from the installed method-pack root:
- ```bash
- cd <aegis-method-pack-root>
- python scripts/aegis-doctor.py activation-mode explicit
- ```
- Restart the host after changing activation mode. Details and host caveats live
- in [docs/current/AEGIS_ACTIVATION_MODE.md](docs/current/AEGIS_ACTIVATION_MODE.md).
- TDD mode defaults to `off`: Aegis does not automatically require TDD, and
- completion verification still applies. To enable automatic TDD routing when you
- want Aegis to choose strict, light, or skipped by task risk:
- ```bash
- cd <aegis-method-pack-root>
- python scripts/aegis-doctor.py tdd-mode auto
- ```
- You can also request strict TDD directly in a query with explicit markers such
- as `TDD Route: strict`, `strict TDD`, `test-first`, or
- `RED / GREEN / REFACTOR`.
- Details live in [docs/current/AEGIS_TDD_MODE.md](docs/current/AEGIS_TDD_MODE.md).
- ## Supported Hosts
- Aegis keeps a multi-host, plugin-installable distribution goal.
- | Host group | Current status | Start here |
- | --- | --- | --- |
- | `Codex`, `OpenCode` | Fresh evidence exists for the current method-pack scope | [Codex](docs/README.codex.md), [OpenCode](docs/README.opencode.md) |
- | `Claude Code`, `CodeBuddy`, `DeepSeek-TUI`, `DeepSeek Harness`, `Trae`, `GitHub Copilot`, `Qoder`, `Kimi Code CLI`, `ZCode`, `Grok Build` | Install guides exist; release-level fresh host smoke is still pending | [Claude Code](docs/README.claude-code.md), [CodeBuddy](docs/README.codebuddy.md), [DeepSeek-TUI](docs/README.deepseek-tui.md), [DeepSeek Harness](docs/README.deepseek-harness.md), [Trae](docs/README.trae.md), [GitHub Copilot](docs/README.copilot.md), [Qoder](docs/README.qoder.md), [Kimi Code CLI](docs/README.kimi-code.md), [ZCode](docs/README.zcode.md), [Grok Build](docs/README.grok-build.md) |
- | `CC GUI (JetBrains IDEA)` | Structural IDE plugin layer support for Claude Code / OpenAI-GPT provider paths; release-level fresh host smoke is still pending | [CC GUI](docs/README.cc-gui.md) |
- | `Antigravity CLI`, `Antigravity IDE`, `Antigravity App` | `Antigravity CLI` has installation and structural discovery evidence; live Aegis skill loading, task routing, and session refresh remain pending verification; `IDE/App` remain structural targets | [Antigravity](docs/README.antigravity.md) |
- | `Pi CLI`, `OMP`, `OpenClaw`, `Hermes Agent` | Structural Agent Skills / `SKILL.md` skill-host adaptations; release-level fresh host smoke is still pending | [Pi CLI](docs/README.pi.md), [OMP](docs/README.omp.md), [OpenClaw](docs/README.openclaw.md), [Hermes Agent](docs/README.hermes-agent.md) |
- | `Gemini CLI` | Retired; Aegis no longer ships or verifies a Gemini CLI adapter | [Compatibility Matrix](docs/current/AEGIS_HOST_COMPATIBILITY_MATRIX_SNAPSHOT.md) |
- Read the current host verdict before making support claims:
- - [Host compatibility matrix](docs/current/AEGIS_HOST_COMPATIBILITY_MATRIX_SNAPSHOT.md)
- - [Known limitations](docs/current/AEGIS_KNOWN_LIMITATIONS.md)
- ## Start Fast With Aegis
- After installation and host restart, use normal language. Aegis matches the
- method to the work; name a mode directly when you want less ambiguity.
- ```text
- Why does this login failure happen? Diagnose it before changing code.
- Grill me on whether we should ship a hosted version first.
- Aegis goal: Fix the auth refresh bug without rewriting the auth system.
- Review this diff independently before I merge it.
- ```
- Read the [Fast-Track Playbook](docs/current/AEGIS_FAST_TRACK_PLAYBOOK.md) for
- Aegis's lightweight operating model, how it differs from standalone skill
- packs, its five engineering moats, project workspace lifecycle, natural trigger
- phrases, controls, and troubleshooting. The Chinese version is
- [Aegis 速通秘籍](docs/current/AEGIS_FAST_TRACK_PLAYBOOK_ZH.md).
- Use these explicit requests when you need tighter control:
- - `Aegis goal: ...` frames scope, success evidence, and boundaries.
- - `Grill me ...` or `审问我 ...` starts a decision interview; it asks one
- decision question at a time and does not plan or implement.
- - `TDD Route: strict`, `strict TDD`, or `test-first` explicitly requests
- strict test-first work. TDD is otherwise `off` by default.
- - `aegis:first-principles-review` or `review this from first principles`
- pressure-tests a complex direction before implementation.
- - `aegis:update` updates the installed method pack through its host-aware path.
- For non-trivial project work, Aegis can passively reuse relevant canonical
- language from `CONTEXT.md` or a bounded context selected by `CONTEXT-MAP.md`.
- It activates domain modeling only when a term is resolved, ambiguous, renamed,
- deprecated, or conflicting. High-confidence existing facts may synchronize
- directly; unresolved domain decisions remain user-owned. Files are created
- lazily on the first resolved term and remain glossary-only. Stable bytes can be
- cache-friendly, but Aegis does not guarantee provider cache hits or savings.
- Aegis preserves Workflow Quality by keeping simple work light and expanding
- only when risk warrants it. For deeper method detail, read the
- [Workflow Guide](docs/current/AEGIS_WORKFLOW_GUIDE.md),
- [Workflow Quality Baseline](docs/current/AEGIS_WORKFLOW_QUALITY_BASELINE.md),
- [Complexity Governance Baseline](docs/current/AEGIS_COMPLEXITY_GOVERNANCE_BASELINE.md),
- and [TDD mode](docs/current/AEGIS_TDD_MODE.md).
- If a capability does not trigger as expected, use trigger-chain diagnosis:
- install/version visibility, host skill discovery, activation mode,
- `using-aegis` routing, task-to-skill matching, and context pressure. Read the
- [Trigger Health Baseline](docs/current/AEGIS_TRIGGER_HEALTH_BASELINE.md).
- ## For Maintainers
- Primary verification entry:
- ```bash
- bash tests/e2e/run-all.sh --full --host-profile fast
- ```
- Focused docs / method-pack checks:
- ```bash
- bash tests/e2e/boundary-compliance-check.sh
- bash tests/e2e/workflow-quality-check.sh
- bash tests/e2e/install-verification-policy-check.sh
- bash tests/e2e/layer1-fast-check.sh --host-profile none
- ```
- Read:
- - [docs/testing.md](docs/testing.md)
- - [Release checklist](docs/current/AEGIS_METHOD_PACK_RELEASE_CHECKLIST.md)
- - [Current authority map](docs/current/README.md)
- - [Contributing](CONTRIBUTING.md)
- ## Community & Extending
- - Feedback and discussion: [GitHub Discussions](https://github.com/GanyuanRan/Aegis/discussions) · [Issues](https://github.com/GanyuanRan/Aegis/issues) · [LINUX DO](https://linux.do/t/topic/2108966/20) · [DEV.to](https://dev.to/_879c5a0279451d52e43c3/aegis-a-method-pack-for-more-reliable-ai-coding-agents-1gfm)
- - Extend Aegis: write your own skill with `aegis:writing-skills`; see the [Workflow Guide](docs/current/AEGIS_WORKFLOW_GUIDE.md).
- - Follow along: [RELEASE-NOTES.md](RELEASE-NOTES.md) · [Releases](https://github.com/GanyuanRan/Aegis/releases)
- ## Aegis and Autoloom
- - **Aegis** is our open-source method pack for bringing engineering discipline
- to your existing AI coding host. It remains independently usable with
- multi-host support; Autoloom is not required.
- - **[Autoloom](https://github.com/GanyuanRan/Autoloom)** is our independent
- desktop product for experiencing Aegis's core methods in the coding runtime.
- Its client source code is not currently public. Its repository maintains
- downloads, release scope, and feedback.
- Autoloom carries the runtime-core direction while Aegis retains its method-pack
- boundary. The benchmarks on this page measure Aegis, not Autoloom. See the
- [product relationship](docs/current/AEGIS_PRODUCT_BASELINE.md#current-product-relationship-autoloom)
- for the boundary, or bring a scoped task to Autoloom and
- [share your experience](https://github.com/GanyuanRan/Autoloom/issues).
- ## Relationship To Superpowers
- Aegis is derived from **[Superpowers](https://github.com/obra/superpowers)**,
- created by [Jesse Vincent](https://github.com/obra). Superpowers pioneered
- composable, multi-harness agent skills. Aegis keeps that foundation and adds an
- architecture- and evidence-focused method layer for real software projects.
- Additional inspiration comes from
- [mattpocock/skills](https://github.com/mattpocock/skills), especially concise
- communication, shared language, and disciplined debugging patterns. These ideas
- were re-implemented in Aegis format rather than copied verbatim.
- ## License
- MIT License. See [LICENSE](LICENSE).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.