aidlc-en

AIDLC Engine

AI-driven Software Development Life Cycle framework. Model-agnostic, quality-gate enforced, works with any team.

Quick Start

# New project
npx @aidlc/engine init

# Existing repo (first time)
npx @aidlc/engine setup

# Start working on a task
aidlc start "describe what you are building"

# Invoke an agent
aidlc agent dev
aidlc agent qa

# Run quality gates
aidlc gate run all

# Generate tests for your changes
aidlc test make

Installation

# As a project dev dependency (recommended)
npm install --save-dev @aidlc/engine

# Or run directly with npx (no install needed)
npx @aidlc/engine init

How It Works

• Run aidlc init once per project — scaffolds .aidlc/ config and optionally a boilerplate
• Every developer runs aidlc setup after cloning — registers their name, role, and API key locally
• Developers invoke agents (aidlc agent dev) for AI-assisted coding or work manually
• Quality gates run at checkpoints — pre-commit, pre-push, and in CI
• When a gate fails, AI can fix or suggest — developer chooses

Agent Fleet

Agent	Role
architect	Design decisions, pattern compliance, ADRs
dev	Feature implementation, code generation
qa	Test case generation, coverage analysis
security	Threat modeling, vulnerability analysis
reviewer	Code review, acceptance criteria check
docs	Documentation generation and maintenance

Quality Gates

Gate	What It Checks	How
code-standards	ESLint, naming, complexity	Tool + AI
test-coverage	Coverage ≥ threshold, test presence	Tool (Jest)
build	Compilation succeeds	Tool
security-scan	Vulnerabilities, secrets, SAST	Tool + AI
code-quality	SonarQube analysis	Tool
commit-format	Conventional commits	Tool (commitlint)
api-standards	REST principles, OpenAPI spec	AI

Configuration

All project settings live in .aidlc/aisdlc.config.yaml — committed to git, shared by the team. Developer identity and API keys live in .aidlc/.local/ — gitignored, never committed.

Supported AI Providers

• Claude (Anthropic) — default
• OpenAI (GPT-4o, etc.)
• Google Gemini
• Ollama (local models — air-gapped environments)

Switch provider with one line in aisdlc.config.yaml.

License

MIT