Aedile

          Claude Code
               │
               ▼
        "Build authentication"
               │
               ▼
           Aedile MCP
      ┌────────────────────┐
      │ Existing helper?   │
      │ Stdlib available?  │
      │ Import cycles?     │
      │ Layer violation?   │
      └────────────────────┘
               │
               ▼
      Minimal implementation

Why Aedile?

Modern coding assistants know how to write code. They usually don't know your architecture.

That leads to:

• duplicate utilities

• unnecessary dependencies

• circular imports

• broken layering

• inconsistent implementations

Aedile verifies the repository before code generation begins, giving coding assistants real project context instead of relying solely on prompts.

Related MCP server: Carto MCP Server

Quick Example

Without Aedile

AI: "I'll install requests."

↓

Repository already has httpx.

↓

Duplicate dependency.

With Aedile

AI: "Repository already uses httpx."

↓

Reuse existing client.

↓

No duplicate dependency.

How It Works

Aedile implements the Model Context Protocol (MCP). The assistant calls a single tool—aedile_consult—before generating any code.

Developer
    │
    ▼
  Claude
    │
    ▼
Aedile MCP
    │
    ├── Architecture Verifier
    ├── Workspace Index
    └── Decision Engine
    │
    ▼
  Advice
    │
    ▼
  Claude
    │
    ▼
Implementation

Aedile never modifies your code. It only observes and advises.

Installation

pip install aedile

Generate the local prompt templates:

python -m aedile compile-rules

Then add python -m aedile as an MCP server in your coding assistant. See SUPPORTED_AGENTS.md for step-by-step guides.

Configuration

Aedile works out of the box with zero configuration. Advanced options are documented in CONFIGURATION.md.

Supported Agents

Full setup guides are in SUPPORTED_AGENTS.md.

Benchmarks

Benchmarks were measured using identical prompts on the same repository, before and after enabling Aedile.

Environment

• Hardware: Apple M2 Pro, 16 GB RAM

• Python: 3.11

• Agent: Claude 2.1

• Repository: 42 modules, ~8,000 lines of Python

Results

Full methodology and raw data: BENCHMARKS.md.

FAQ

Why not use static prompting (e.g., .cursorrules)?

Static prompts drift. As the context window fills, the model's adherence to static text degrades. Aedile enforces constraints through a live tool interface—the model receives current repository facts on every call, not instructions it may ignore.

Does Aedile require internet access?

No. All scanning, indexing, and analysis runs locally. There is no outbound network traffic and no telemetry.

Documentation

• Architecture

• Decision Ladder

• Supported Agents

• Changelog

• Roadmap

• Security Policy

Contributing

Contributions are welcome. Please read CONTRIBUTING.md and CODE_OF_CONDUCT.md before opening a pull request.

License

Aedile is released under the MIT License.