aidlc-kit 0.3.0__tar.gz

aidlc_kit-0.3.0/.gitignore

@@ -0,0 +1,17 @@
+# Python
+__pycache__/
+*.pyc
+*.egg-info/
+dist/
+build/
+
+# Virtual environment
+.venv/
+
+# Test cache
+.pytest_cache/
+
+# Local-only files (not part of the distributed package)
+reports/
+FUTURE_FEATURES.md
+PROJECT_CONTEXT.md

aidlc_kit-0.3.0/LICENSE

@@ -0,0 +1,97 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:             Ricardo González Vargas
+Licensed Work:        aidlc-kit 0.3.0
+                      The Licensed Work is (c) 2026 Ricardo González Vargas.
+Additional Use Grant: You may use the Licensed Work in production to scaffold
+                      and manage AI-DLC projects for your own organization or
+                      your clients. You may not:
+                      (a) offer the Licensed Work, or a substantially similar
+                          derivative, as a hosted service, managed service, or
+                          SaaS product;
+                      (b) sell, distribute, or sublicense the Licensed Work or
+                          a derivative as a standalone scaffolding or project
+                          generation tool that competes with the Licensed Work.
+Change Date:          2030-02-27
+Change License:       Apache License, Version 2.0
+
+For information about alternative licensing arrangements for the Licensed Work,
+please contact: rgonv@hotmail.com
+
+Notice
+
+The Business Source License (this document, or the "License") is not an Open
+Source license. However, the Licensed Work will eventually be made available
+under an Open Source License, as stated in this License.
+
+License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+MariaDB hereby grants you permission to use this License's text to license
+your works, and to refer to it using the trademark "Business Source License",
+as long as you comply with the Covenants of Licensor below.
+
+Covenants of Licensor
+
+In consideration of the right to use this License's text and the "Business
+Source License" name and trademark, Licensor covenants to MariaDB, and to all
+other recipients of the licensed work to be provided by Licensor:
+
+1. To specify as the Change License the GPL Version 2.0 or any later version,
+   or a license that is compatible with GPL Version 2.0 or a later version,
+   where "compatible" means that software provided under the Change License
+   can be included in a program with software provided under GPL Version 2.0
+   or a later version. Licensor may specify additional Change Licenses without
+   limitation.
+
+2. To either: (a) specify an additional grant of rights to use that does not
+   impose any additional restriction on the right granted in this License, as
+   the Additional Use Grant; or (b) insert the text "None".
+
+3. To specify a Change Date.
+
+4. Not to modify this License in any other way.

aidlc_kit-0.3.0/PKG-INFO

