@sixsevenai/ai-dlc-installer 1.4.0 → 1.4.1

package/library/commands/ai-dlc/add-unit.md

@@ -1,141 +1,142 @@
----
-command: ai-dlc:add-unit
-description: Add a new Unit to an active session for mid-workflow scope expansion
-phase: inception
-args:
-  - name: unit-name
-    description: Name for the new Unit (e.g., "shipping-integration")
-    required: false
-  - name: entities
-    description: Comma-separated list of entities (e.g., "ShippingCarrier,CarrierRate")
-    required: false
-  - name: rationale
-    description: Business reason for adding this Unit
-    required: false
----
-
-# Add Unit (Scope Expansion)
-
-Add a new Unit to an active session for mid-workflow scope expansion without losing existing progress.
-
-## Command: /ai-dlc:add-unit [unit-name] [--entities list] [--rationale "reason"]
-
-## Context Isolation: Required
-
-**MANDATORY**: Use the Task tool to spawn the scope-manager subagent. Do NOT execute scope expansion in this context.
-
-**EXECUTION ENFORCEMENT** (HARD BLOCKER):
-1. Do NOT proceed until the Task tool returns results from the scope-manager subagent
-2. After agent returns, verify Units artifact was updated: `artifacts/inception/units-*.md`
-3. If artifact not updated or agent failed → ERROR and STOP
-4. Display confirmation with new Unit name and updated Units artifact path
-
-Do NOT continue to "Usage Examples" or any other section until verification passes.
-
-Use Task tool with these parameters:
-- **subagent_type**: `scope-manager`
-- **prompt**: See below
-
-## Subagent Prompt
-
-```
-User is adding a new Unit for scope expansion.
-Unit name: ${unit-name || 'will prompt for name'}
-Entities: ${entities || 'will prompt for entities'}
-Rationale: ${rationale || 'will prompt for rationale'}
-
-Execute the full scope expansion workflow:
-
-1. VALIDATE SESSION (Gate)
-   - No session: BLOCK → /ai-dlc:start-intent
-   - No workflow: WARN, continue (artifacts only)
-   - Valid: Proceed
-
-2. GATHER UNIT DETAILS
-   If args provided: Use them
-   If missing: Prompt for:
-   - Name (auto-prefix "unit-" if missing)
-   - Purpose (required)
-   - Entities (comma-separated)
-   - Bolts estimate (1-3, default: 2)
-   - Rationale (business reason)
-   - Dependencies (list or "none")
-
-3. UPDATE INTENT
-   - Bump minor version (2.0.0 → 2.1.0)
-   - Add entities to Capabilities section
-   - Add changelog entry
-
-4. ADD UNIT TO UNITS DOCUMENT
-   - Count existing Units for numbering
-   - Append Unit definition with:
-     - Purpose, Entities, Bolts estimate
-     - Dependencies, Added date, Rationale
-
-5. ADR DECISION POINT
-   Ask: "Does this require architectural decisions?"
-   - Yes: Gather and create ADR
-   - No (default): Skip
-
-6. RISK DECISION POINT
-   Ask: "Does this introduce new risks?"
-   - Yes: Gather and update Risk Register
-   - No (default): Skip
-
-7. UPDATE WORKFLOW (if exists)
-   - Add steps to workflow YAML
-   - Update state JSON (pending steps)
-
-8. TRACK SESSION STATE
-   - Log scope expansion event
-   - Preserve original_scope on first expansion
-   - Track updated artifacts
-
-9. DISPLAY SUMMARY
-   - Unit added, version bump, artifacts updated
-
-10. GIT COMMIT (optional)
-    Offer Y/N/R for commit
-
-11. SUGGEST NEXT STEPS
-    - /ai-dlc:domain-model "{unit-name}" (primary)
-    - /ai-dlc:validate-phase inception
-
-Session ID format: YYYYMMDD-NNN (get from active session)
-```
-
-## Usage Examples
-
-```bash
-# Interactive mode (prompts for all details)
-/ai-dlc:add-unit
-
-# With Unit name only
-/ai-dlc:add-unit shipping-integration
-
-# Fully specified
-/ai-dlc:add-unit shipping-integration --entities "ShippingCarrier,CarrierRate" --rationale "Client requested PayPal support"
-```
-
-## Purpose
-
-When requirements change during an active Bolt or workflow, this command enables systematic scope expansion by:
-- **Updating Intent**: Version bump + changelog + new entities
-- **Adding Unit**: New Unit definition with Bolts breakdown
-- **ADR Creation**: Document architectural decisions (if needed)
-- **Risk Assessment**: Add new risks (if identified)
-- **Workflow Update**: Add new steps to workflow YAML and state
-- **Git Commit**: Optionally commit all scope expansion changes
-
-## Prerequisites
-
-- **Active Session**: Must have active session (created via `/ai-dlc:start-intent`)
-- **Intent Document**: Must exist
-- **Units Document**: Must exist
-
-## Next Steps
-
-After scope expansion:
-- `/ai-dlc:domain-model "{unit-name}"` - Create domain model for new Unit
-- `/ai-dlc:validate-phase inception` - Validate Inception completeness
-- `/ai-dlc:workflow-status` - View updated workflow (if exists)
+---
+command: ai-dlc:add-unit
+description: Add a new Unit to an active session for mid-workflow scope expansion
+argument-hint: "[unit-name] [--entities list] [--rationale text]"
+phase: inception
+args:
+  - name: unit-name
+    description: Name for the new Unit (e.g., "shipping-integration")
+    required: false
+  - name: entities
+    description: Comma-separated list of entities (e.g., "ShippingCarrier,CarrierRate")
+    required: false
+  - name: rationale
+    description: Business reason for adding this Unit
+    required: false
+---
+
+# Add Unit (Scope Expansion)
+
+Add a new Unit to an active session for mid-workflow scope expansion without losing existing progress.
+
+## Command: /ai-dlc:add-unit [unit-name] [--entities list] [--rationale "reason"]
+
+## Context Isolation: Required
+
+**MANDATORY**: Use the Task tool to spawn the scope-manager subagent. Do NOT execute scope expansion in this context.
+
+**EXECUTION ENFORCEMENT** (HARD BLOCKER):
+1. Do NOT proceed until the Task tool returns results from the scope-manager subagent
+2. After agent returns, verify Units artifact was updated: `artifacts/inception/units-*.md`
+3. If artifact not updated or agent failed → ERROR and STOP
+4. Display confirmation with new Unit name and updated Units artifact path
+
+Do NOT continue to "Usage Examples" or any other section until verification passes.
+
+Use Task tool with these parameters:
+- **subagent_type**: `scope-manager`
+- **prompt**: See below
+
+## Subagent Prompt
+
+```
+User is adding a new Unit for scope expansion.
+Unit name: ${unit-name || 'will prompt for name'}
+Entities: ${entities || 'will prompt for entities'}
+Rationale: ${rationale || 'will prompt for rationale'}
+
+Execute the full scope expansion workflow:
+
+1. VALIDATE SESSION (Gate)
+   - No session: BLOCK → /ai-dlc:start-intent
+   - No workflow: WARN, continue (artifacts only)
+   - Valid: Proceed
+
+2. GATHER UNIT DETAILS
+   If args provided: Use them
+   If missing: Prompt for:
+   - Name (auto-prefix "unit-" if missing)
+   - Purpose (required)
+   - Entities (comma-separated)
+   - Bolts estimate (1-3, default: 2)
+   - Rationale (business reason)
+   - Dependencies (list or "none")
+
+3. UPDATE INTENT
+   - Bump minor version (2.0.0 → 2.1.0)
+   - Add entities to Capabilities section
+   - Add changelog entry
+
+4. ADD UNIT TO UNITS DOCUMENT
+   - Count existing Units for numbering
+   - Append Unit definition with:
+     - Purpose, Entities, Bolts estimate
+     - Dependencies, Added date, Rationale
+
+5. ADR DECISION POINT
+   Ask: "Does this require architectural decisions?"
+   - Yes: Gather and create ADR
+   - No (default): Skip
+
+6. RISK DECISION POINT
+   Ask: "Does this introduce new risks?"
+   - Yes: Gather and update Risk Register
+   - No (default): Skip
+
+7. UPDATE WORKFLOW (if exists)
+   - Add steps to workflow YAML
+   - Update state JSON (pending steps)
+
+8. TRACK SESSION STATE
+   - Log scope expansion event
+   - Preserve original_scope on first expansion
+   - Track updated artifacts
+
+9. DISPLAY SUMMARY
+   - Unit added, version bump, artifacts updated
+
+10. GIT COMMIT (optional)
+    Offer Y/N/R for commit
+
+11. SUGGEST NEXT STEPS
+    - /ai-dlc:domain-model "{unit-name}" (primary)
+    - /ai-dlc:validate-phase inception
+
+Session ID format: YYYYMMDD-NNN (get from active session)
+```
+
+## Usage Examples
+
+```bash
+# Interactive mode (prompts for all details)
+/ai-dlc:add-unit
+
+# With Unit name only
+/ai-dlc:add-unit shipping-integration
+
+# Fully specified
+/ai-dlc:add-unit shipping-integration --entities "ShippingCarrier,CarrierRate" --rationale "Client requested PayPal support"
+```
+
+## Purpose
+
+When requirements change during an active Bolt or workflow, this command enables systematic scope expansion by:
+- **Updating Intent**: Version bump + changelog + new entities
+- **Adding Unit**: New Unit definition with Bolts breakdown
+- **ADR Creation**: Document architectural decisions (if needed)
+- **Risk Assessment**: Add new risks (if identified)
+- **Workflow Update**: Add new steps to workflow YAML and state
+- **Git Commit**: Optionally commit all scope expansion changes
+
+## Prerequisites
+
+- **Active Session**: Must have active session (created via `/ai-dlc:start-intent`)
+- **Intent Document**: Must exist
+- **Units Document**: Must exist
+
+## Next Steps
+
+After scope expansion:
+- `/ai-dlc:domain-model "{unit-name}"` - Create domain model for new Unit
+- `/ai-dlc:validate-phase inception` - Validate Inception completeness
+- `/ai-dlc:workflow-status` - View updated workflow (if exists)