Metadata-Version: 2.4
Name: aidlc-profile-software
Version: 0.14.0
Summary: Default software development profile for aidlc-kit.
Project-URL: Homepage, https://reimaginedontretrofit.com
Project-URL: Repository, https://github.com/rgonv/aidlc-kit
Author: Ricardo González Vargas
License: BUSL-1.1
Keywords: ai-dlc,enterprise,guardrails,scaffold,software
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.11
Requires-Dist: click>=8.1
Description-Content-Type: text/markdown

# aidlc-profile-software

Default software development profile for [aidlc-kit](https://pypi.org/project/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:

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

To install standalone (for development):

```bash
uv pip install -e .
```

## Usage

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

```bash
# 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:

```bash
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.
