aidlc-profile-software

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

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:

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.