aidlc-profile-software 0.14.0

Default software development profile for aidlc-kit.

aidlc-profile-software

Default software development profile for aidlc-kit.

Implements the AI-DLC software development workflow: Mob Elaboration, Mob Construction, and Code Elevation. Previously bundled inside aidlc-kit; extracted to its own package for architectural symmetry with other profiles (CPA, WAR, etc.).

Install

This package is installed automatically with aidlc-kit:

pip install aidlc-kit
# or
uv tool install aidlc-kit

To install standalone (for development):

uv pip install -e .

Usage

This is the default profile. No --profile flag needed:

# These are equivalent:
aidlc-kit init my-project --mode greenfield --platform aws
aidlc-kit init my-project --mode greenfield --platform aws --profile software

Profile Contract

Field	Value
Name	software
Display Name	Software Development
Rituals	elaboration, construction
Modes	greenfield, brownfield
Platforms	aws, azure, gcp, onprem, agnostic
Tiers	standard, enterprise

What It Provides

• Prompt templates: Mob Elaboration, Mob Construction, Code Elevation (brownfield)
• Plan templates: elaboration plan, construction plan, elevation plan (brownfield)
• EGS (Enterprise Guardrails Specification) templates per platform (enterprise tier)
• Extensions: security, api-design, observability, performance, testing
• Standards: content validation, error handling, question format
• Completion prompts: bolt criteria, consistency check, intent consolidation
• State file template with mode-aware ritual progress

Commands

These commands are registered dynamically when this profile is installed:

Command	Purpose
consistency	Run structural consistency checks across artifacts
validate-plan	Validate elaboration plan before starting construction
extensions	Manage project extensions (list, install, remove)
intent	Manage parallel intents via git branches (create, list, switch, archive)
bolt	Manage parallel bolts via git branches (branch, list, merge)

Modes

• greenfield — New project. Mob Elaboration and Mob Construction prompts.
• brownfield — Existing codebase. Adds Code Elevation prompt and templates for static model, dynamic model, and technical debt analysis.

Platforms

aws, azure, gcp, onprem, agnostic — Tailors the EGS definition template to the target platform.

Tiers

• standard (default) — Core AI-DLC workflow without guardrails enforcement.
• enterprise — Adds EGS guardrails, compliance matrix, gap analysis, and validation gates. Requires the aidlc-profile-software-enterprise extension.

Workflow

1. Open your project in your IDE and ask: "Start Mob Elaboration" (or "Start Code Elevation" for brownfield)
2. The AI reads the intent from intents/intent-primary.md and generates the elaboration plan (stories, units, bolts)
3. Run Mob Construction bolt by bolt
4. Use aidlc-kit consistency between bolts to validate structural integrity
5. Use aidlc-kit archive when the intent is complete, then start the next one

Parallel Work (Git Branching)

Work on multiple intents or bolts simultaneously using git branches:

aidlc-kit intent create "User API"       # branch + start working
aidlc-kit intent create "Notifications"  # second intent branch
aidlc-kit intent list                    # show active intent branches
aidlc-kit intent switch "user-api"       # switch between intents
aidlc-kit intent archive                 # archive, merge, clean up

aidlc-kit bolt branch 2                  # branch for Bolt 2 (validates dependencies)
aidlc-kit bolt list                      # show bolt branches
aidlc-kit bolt merge 2                   # merge completed bolt back to intent

License

Business Source License 1.1 — same terms as aidlc-kit. Converts to Apache 2.0 on 2030-02-27.