aidlc-kit 0.14.0

Scaffold AI-DLC projects with enterprise guardrails, prompts, and compliance templates.

aidlc-kit

AI-DLC project scaffolding engine with plugin-based solution profiles.

aidlc-kit is the companion CLI tool for the AI-DLC methodology, originally introduced by Raja SP in the AWS DevOps Blog and further expanded with open-source adaptive workflows. The methodology is extended with additional rituals, enterprise guardrails, brownfield workflows, and tooling in Reimagine, Don't Retrofit by Ricardo González Vargas. The book provides the methodology, principles, and rituals; this tool provides the project scaffolding to put them into practice.

Install

pip install aidlc-kit
# or with uv
uv tool install aidlc-kit
# or run without installing
uvx aidlc-kit

Installing aidlc-kit also installs the default software profile, which provides the software development workflow (Mob Elaboration, Mob Construction, Code Elevation).

Quick Start

# Scaffold a new project (interactive wizard)
aidlc-kit init my-project

# Non-interactive
aidlc-kit init my-project --mode greenfield --platform aws --ide kiro

# Brownfield (existing codebase)
cd existing-repo
aidlc-kit init . --mode brownfield --platform azure --ide copilot

Solution Profiles

aidlc-kit is a workflow engine. The actual templates, prompts, and ritual definitions live in profile packages. Each profile targets a different workflow.

# List installed profiles
aidlc-kit profiles list

# Use a specific profile
aidlc-kit init my-project --profile software   # default

Profiles are discovered via Python entry points (aidlc_kit.profiles group). Install any profile package and it appears automatically in profiles list. Profiles can also declare CLI commands that are registered dynamically at startup.

Engine Commands

Command	Purpose
init	Scaffold a new AI-DLC project
check	Validate project health and template drift
status	Show current project progress dashboard
update	Update kit-owned templates to latest version
archive	Archive completed work and reset workspace
profiles	List installed solution profiles
version	Show versions of engine and installed profiles

Profiles can declare additional commands via the cli_commands contract field. The software profile adds consistency, validate-plan, extensions, intent, and bolt. See each profile's README for its commands.

What the Engine Does

The engine provides profile-agnostic scaffolding mechanics:

• Copies templates from the active profile's templates_path into aidlc-docs/
• Applies platform overlays (aws/, azure/, gcp/, etc.) on top of base templates
• Renders conditional blocks ({{#tierName}}...{{/tierName}}) based on the active tier
• Replaces placeholders ({{PROJECT_NAME}}, {{PLATFORM}}, {{KIT_VERSION}})
• Generates IDE router configs and Agent Skills for 24 supported IDEs
• Generates MCP server configs from profile declarations
• Detects template drift, tier upgrades, and project health via check
• Protects user-owned files (state, intents, decisions) during update

What gets scaffolded depends entirely on the installed profile.

IDE Support

Generate router configs for your IDE with --ide. Use --ide all for every supported IDE.

Tool	Link
agents-md	agents.md
aider	aider.chat
amp	ampcode.com
auggie	augmentcode.com
claude-code	docs.anthropic.com/claude-code
cline	cline.bot
codebuddy	codebuddy.ai
codex	openai.com/codex
copilot	github.com/features/copilot
copilot-cli	docs.github.com/copilot-cli
costrict	docs.costrict.ai
crush	github.com/charmbracelet/crush
cursor	cursor.com
factory-droid	factory.ai
gemini	gemini.google.com
gemini-cli	github.com/google-gemini/gemini-cli
iflow	iflow.cn
kilo-code	kilocode.ai
kiro	kiro.dev
opencode	opencode.ai
q-developer	aws.amazon.com/q/developer
qoder	qodo.ai
roo-code	roocode.com
windsurf	windsurf.com

Profile Contract

Profiles declare their capabilities via a Python dict. The engine uses these fields to drive scaffolding, validation, and CLI behavior:

Field	Purpose
name, display_name, version	Identity
rituals	Workflow phases (e.g., ["elaboration", "construction"])
modes	Project modes (e.g., ["greenfield", "brownfield"]) or None
platforms	Deployment targets (e.g., ["aws", "azure"]) or None
tiers	Feature tiers (e.g., ["standard", "enterprise"]) or None
templates_path	Path to the profile's template directory
skills	Agent Skills for Tier 1 IDEs
cli_commands	Click commands registered at startup
user_owned	Files the engine must never overwrite on update
tier_files	Files that exist only at specific tiers
mcp_server_configs	MCP server declarations for IDE config scaffolding

Profile extensions use extends to add capabilities to a base profile (e.g., tiers_add, skills_add, cli_commands_add).

License

Business Source License 1.1 — see LICENSE for details.

Free to use for scaffolding and managing your AI-DLC projects. You may not offer this tool, or a derivative, as a competing product or hosted service. Converts to Apache 2.0 on 2030-02-27.