AI Dev Framework

A multi-agent AI software development framework that turns a project brief into a complete, production-ready specification — and then into working code — using a team of specialized Claude AI agents.

What It Does

You write a project brief. The framework runs a structured 9-agent pipeline that produces:

• A full technical specification (architecture, security, backend, frontend, devops, cost estimate)
• An executive review and approval decision
• An exportable HTML/PDF document ready for stakeholders
• Optionally: generated code via dev agents

All cost estimates are denominated in ZAR (South African Rand).

The 9-Agent Pipeline

Product Manager → Architect → Security → Backend → QA → Frontend → DevOps → Finance → Reviewer

Each agent reads every previous agent's output before writing its own — ensuring full context and consistency across the entire design.

| # | Agent | Output | Description | |---|-------|--------|-------------| | 1 | product_manager | docs/01_product_scope.md | Product vision, requirements, user stories, workflows | | 2 | architect | docs/02_system_architecture.md | System layers, tech stack, module boundaries | | 3 | security | docs/03_security_model.md | Threat model, auth strategy, audit logging | | 4 | backend | docs/04_backend_architecture.md | Domain models, API contracts, services | | 5 | qa | docs/05_testing_strategy.md | Test cases, coverage strategy, CI pipeline | | 6 | frontend | docs/06_frontend_architecture.md | UI architecture, state management, screens | | 7 | devops | docs/07_deployment_architecture.md | Docker, CI/CD, infrastructure, monitoring | | 8 | finance | docs/08_cost_estimation.md | ZAR cost breakdown: dev time, infra, ops | | 9 | reviewer | docs/09_review_report.md | Completeness check, issues, approval decision |

Installation

npm install -g ai-dev-framework

Prerequisites:

• Node.js ≥ 18
• Claude CLI installed and authenticated
• Git

Verify everything is ready:

aidev check

Quick Start — Planning Pipeline

# 1. Initialise a new project
aidev init my-project

# 2. Fill in .ai/context.md with your project brief

# 3. Run the full 9-agent pipeline
aidev build my-project

# 4. Export to HTML + PDF
aidev export my-project

During aidev build, press V at any time to toggle live Claude output on/off.

Quick Start — Mobile Scaffold (React Native + Node.js)

For new full-stack projects with a React Native mobile app and an Express/Prisma/PostgreSQL backend:

# 1. Scaffold a new project
aidev new

# 2. Define a model
aidev generate model Invoice

# 3. Generate full-stack CRUD from the model
aidev generate scaffold Invoice

The scaffold generates:

• Backend: Prisma schema block, Zod DTOs, repository, service, controller, Express router
• Mobile: TypeScript types, API client, list screen, detail screen, form screen

All models include base audit fields (id, createdAt, createdBy, updatedAt, updatedBy, deleted, deletedAt, deletedBy) and support soft deletes only — records are never hard-deleted.

CLI Reference

| Command | Description | |---------|-------------| | aidev check | Verify all prerequisites are installed | | aidev init <dir> | Initialise a new project with the planning template | | aidev build [dir] | Run the full 9-agent planning pipeline | | aidev run <agent> [dir] | Run a single agent | | aidev fix [dir] | Re-run the reviewer and fix flagged issues | | aidev develop [dir] | Run dev agents to generate code from planning docs | | aidev sprints [dir] | View real-time sprint progress from dev agents | | aidev export [dir] | Export all docs to HTML + PDF | | aidev status [dir] | Show pipeline completion status | | aidev agents | List all available agents | | aidev usage [dir] | Show token usage and cost report | | aidev new | Scaffold a new React Native + Node.js project | | aidev generate model <Name> | Create a .model.md template | | aidev generate scaffold <Name> | Generate full-stack CRUD from a model file |

Repository Structure

ai-dev-framework/
├── agents/
│   ├── planning/           # Planning agent prompts (9 agents)
│   │   ├── product_manager.md
│   │   ├── architect.md
│   │   ├── security.md
│   │   ├── backend.md
│   │   ├── qa.md
│   │   ├── frontend.md
│   │   ├── devops.md
│   │   ├── finance.md
│   │   └── reviewer.md
│   └── dev/                # Dev agent prompts (code generation)
│       └── fullstack.md
│
├── rules/                  # Enforced rules loaded by all agents
│   ├── security_rules.md
│   ├── architecture_rules.md
│   └── coding_rules.md
│
├── templates/
│   ├── project_template/   # Planning project scaffold
│   └── mobile_template/    # React Native + Node.js starter
│       ├── backend/        # Express + Prisma + PostgreSQL
│       └── mobile/         # Expo React Native
│
├── src/
│   ├── commands/           # CLI command handlers
│   ├── generators/         # Code generators (prisma, dto, repo, screens…)
│   ├── lib/                # Core library (runner, parser, exporter…)
│   └── index.js
│
├── bin/
│   └── aidev.js            # CLI entry point
│
├── CHANGELOG.md
└── README.md

Design Principles

| Principle | Description | |-----------|-------------| | Documentation First | Architecture is fully defined before any code is written | | Backend Before Frontend | API contracts are locked before UI design begins | | Security by Design | Security has its own dedicated pipeline stage | | Cost Transparency | Every project includes a ZAR-denominated cost estimate | | Soft Deletes Only | All generated models use soft deletes for a full audit trail | | Modular Architecture | Clean architecture layers enforced across all components |

Project Output Structure

After aidev build, your project contains:

my-project/
├── .ai/
│   ├── context.md              # Your project brief
│   ├── project_state.json      # Pipeline progress tracker
│   └── sprints/                # Dev agent sprint tracking (after aidev develop)
├── docs/
│   ├── 01_product_scope.md
│   ├── 02_system_architecture.md
│   ├── 03_security_model.md
│   ├── 04_backend_architecture.md
│   ├── 05_testing_strategy.md
│   ├── 06_frontend_architecture.md
│   ├── 07_deployment_architecture.md
│   ├── 08_cost_estimation.md
│   ├── 09_review_report.md
│   └── my-project-specification.pdf   # after aidev export
├── backend/
├── frontend/
├── tests/
└── infrastructure/

License

MIT © 2026