feat: Add multi-user parallel development support to AI-DLC

This commit introduces comprehensive multi-user collaboration capabilities:

New Features:
- Multi-user parallel development with automatic branch management
- User-scoped audit files to prevent conflicts
- Unit assignment tracking and dependency-aware consolidation
- Consolidated project views with automatic indexing

New Files:
- AGENTS.md.example: Configuration template for multi-user behavior
- MULTI-USER-GUIDE.md: Comprehensive guide for team collaboration
- MULTI-USER-IMPLEMENTATION.md: Technical implementation details
- QUICK-REFERENCE.md: Quick commands and workflows reference
- multi-user-commands.md: Command handling rules
- multi-user-parallel.md: Parallel workflow orchestration rules

Updated Files:
- README.md: Added multi-user documentation and configuration sections
- Rule files enhanced with minimal multi-user specific additions
- All documentation uses current 'kiro-cli chat' command syntax

This enables teams to work on different units simultaneously while maintaining
audit isolation and providing automatic consolidation capabilities.

Author: jschwellach

AGENTS.md.example

@@ -0,0 +1,30 @@
+# AGENTS.md - Project Configuration
+
+Copy to project root as `AGENTS.md` to customize multi-user behavior.
+
+## Folder Structure
+
+### Generated Code
+```
+[unit-name]/
+├── src/              # Source code (language-specific structure)
+├── tests/            # Tests
+└── docs/             # Documentation
+```
+
+### Audits
+```
+aidlc-docs/audits/[unit-name]/[developer]/
+```
+
+### Branches
+```
+feature/[unit-name]-[developer]
+```
+
+## Custom Paths (Optional)
+
+Override defaults by specifying:
+- `code_root`: Base path for generated code (default: `[unit-name]/`)
+- `audit_root`: Base path for audits (default: `aidlc-docs/audits/`)
+- `branch_prefix`: Branch naming prefix (default: `feature/`)

MULTI-USER-GUIDE.md

