Kernel: Always Resident
AGENTS.md is the kernel image — always in context, never paged out. It defines identity, workflow, and constraint enforcement. Everything obeys it.
The operating system for AI agents — kernel, drivers, syscalls, filesystem. One protocol governs all.
AAEP (AI Architect Evolution Protocol) defines how an AI agent evolves into a project's architect through continuous constraint → execution → evolution cycles.
AI coding tools provide capability — code generation, file operations, terminal execution. They don't provide methodology — workflow governance, quality assurance, experience accumulation.
AAEP is the methodology layer.
| Layer | What | How |
|---|---|---|
| Constraint | Hard boundaries that shape code generation | ❌ prohibitions in constraint skills, injected into agent context |
| Workflow | Standard delivery sequences | /archon-demand 7-stage pipeline with opt-out flags |
| Evolution | System that gets smarter with every task | Stage 3.6 discovers patterns → staging area → approved → new constraint |
| Knowledge | Project memory that persists across sessions | archon.config.yaml, constraint skills, architecture docs |
Task 1 → Agent writes code under constraints
→ 6-dimension self-audit catches issue X
→ Proposes: ❌ prohibit X
→ User approves → constraint added
Task 2 → Agent cannot make mistake X (it's in the constraint set)
→ Audit catches issue Y → same cycle
Task N → Constraint system is comprehensive
→ Code quality monotonically increases
→ Fewer fixes → faster deliveryMore tasks → better constraints → higher quality. This is directed evolution — always toward fewer bugs, better performance, more consistent architecture.
| Dimension | ESLint | AAEP |
|---|---|---|
No any type | ✅ | ✅ |
| File size limits | ⚠️ | ✅ |
| Async: skeleton + error + retry per section | ❌ | ✅ |
| Tests updated for changed signatures | ❌ | ✅ |
| Module boundary violations | ❌ | ✅ |
| Off-screen deferred with IntersectionObserver | ❌ | ✅ |
ESLint catches syntax. AAEP catches architecture. Both layers active — Stage 1.5 runs your linter automatically.
| Tool | Agents | Skills | Constraints |
|---|---|---|---|
| Cursor | ✅ (primary) | ✅ | ✅ (preloaded) |
| Claude Code | ✅ (primary) | ✅ | ✅ (preloaded) |
| Codex | — | ✅ | ✅ |
| Copilot | — | ✅ | ✅ |
| Windsurf | — | ✅ | ✅ |
| Gemini CLI | — | ✅ | ✅ |
| 20+ others | — | ✅ | ✅ |
One protocol, every tool. Agent-first where supported, skill-fallback everywhere else.