Aegis
Structured AI development framework for Claude Code.
Aegis brings discipline without dogma to AI-assisted development. Three principles, nine specialized agents, automatic quality gates — all packaged as a single Claude Code plugin.
What It Does
Aegis makes Claude Code better at writing production code by enforcing three pillars:
- Epistemic Rigor — Verify before assuming. Read code before modifying it. Admit uncertainty.
- Total Ownership — You touch it, you own it. Boy Scout Rule applies. No blame-shifting.
- Structured Feedback — Every action produces information. Full outputs, captured learnings.
On top of that, Aegis provides:
- Adaptive complexity — Tasks are assessed on a 0–4 scale. Typo fixes get zero overhead. System designs get structured plans and specialized agents.
- 9 specialized agents — Architect, Quality, Security, Frontend, Backend, Database, DevOps, Performance, Documentation. Invoked automatically at Level 3–4.
- Pre-push quality gates — Automatic linting, type checking, testing, and secrets scanning before any
git push. Stack-aware (TypeScript, Python, C#, Rust, Go).
- 3 MCP bridges — Playwright, Context7, DeepWiki. GitHub MCP is user-configured (requires token).
Installation
From marketplace
/plugin marketplace add Kan-Bull/aegis
/plugin install aegis@aegis-marketplace
Direct install from GitHub
git clone https://github.com/Kan-Bull/aegis.git
claude --plugin-dir ./aegis
GitHub bridge (optional)
Set your token so the GitHub MCP works:
export GITHUB_TOKEN=ghp_xxxxxxxxxxxxx
Playwright, Context7, and DeepWiki work without tokens.
Post-install — activate framework and hooks
The plugin provides agents, commands, and MCP bridges. But two things need global installation because the Claude Code plugin system doesn't reliably auto-activate skills or hooks yet:
1. Behavioral framework (required)
Add one line to your global CLAUDE.md:
echo 'Always load the aegis:aegis-core skill at the start of every task.' >> ~/.claude/CLAUDE.md
This ensures Aegis activates on every project, every session.
2. Quality gate hooks (required)
Copy the hook scripts and register them in your settings:
# Copy scripts
mkdir -p ~/.claude/hooks/aegis
cp scripts/pre-push.sh scripts/mcp-push-guard.sh scripts/context-load.sh ~/.claude/hooks/aegis/
chmod +x ~/.claude/hooks/aegis/*.sh
Then add the hooks to ~/.claude/settings.json:
{
"hooks": {
"SessionStart": [
{
"matcher": "",
"hooks": [{ "type": "command", "command": "bash ~/.claude/hooks/aegis/context-load.sh", "timeout": 10 }]
}
],
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [{ "type": "command", "command": "bash ~/.claude/hooks/aegis/pre-push.sh", "timeout": 120 }]
},
{
"matcher": "mcp__github__push_files",
"hooks": [{ "type": "command", "command": "bash ~/.claude/hooks/aegis/mcp-push-guard.sh", "timeout": 5 }]
},
{
"matcher": "mcp__github__create_or_update_file",
"hooks": [{ "type": "command", "command": "bash ~/.claude/hooks/aegis/mcp-push-guard.sh", "timeout": 5 }]
}
]
}
}
Merge this into your existing settings — don't replace the whole file.
Why manual? Plugin hooks aren't registered by Claude Code yet (known limitation). Global settings hooks are the reliable path.
You can also add your own global rules to ~/.claude/CLAUDE.md — language preferences, commit conventions, coding style. Anything you find yourself repeating across projects belongs there.
What's Inside
aegis/
├── .claude-plugin/plugin.json # Plugin manifest
├── agents/ # 9 specialized agents
│ ├── architect.md
│ ├── quality.md
│ ├── security.md
│ ├── frontend.md
│ ├── backend.md
│ ├── database.md
│ ├── devops.md
│ ├── performance.md
│ └── documentation.md
├── hooks/hooks.json # Lifecycle hooks
├── scripts/
│ ├── context-load.sh # Session startup — detect stack & context
│ ├── pre-push.sh # Pre-push — gates & secrets scan
│ └── mcp-push-guard.sh # Block direct MCP pushes → use git push
├── skills/aegis-core/SKILL.md # Auto-activating behavioral framework
├── commands/
│ ├── core.md # /aegis:core — manual reload with feedback
│ └── status.md # /aegis:status — diagnostic
├── .mcp.json # MCP bridge configurations (3 bridges)
└── README.md
The Adaptive System
Every task is assessed on complexity:
