Skip to content
Casulo AI Labs AID AI Integrated Development
AID v1.0.0 is out.See what's new →

Overview

AID — AI Integrated Development — is a methodology and toolchain for building software with AI coding agents. A structured, human-gated pipeline carries a work item from first understanding all the way to delivered code, without the ad-hoc drift of unstructured AI assistance. “Integrated” is the point: the human and the AI co-execute every phase — the AI proposes, the human steers, and nothing advances without an explicit OK.

These docs are the reference for both the methodology and the tool that ships it. If you are new, read on; the sections are ordered the way you will actually use AID.

The pipeline at a glance

Section titled “The pipeline at a glance”

Every work item moves through the same phases. Each produces a reviewable artifact and ends at a human gate — you approve before the next phase begins. The flow starts at configuration and ends at delivered, optionally monitored, code.

flowchart TB
    classDef prep    fill:#1E3A8A,stroke:#1E3A8A,color:#ffffff
    classDef def     fill:#6D28D9,stroke:#6D28D9,color:#ffffff
    classDef map     fill:#0F766E,stroke:#0F766E,color:#ffffff
    classDef exe     fill:#166534,stroke:#166534,color:#ffffff
    classDef delopt  fill:#C2410C,stroke:#C2410C,color:#ffffff,stroke-dasharray:5 4
    classDef aux     fill:#E5E7EB,stroke:#9CA3AF,color:#1F2937,stroke-dasharray:4 3
    classDef offpipe fill:#374151,stroke:#374151,color:#ffffff,stroke-dasharray:6 4

    subgraph G1[" 1 · Prepare "]
        Init["aid-config<br/>setup · once"]:::aux
        Disc["1 · aid-discover<br/>brownfield"]:::prep
        Sum["aid-summarize<br/>optional"]:::aux
    end
    subgraph G2[" 2 · Define "]
        Intv["2 · aid-interview<br/>gather requirements"]:::def
        Triage{"TRIAGE<br/>full or lite?"}:::def
        Spec["3 · aid-specify<br/>full path"]:::def
    end
    subgraph G3[" 3 · Map "]
        Plan["4 · aid-plan<br/>full path"]:::map
        Det["5 · aid-detail<br/>full path"]:::map
    end
    subgraph G4[" 4 · Execute "]
        Exe["6 · aid-execute<br/>8 task types · graded loop"]:::exe
    end
    subgraph G5[" 5 · Deliver (optional) "]
        Dep["aid-deploy"]:::delopt
        Mon["aid-monitor"]:::delopt
    end

    HK["aid-housekeep<br/>on-demand · off-pipeline<br/>KB-DELTA · SUMMARY-DELTA · CLEANUP"]:::offpipe

    Init --> Disc --> Intv --> Triage
    Triage -- "full path<br/>broad / multi-target" --> Spec --> Plan --> Det --> Exe
    Triage -- "lite path<br/>small, single-target" --> Exe
    Exe -. "on demand" .-> Dep
    Exe -. "on demand" .-> Mon
    Exe -. "when finished" .-> HK
    HK  -. "targeted KB refresh" .-> Disc

Eleven user-facing skills · five groups · two paths (TRIAGE-routed). The six numbered phases — Discover through Execute — are the mandatory pipeline; TRIAGE routes small, single-target work down the lite path straight to Execute.

The six core phases, in order:

  1. Discover — map an existing codebase into a Knowledge Base the agents can reason over. (Brownfield only; greenfield starts at Interview.)
  2. Interview — gather requirements conversationally; TRIAGE routes small work to the lite path automatically.
  3. Specify — turn each feature into a technical SPEC, with an agent acting as tech lead.
  4. Plan — sequence SPECs into deliveries, each a functional, buildable MVP.
  5. Detail — break deliveries into small, typed, dependency-ordered tasks.
  6. Execute — run each task with a built-in adversarial review loop until it clears the grade bar.

Eleven user-facing skills across five groups deliver these phases. When the work is small and well-scoped, the lite path skips Specify, Plan, and Detail — the same rigour, proportionate overhead.

Install

Section titled “Install”

AID installs as a global aid CLI; you then run aid add <tool> inside a repository to drop the skills, agents, and Knowledge Base scaffold into your project. Pick the channel for your platform:

Terminal window
curl -fsSL https://raw.githubusercontent.com/AndreVianna/aid-methodology/master/install.sh | bash -s -- --version 1.0.0

Current release: v1.0.0. After install, run aid add claude-code (or another tool), then /aid-config in your AI tool to scaffold the Knowledge Base. The Installation guide covers every channel, per-OS detail, updates, and removal.

How to navigate these docs

Section titled “How to navigate these docs”

The docs are organized to match the order you will actually use AID.

Get Started Install AID, run your first work item, and try the lite quickstart path.
Guides Task-focused walkthroughs: installation, working the pipeline, and maintaining a release.
Concepts The methodology in depth — the pipeline, philosophy, the Knowledge Base, and the FAQ.
Reference Exhaustive lookups: CLI, skills, agents, the KB, settings, artifacts, and the glossary.

Report an issue with this page →