@@ -0,0 +1,181 @@
+Metadata-Version: 2.4
+Name: aidlc-kit
+Version: 0.3.0
+Summary: Scaffold AI-DLC projects with enterprise guardrails, prompts, and compliance templates.
+Author-email: Ricardo González Vargas <rgonv@hotmail.com>
+License: BUSL-1.1
+License-File: LICENSE
+Keywords: ai-dlc,enterprise,governance,guardrails,scaffold
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.11
+Requires-Dist: click>=8.1
+Description-Content-Type: text/markdown
+
+# aidlc-kit
+
+Scaffold AI-DLC projects with prompts, templates, and consistency checks.
+
+**aidlc-kit** is the companion CLI tool for the [AI-DLC methodology](https://ricardogonzalez.me), as described 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
+
+```bash
+pip install aidlc-kit
+# or with uv
+uv tool install aidlc-kit
+# or run without installing
+uvx aidlc-kit
+```
+
+## Quick Start
+
+```bash
+# 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 aws --ide kiro
+
+# Enterprise tier (adds EGS guardrails, compliance matrix, gap analysis)
+aidlc-kit init my-project --mode greenfield --platform aws --tier enterprise
+```
+
+## Commands
+
+| Command | Purpose |
+|---------|---------|
+| `init` | Scaffold a new AI-DLC project |
+| `check` | Validate project health and consistency |
+| `status` | Show current project progress dashboard |
+| `update` | Update kit-owned templates to latest version |
+| `archive` | Archive completed intent and reset workspace |
+| `export-egs` | Export the project's EGS definition to a file |
+| `import-egs` | Import an external EGS definition into the project |
+| `consistency` | Run structural consistency checks across artifacts |
+
+## What It Creates
+
+### Standard tier (default)
+
+```
+aidlc-docs/
+├── README.md                        ← Project card (name, mode, platform, tier)
+├── aidlc-state.md                   ← Session state tracking
+├── intents/
+│   └── intent-primary.md            ← Blank intent template
+├── prompts/                         ← AI-DLC prompt templates
+│   ├── mob-elaboration.md
+│   ├── mob-construction.md
+│   └── code-elevation.md            ← (brownfield only)
+├── plan-templates/                  ← Plan templates for AI to populate
+│   ├── mob_elaboration_plan.md
+│   ├── mob_construction_plan.md
+│   └── code_elevation_plan.md       ← (brownfield only)
+├── code-elevation/                  ← (brownfield only)
+│   ├── static_model.md
+│   ├── dynamic_model.md
+│   └── technical_debt.md
+├── mob-elaboration/
+├── mob-construction/
+│   ├── bolt-1/ (or bolt-b1/)
+│   ├── bolt-2/ (or bolt-b2/)
+│   └── bolt-3/ (or bolt-b3/)
+├── standards/                       ← Content validation, error handling, question format
+├── completion/                      ← Bolt criteria, consistency check, intent consolidation
+├── decisions/
+│   └── decision-log.md
+├── retrospectives/
+│   └── session-retrospective.md
+├── audit/
+│   └── audit-log.md
+├── intent-summaries/
+└── archive/
+```
+
+### Enterprise tier (`--tier enterprise`)
+
+Adds on top of standard:
+- `egs_definition.md` — Enterprise Guardrails Specification (10 categories, customize per project)
+- `mob-elaboration/guardrails_compliance_matrix.md` — Story-to-guardrail mapping
+- `code-elevation/guardrails_gap_analysis.md` — Codebase violation-to-guardrail mapping (brownfield only)
+- `overrides/guardrails_overrides.md` — Guardrail exception tracking
+- Prompt templates include EGS validation gates at every phase/stage
+
+## Options
+
+### 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. Use when you have regulatory, security, or governance requirements.
+
+### IDE Support
+
+Generate router configs for your IDE with `--ide`. Use `--ide all` for every supported IDE.
+
+| Tool | Link |
+|------|------|
+| agents-md | [agents.md](https://agents.md/) |
+| aider | [aider.chat](https://aider.chat/) |
+| amp | [ampcode.com](https://ampcode.com/) |
+| auggie | [augmentcode.com](https://www.augmentcode.com/) |
+| claude-code | [docs.anthropic.com/claude-code](https://docs.anthropic.com/en/docs/claude-code/overview) |
+| cline | [cline.bot](https://cline.bot/) |
+| codebuddy | [codebuddy.ai](https://codebuddy.ai/) |
+| codex | [openai.com/codex](https://openai.com/index/openai-codex/) |
+| copilot | [github.com/features/copilot](https://github.com/features/copilot) |
+| copilot-cli | [docs.github.com/copilot-cli](https://docs.github.com/en/copilot/how-tos/copilot-cli) |
+| costrict | [docs.costrict.ai](https://docs.costrict.ai/) |
+| crush | [github.com/charmbracelet/crush](https://github.com/charmbracelet/crush) |
+| cursor | [cursor.com](https://www.cursor.com/) |
+| factory-droid | [factory.ai](https://www.factory.ai/) |
+| gemini | [gemini.google.com](https://gemini.google.com/) |
+| gemini-cli | [github.com/google-gemini/gemini-cli](https://github.com/google-gemini/gemini-cli) |
+| iflow | [iflow.cn](https://platform.iflow.cn/en/cli/quickstart) |
+| kilo-code | [kilocode.ai](https://kilocode.ai/) |
+| kiro | [kiro.dev](https://kiro.dev/) |
+| opencode | [opencode.ai](https://opencode.ai/) |
+| q-developer | [aws.amazon.com/q/developer](https://aws.amazon.com/q/developer/) |
+| qoder | [qodo.ai](https://www.qodo.ai/) |
+| roo-code | [roocode.com](https://roocode.com/) |
+| windsurf | [windsurf.com](https://windsurf.com/) |
+
+## Workflow
+
+1. Open your project in your IDE and ask: "Start Mob Elaboration"
+2. The AI will ask you to describe your intent (or read it from `intents/intent-primary.md` if you wrote one ahead of time)
+3. AI generates the elaboration plan (stories, units, bolts)
+4. Run Mob Construction bolt by bolt
+5. Use `aidlc-kit check` between bolts to validate consistency
+6. Use `aidlc-kit archive` when the intent is complete, then start the next one
+
+For enterprise tier, also customize `egs_definition.md` before step 1.
+
+## Upgrading to Enterprise
+
+Start with standard and upgrade later without re-scaffolding:
+
+```bash
+aidlc-kit update --tier enterprise
+```
+
+This adds the enterprise-only files and updates templates with EGS validation gates.
+
+## License
+
+Business Source License 1.1 — see [LICENSE](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.

aidlc_kit-0.3.0/README.md

@@ -0,0 +1,164 @@
+# aidlc-kit
+
+Scaffold AI-DLC projects with prompts, templates, and consistency checks.
+
+**aidlc-kit** is the companion CLI tool for the [AI-DLC methodology](https://ricardogonzalez.me), as described 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
+
+```bash
+pip install aidlc-kit
+# or with uv
+uv tool install aidlc-kit
+# or run without installing
+uvx aidlc-kit
+```
+
+## Quick Start
+
+```bash
+# 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 aws --ide kiro
+
+# Enterprise tier (adds EGS guardrails, compliance matrix, gap analysis)
+aidlc-kit init my-project --mode greenfield --platform aws --tier enterprise
+```
+
+## Commands
+
+| Command | Purpose |
+|---------|---------|
+| `init` | Scaffold a new AI-DLC project |
+| `check` | Validate project health and consistency |
+| `status` | Show current project progress dashboard |
+| `update` | Update kit-owned templates to latest version |
+| `archive` | Archive completed intent and reset workspace |
+| `export-egs` | Export the project's EGS definition to a file |
+| `import-egs` | Import an external EGS definition into the project |
+| `consistency` | Run structural consistency checks across artifacts |
+
+## What It Creates
+
+### Standard tier (default)
+
+```
+aidlc-docs/
+├── README.md                        ← Project card (name, mode, platform, tier)
+├── aidlc-state.md                   ← Session state tracking
+├── intents/
+│   └── intent-primary.md            ← Blank intent template
+├── prompts/                         ← AI-DLC prompt templates
+│   ├── mob-elaboration.md
+│   ├── mob-construction.md
+│   └── code-elevation.md            ← (brownfield only)
+├── plan-templates/                  ← Plan templates for AI to populate
+│   ├── mob_elaboration_plan.md
+│   ├── mob_construction_plan.md
+│   └── code_elevation_plan.md       ← (brownfield only)
+├── code-elevation/                  ← (brownfield only)
+│   ├── static_model.md
+│   ├── dynamic_model.md
+│   └── technical_debt.md
+├── mob-elaboration/
+├── mob-construction/
+│   ├── bolt-1/ (or bolt-b1/)
+│   ├── bolt-2/ (or bolt-b2/)
+│   └── bolt-3/ (or bolt-b3/)
+├── standards/                       ← Content validation, error handling, question format
+├── completion/                      ← Bolt criteria, consistency check, intent consolidation
+├── decisions/
+│   └── decision-log.md
+├── retrospectives/
+│   └── session-retrospective.md
+├── audit/
+│   └── audit-log.md
+├── intent-summaries/
+└── archive/
+```
+
+### Enterprise tier (`--tier enterprise`)
+
+Adds on top of standard:
+- `egs_definition.md` — Enterprise Guardrails Specification (10 categories, customize per project)
+- `mob-elaboration/guardrails_compliance_matrix.md` — Story-to-guardrail mapping
+- `code-elevation/guardrails_gap_analysis.md` — Codebase violation-to-guardrail mapping (brownfield only)
+- `overrides/guardrails_overrides.md` — Guardrail exception tracking
+- Prompt templates include EGS validation gates at every phase/stage
+
+## Options
+
+### 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. Use when you have regulatory, security, or governance requirements.
+
+### IDE Support
+
+Generate router configs for your IDE with `--ide`. Use `--ide all` for every supported IDE.
+
+| Tool | Link |
+|------|------|
+| agents-md | [agents.md](https://agents.md/) |
+| aider | [aider.chat](https://aider.chat/) |
+| amp | [ampcode.com](https://ampcode.com/) |
+| auggie | [augmentcode.com](https://www.augmentcode.com/) |
+| claude-code | [docs.anthropic.com/claude-code](https://docs.anthropic.com/en/docs/claude-code/overview) |
+| cline | [cline.bot](https://cline.bot/) |
+| codebuddy | [codebuddy.ai](https://codebuddy.ai/) |
+| codex | [openai.com/codex](https://openai.com/index/openai-codex/) |
+| copilot | [github.com/features/copilot](https://github.com/features/copilot) |
+| copilot-cli | [docs.github.com/copilot-cli](https://docs.github.com/en/copilot/how-tos/copilot-cli) |
+| costrict | [docs.costrict.ai](https://docs.costrict.ai/) |
+| crush | [github.com/charmbracelet/crush](https://github.com/charmbracelet/crush) |
+| cursor | [cursor.com](https://www.cursor.com/) |
+| factory-droid | [factory.ai](https://www.factory.ai/) |
+| gemini | [gemini.google.com](https://gemini.google.com/) |
+| gemini-cli | [github.com/google-gemini/gemini-cli](https://github.com/google-gemini/gemini-cli) |
+| iflow | [iflow.cn](https://platform.iflow.cn/en/cli/quickstart) |
+| kilo-code | [kilocode.ai](https://kilocode.ai/) |
+| kiro | [kiro.dev](https://kiro.dev/) |
+| opencode | [opencode.ai](https://opencode.ai/) |
+| q-developer | [aws.amazon.com/q/developer](https://aws.amazon.com/q/developer/) |
+| qoder | [qodo.ai](https://www.qodo.ai/) |
+| roo-code | [roocode.com](https://roocode.com/) |
+| windsurf | [windsurf.com](https://windsurf.com/) |
+
+## Workflow
+
+1. Open your project in your IDE and ask: "Start Mob Elaboration"
+2. The AI will ask you to describe your intent (or read it from `intents/intent-primary.md` if you wrote one ahead of time)
+3. AI generates the elaboration plan (stories, units, bolts)
+4. Run Mob Construction bolt by bolt
+5. Use `aidlc-kit check` between bolts to validate consistency
+6. Use `aidlc-kit archive` when the intent is complete, then start the next one
+
+For enterprise tier, also customize `egs_definition.md` before step 1.
+
+## Upgrading to Enterprise
+
+Start with standard and upgrade later without re-scaffolding:
+
+```bash
+aidlc-kit update --tier enterprise
+```
+
+This adds the enterprise-only files and updates templates with EGS validation gates.
+
+## License
+
+Business Source License 1.1 — see [LICENSE](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.

aidlc_kit-0.3.0/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "aidlc-kit"
+version = "0.3.0"
+description = "Scaffold AI-DLC projects with enterprise guardrails, prompts, and compliance templates."
+readme = "README.md"
+license = { text = "BUSL-1.1" }
+requires-python = ">=3.11"
+authors = [
+    { name = "Ricardo González Vargas", email = "rgonv@hotmail.com" },
+]
+keywords = ["ai-dlc", "guardrails", "scaffold", "enterprise", "governance"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: Other/Proprietary License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Software Development :: Quality Assurance",
+]
+dependencies = [
+    "click>=8.1",
+]
+
+[project.scripts]
+aidlc-kit = "aidlc_kit.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/aidlc_kit"]

aidlc_kit-0.3.0/src/aidlc_kit/__init__.py

@@ -0,0 +1,3 @@
+"""aidlc-kit: Scaffold AI-DLC projects with enterprise guardrails."""
+
+__version__ = "0.3.0"