How ganyuanran/aegis works
Aegis is a cross-host method pack for AI coding agents, combining reusable workflow skills with host-specific activation and workspace helpers. Its principal workflow is to orient and plan against the project baseline, make appropriately scoped changes, then verify and communicate completion with evidence. The repository also includes optional Codex record/final-response reconciliation. The README describes capabilities and installation behavior; source excerpts establish adapter and reconciliation links. Unsampled subsystem links are omitted where their callers are not shown.
Main entry points: SKILL.md Aegis routing · hook.py Codex integration · profile.py Codex profile · review.py Record review
Components 27
Engineering methods
- Project context
skills/establishing-project-context/SKILL.md - Aegis routing
skills/using-aegis/SKILL.md - Brainstorming
skills/brainstorming/SKILL.md - Planning
skills/writing-plans/SKILL.md - Plan execution
skills/executing-plans/SKILL.md - Test-driven development
skills/test-driven-development/SKILL.md - Systematic debugging
skills/systematic-debugging/SKILL.md - Code review
skills/requesting-code-review/SKILL.md - Completion verification
skills/verification-before-completion/SKILL.md - Complexity governance
skills/anti-entropy-governance/SKILL.md - UI/UX governance
skills/ui-ux-governance/SKILL.md
Host activation
- Claude integration
hooks/hooks.json - Codex integration
extensions/codex-reconciliation/hook.py - DSH integration
extensions/dsh/index.js - DSH bootstrap
extensions/dsh/bootstrap.js - Pi/OMP bootstrap
extensions/shared/aegis-bootstrap.ts - Pi adapter
extensions/pi/index.ts - OMP adapter
extensions/omp/index.ts
Workspace support
- Workspace manager
scripts/aegis-workspace.py - Install doctor
scripts/aegis-doctor.py - Aegis updater
scripts/aegis-update.py - Deferred ledger
scripts/aegis-deferred-ledger.py
Codex reconciliation
- Codex profile
extensions/codex-reconciliation/profile.py - Record review
extensions/codex-reconciliation/review.py - Assessor transport
extensions/codex-reconciliation/transport.py
Other components
- Developer
- Coding agent
Connections 29
- Developer → Coding agent: requests work
README.md - Coding agent → Aegis routing: routes methods
README.md - Aegis routing → Project context: aligns baseline
README.md - Aegis routing → Brainstorming: frames design
README.md - Aegis routing → Planning: plans changes
README.md - Aegis routing → Plan execution: guides execution
README.md - Aegis routing → Test-driven development: supports TDD
README.md - Aegis routing → Systematic debugging: guides diagnosis
README.md - Aegis routing → Code review: requests review
README.md - Aegis routing → Completion verification: proves completion
README.md - Aegis routing → Complexity governance: tracks retirement
README.md - Aegis routing → UI/UX governance: applies UI rules
README.md - Coding agent → Claude integration: activates methods
- Coding agent → Codex integration: activates methods
- Coding agent → DSH integration: activates methods
- DSH integration → DSH bootstrap: installs bootstrap
extensions/dsh/index.js - Coding agent → Pi adapter: activates methods
- Coding agent → OMP adapter: activates methods
- Pi adapter → Pi/OMP bootstrap: delegates to
extensions/pi/index.ts - OMP adapter → Pi/OMP bootstrap: delegates to
extensions/omp/index.ts - Developer → Workspace manager: manages workspace
- Developer → Install doctor: verifies install
README.md - Developer → Aegis updater: requests update
README.md - Codex integration → Codex profile: uses profile
extensions/codex-reconciliation/hook.py - Codex integration → Record review: calls assessment
extensions/codex-reconciliation/hook.py - Codex integration → Assessor transport: runs assessor
extensions/codex-reconciliation/hook.py - Codex profile → Record review: imports review
extensions/codex-reconciliation/profile.py - Codex profile → Assessor transport: imports transport
extensions/codex-reconciliation/profile.py - Record review → Assessor transport: uses transport
extensions/codex-reconciliation/review.py