By ganyuanran
Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques
npx claudepluginhub ganyuanran/aegis --plugin aegisYou MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.
Use when the user asks for caveman mode, fewer tokens, brief responses, or compressed communication - drops filler words while keeping full technical accuracy, cutting token usage ~75%
Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies
Use when entering a project for the first time, or when the user asks to establish shared language, define domain terms, or create a project glossary - maintains CONTEXT.md as the project's ubiquitous language baseline
Use when you have a written implementation plan to execute in a separate session with review checkpoints
Use when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for merge, PR, or cleanup
Use when a task is multi-step, may span context resets or sessions, uses subagents, or risks losing state before completion - keeps todo, checkpoint, resume, drift, and evidence discipline without granting completion authority
Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation
Use when completing tasks, implementing major features, or before merging to verify work meets requirements
Use when executing implementation plans with independent tasks in the current session
Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes
Use when implementing any feature or bugfix, before writing implementation code
Use when starting any conversation - establishes compact Aegis skill-use discipline before any response, clarification, or action
Use when starting feature work that needs isolation from current workspace or before executing implementation plans - creates isolated git worktrees with smart directory selection and safety verification
Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always
Use when you have a spec or requirements for a multi-step task, before touching code
Use when creating new skills, editing existing skills, or verifying skills work before deployment
Harness for Claude Code — skills, /harness:* slash commands, persona subagents, lifecycle hooks, and MCP tools without per-repo `harness setup`. Sibling plugins exist for Cursor, Gemini CLI, and Codex.
23 agent skills for systematic software development. Covers design, planning, TDD, code review, debugging, quality gates, and adversarial testing. Every skill is eval-tested with measured A/B deltas using Anthropic's skill evaluation framework.
Analyze and enforce best practices for AI coding agent projects. Assess codebase readiness across 8 pillars with /readiness, then scaffold enforcement with /setup: TDD, secret scanning, file size limits, auto-generated docs, and git hooks.
Minimal AI coding agent team skills for the full engineering workflow: think, plan, review, test, audit, ship
24 agent definitions, 81 reusable skills, 28 lifecycle hooks for GitHub Copilot CLI workflows
The most comprehensive Claude Code plugin — 48 agents, 182 skills, 68 legacy command shims, selective install profiles, and production-ready hooks for TDD, security scanning, code review, and continuous learning
Uses power tools
Uses Bash, Write, or Edit tools
Share bugs, ideas, or general feedback.
Architecture-driven discipline for AI coding agents.
中文版本:README.zh-CN.md
If you are using an AI coding agent, you can ask it to install Aegis for you:
Please read the installation instructions in https://github.com/GanyuanRan/Aegis carefully, identify the correct path for my AI coding host, install Aegis globally, restart or reload the host if needed, and verify that the Aegis skills are discoverable.
If Aegis is already installed, you can ask your AI coding agent to update it for you:
Please update my installed Aegis to the latest main branch version from https://github.com/GanyuanRan/Aegis, using the correct update path for my current AI coding host, then restart or reload the host if needed and verify Aegis skills are discoverable.
Aegis defaults to automatic mode. To switch to manual mode, edit:
~/.config/aegis/config.toml
Windows:
%USERPROFILE%\.config\aegis\config.toml
If the file does not exist, create it manually. Add:
activation_mode = "explicit"
To return to automatic mode, set activation_mode = "auto" or delete the file.
Then restart the host. In explicit mode, supported bootstrap hooks stop
injecting Aegis automatically, while direct skill calls such as
aegis:using-aegis remain available. Host caveats are documented in
docs/current/AEGIS_ACTIVATION_MODE.md.
Aegis is an Architecture-Driven Development (ADD) method pack for AI coding agents.
It builds on the original superpowers methodology and adds evidence-driven governance, TLREF execution flow, and dual-track repair/retirement rules.
In Aegis, ADD means the agent should understand the project's baseline, architecture boundaries, owners, impact surface, compatibility constraints, and verification path before making substantial changes.
Current release shape:
Aegis Method Pack (runtime-ready)
This repository is not the full Aegis Platform. It does not provide authoritative runtime-core decisions, authoritative GateDecision, or completion authority.
AI coding agents are strong at local execution, but long or risky software work often fails for process reasons:
Aegis addresses those problems at the method-pack layer. It makes the agent frame the task, read the relevant baseline, keep evidence close to claims, track repair and retirement together, and maintain resumable checkpoints for long work.
Installing Aegis gives an AI coding tool a stricter development discipline without requiring a new runtime platform:
Aegis keeps the useful parts of superpowers:
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge.
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge.
Sign in to claim