@@ -0,0 +1,339 @@
+# Multi-User Parallel Development Guide
+
+## Overview
+
+AI-DLC now supports multiple developers working on different units simultaneously with automatic branch management, audit isolation, and consolidation.
+
+## Quick Start
+
+### 1. Complete Inception Phase (Lead Developer)
+
+```bash
+kiro-cli chat "Create a user management system with authentication"
+```
+
+The AI will guide you through:
+- Workspace Detection
+- Requirements Analysis
+- Application Design
+- Units Generation
+
+After units are generated, you'll see:
+
+```
+🎯 Ready for Parallel Development
+
+3 units are ready. Multiple developers can now work in parallel.
+
+Your Options:
+
+A) Claim a unit now (you will work on it immediately)
+B) Enable team collaboration (share with team)
+C) Work on all units sequentially (traditional mode)
+
+Which option? [A/B/C]
+```
+
+### 2. Enable Team Collaboration
+
+Choose **Option B** to enable team collaboration:
+
+```
+✅ Project Ready for Team Collaboration
+
+Share with your team:
+1. git pull origin main
+2. kiro-cli chat "list units"
+3. kiro-cli chat "claim unit <unit-name>"
+```
+
+### 3. Team Members Claim Units
+
+Each team member:
+
+```bash
+# Pull latest
+git pull origin main
+
+# View available units
+kiro-cli chat "list units"
+
+# Output:
+# ✅ user-service (alice) - Completed
+# 🔄 auth-service (bob) - In Progress  
+# ⭐ profile-service - Available
+# ⏳ admin-service - Blocked (depends on auth-service)
+
+# Claim an available unit
+kiro-cli chat "claim unit profile-service"
+```
+
+The AI will automatically:
+- Create branch: `unit/profile-service-charlie`
+- Update assignments
+- Initialize workspace
+- Start Construction Phase for that unit
+
+### 4. Work on Your Unit
+
+The AI guides you through Construction Phase stages:
+- Functional Design
+- NFR Requirements
+- NFR Design
+- Infrastructure Design
+- Code Generation
+
+All work happens in your isolated branch with your own audit trail:
+- Branch: `unit/profile-service-charlie`
+- Audit: `aidlc-docs/audit/user-charlie-audit.md`
+
+### 5. Complete Your Unit
+
+When done:
+
+```bash
+kiro-cli chat "complete unit profile-service"
+```
+
+The AI will:
+- Validate all stages completed
+- Commit your work
+- Push your branch
+- Create PR checklist
+- Offer next actions
+
+### 6. Consolidate Units (Lead/Integrator)
+
+When all units are ready:
+
+```bash
+kiro-cli chat "consolidate units"
+```
+
+The AI will:
+- Check dependencies
+- Merge units in correct order
+- Update consolidated index
+- Generate consolidated audit
+- Trigger Build and Test phase
+
+## Commands Reference
+
+### Unit Management
+
+| Command | Description |
+|---------|-------------|
+| `list units` | Show all units and their status |
+| `claim unit <name>` | Claim a unit for development |
+| `complete unit <name>` | Mark unit as complete |
+| `merge unit <name>` | Merge completed unit to main |
+| `consolidate units` | Merge all completed units |
+| `unit status <name>` | Show detailed unit status |
+
+### Audit Management
+
+| Command | Description |
+|---------|-------------|
+| `show audit` | Display your audit trail |
+| `show all audits` | Display all team audits |
+| `audit summary` | Generate project audit summary |
+
+### Natural Language
+
+The AI understands natural language too:
+
+```bash
+kiro-cli chat "I want to work on the user service"
+# → Executes: claim unit user-service
+
+kiro-cli chat "I'm done with payment service"
+# → Executes: complete unit payment-service
+
+kiro-cli chat "what units are available?"
+# → Executes: list units
+
+kiro-cli chat "integrate everything"
+# → Executes: consolidate units
+```
+
+## File Structure
+
+### Per-User Audit Files
+
+```
+aidlc-docs/
+├── audit/
+│   ├── user-alice-audit.md      # Alice's audit trail
+│   ├── user-bob-audit.md        # Bob's audit trail
+│   ├── user-charlie-audit.md    # Charlie's audit trail
+│   ├── audit-index.md           # Index of all audits
+│   └── consolidated-audit.md    # Merged view
+```
+
+### Unit Branches
+
+```
+main                              # Inception artifacts
+├── unit/user-service-alice       # Alice's unit
+├── unit/auth-service-bob         # Bob's unit
+└── unit/profile-service-charlie  # Charlie's unit
+```
+
+### Unit Assignments
+
+```
+aidlc-docs/construction/unit-assignments.md
+```
+
+| Unit | Assigned To | Status | Branch | Started | Completed |
+|------|-------------|--------|--------|---------|-----------|
+| user-service | alice | Completed | unit/user-service-alice | 2025-11-05 09:00 | 2025-11-05 11:00 |
+| auth-service | bob | In Progress | unit/auth-service-bob | 2025-11-05 10:00 | - |
+| profile-service | charlie | In Progress | unit/profile-service-charlie | 2025-11-05 10:30 | - |
+
+## Workflow Diagram
+
+```
+Inception Phase (Lead)
+         ↓
+   Units Generated
+         ↓
+    ┌────┴────┬────────┐
+    ↓         ↓        ↓
+  Alice     Bob    Charlie
+  (Unit 1)  (Unit 2) (Unit 3)
+    ↓         ↓        ↓
+  Branch    Branch   Branch
+    ↓         ↓        ↓
+Construction Construction Construction
+    ↓         ↓        ↓
+  Complete  Complete Complete
+    ↓         ↓        ↓
+    └────┬────┴────────┘
+         ↓
+   Consolidation
+         ↓
+   Build & Test
+```
+
+## Best Practices
+
+### 1. Clear Unit Boundaries
+- Ensure units have minimal dependencies
+- Design for parallel development during Application Design
+
+### 2. Communication
+- Update unit-assignments.md when claiming units
+- Check dependencies before starting
+- Coordinate with team on blocked units
+
+### 3. Regular Consolidation
+- Don't wait too long to merge completed units
+- Merge in dependency order
+- Run integration tests after consolidation
+
+### 4. Audit Trail
+- Each developer maintains their own audit
+- Consolidated audit provides project overview
+- Use audit for retrospectives and reviews
+
+### 5. Branch Hygiene
+- Work only in your unit branch
+- Don't modify other units' code
+- Keep branches up to date with main
+
+## Troubleshooting
+
+### Unit Already Claimed
+```
+❌ Unit already claimed by bob
+Available units: profile-service, admin-service
+```
+**Solution**: Choose a different unit or coordinate with team member.
+
+### Dependency Not Met
+```
+❌ Cannot merge: dependency not satisfied
+admin-service depends on: auth-service (status: In Progress)
+```
+**Solution**: Wait for dependency to complete or help complete it.
+
+### Not in Unit Branch
+```
+❌ Not in unit branch
+Current branch: main
+Expected: unit/profile-service-charlie
+```
+**Solution**: `git checkout unit/profile-service-charlie`
+
+### Merge Conflicts
+```
+❌ Merge conflict in aidlc-docs/construction/consolidated-index.md
+```
+**Solution**: Resolve conflicts manually, then continue consolidation.
+
+## Example Session
+
+### Lead Developer (Alice)
+
+```bash
+# Start project
+kiro-cli chat "Create e-commerce system"
+
+# Complete inception
+# Choose Option B: Enable team collaboration
+
+# Claim first unit
+kiro-cli chat "claim unit product-catalog"
+
+# Work on unit...
+# Complete unit
+kiro-cli chat "complete unit product-catalog"
+```
+
+### Team Member (Bob)
+
+```bash
+# Join project
+git pull origin main
+
+# View units
+kiro-cli chat "list units"
+
+# Claim unit
+kiro-cli chat "claim unit shopping-cart"
+
+# Work on unit...
+# Complete unit
+kiro-cli chat "complete unit shopping-cart"
+```
+
+### Integrator (Alice or Lead)
+
+```bash
+# Check status
+kiro-cli chat "list units"
+
+# All units complete, consolidate
+kiro-cli chat "consolidate units"
+
+# Build and test
+# Follow AI guidance for integration testing
+```
+
+## Migration from Single-User
+
+Existing projects can adopt multi-user workflow:
+
+1. Complete any in-progress work
+2. Commit to main
+3. Pull latest AI-DLC rules
+4. Start new feature with multi-user workflow
+5. Team members can now claim units
+
+## Support
+
+For issues or questions:
+- Check audit trails: `kiro-cli chat "show all audits"`
+- Review unit status: `kiro-cli chat "unit status <name>"`
+- Consult consolidated index: `aidlc-docs/construction/consolidated-index.md`