Skip to content

Commit 0c7664b

Browse files
jschwellachjschwellach
committed
feat: Add multi-user parallel development support to AI-DLC
This commit introduces comprehensive multi-user collaboration capabilities integrated into the core AI-DLC workflow: 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 - 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 - units-generation.md: Added Step 20 for multi-user setup workflow - Rule files enhanced with multi-user workflow integration - All documentation uses current 'kiro-cli chat' command syntax Multi-user functionality is built into the core workflow and automatically available. After inception, users can choose solo work or enable team collaboration with automatic unit assignment and consolidation.
1 parent 3f3df91 commit 0c7664b

File tree

6 files changed

+1028
-0
lines changed

6 files changed

+1028
-0
lines changed

‎AGENTS.md.example‎

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
# AGENTS.md - Project Configuration
2+
3+
Copy to project root as `AGENTS.md` to customize multi-user behavior.
4+
5+
## Folder Structure
6+
7+
### Generated Code
8+
```
9+
[unit-name]/
10+
├── src/ # Source code (language-specific structure)
11+
├── tests/ # Tests
12+
└── docs/ # Documentation
13+
```
14+
15+
### Audits
16+
```
17+
aidlc-docs/audits/[unit-name]/[developer]/
18+
```
19+
20+
### Branches
21+
```
22+
feature/[unit-name]-[developer]
23+
```
24+
25+
## Custom Paths (Optional)
26+
27+
Override defaults by specifying:
28+
- `code_root`: Base path for generated code (default: `[unit-name]/`)
29+
- `audit_root`: Base path for audits (default: `aidlc-docs/audits/`)
30+
- `branch_prefix`: Branch naming prefix (default: `feature/`)

‎QUICK-REFERENCE.md‎

Lines changed: 152 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,152 @@
1+
# AI-DLC Multi-User Quick Reference
2+
3+
## 🚀 Quick Start
4+
5+
### Lead Developer
6+
```bash
7+
kiro-cli chat "Create [your project description]"
8+
# Complete inception → Choose Option B
9+
```
10+
11+
### Team Members
12+
```bash
13+
git pull origin main
14+
kiro-cli chat "claim unit <unit-name>"
15+
# Work on unit → Complete
16+
kiro-cli chat "complete unit <unit-name>"
17+
```
18+
19+
### Integrator
20+
```bash
21+
kiro-cli chat "consolidate units"
22+
```
23+
24+
## 📋 Commands
25+
26+
| Command | What It Does |
27+
|---------|--------------|
28+
| `list units` | Show all units and status |
29+
| `claim unit <name>` | Start working on a unit |
30+
| `complete unit <name>` | Finish your unit |
31+
| `merge unit <name>` | Merge unit to main |
32+
| `consolidate units` | Merge all units |
33+
| `unit status <name>` | Check unit details |
34+
| `show audit` | Your activity log |
35+
| `show all audits` | Team activity logs |
36+
37+
## 🌳 Branch Structure
38+
39+
```
40+
main # Shared inception artifacts
41+
├── unit/user-service-alice # Alice's work
42+
├── unit/auth-service-bob # Bob's work
43+
└── unit/api-gateway-charlie # Charlie's work
44+
```
45+
46+
## 📁 File Structure
47+
48+
```
49+
aidlc-docs/
50+
├── audit/
51+
│ ├── user-alice-audit.md # Alice's log
52+
│ ├── user-bob-audit.md # Bob's log
53+
│ └── audit-index.md # All logs
54+
├── construction/
55+
│ ├── unit-assignments.md # Who's doing what
56+
│ └── consolidated-index.md # Merged units
57+
```
58+
59+
## 🔄 Workflow
60+
61+
```
62+
Inception (Lead) → Units Generated
63+
↓
64+
┌───────────────┼───────────────┐
65+
↓ ↓ ↓
66+
Alice (Unit 1) Bob (Unit 2) Charlie (Unit 3)
67+
↓ ↓ ↓
68+
Complete Complete Complete
69+
└───────────────┼───────────────┘
70+
↓
71+
Consolidate
72+
↓
73+
Build & Test
74+
```
75+
76+
## ✅ Status Icons
77+
78+
- ✅ Completed
79+
- 🔄 In Progress
80+
- ⭐ Available
81+
- ⏳ Blocked (waiting on dependency)
82+
83+
## 🎯 Best Practices
84+
85+
1. **Check dependencies** before claiming units
86+
2. **Commit often** in your unit branch
87+
3. **Complete units** when all stages done
88+
4. **Consolidate regularly** to avoid drift
89+
5. **Review audits** for team coordination
90+
91+
## 🆘 Quick Fixes
92+
93+
**Branch exists?**
94+
```bash
95+
git branch -D unit/name-user
96+
kiro-cli chat "claim unit name"
97+
```
98+
99+
**Out of sync?**
100+
```bash
101+
git pull origin main
102+
kiro-cli chat "list units"
103+
```
104+
105+
**Check status?**
106+
```bash
107+
kiro-cli chat "unit status <name>"
108+
```
109+
110+
## 📞 Need Help?
111+
112+
```bash
113+
kiro-cli chat "show all audits" # See what everyone did
114+
kiro-cli chat "list units" # See current status
115+
cat aidlc-docs/construction/unit-assignments.md
116+
```
117+
118+
## 🎓 Example Session
119+
120+
```bash
121+
# Alice starts project
122+
kiro-cli chat "Create e-commerce API"
123+
# → Completes inception, enables team
124+
125+
# Bob joins
126+
git pull origin main
127+
kiro-cli chat "claim unit product-catalog"
128+
# → Works on unit
129+
kiro-cli chat "complete unit product-catalog"
130+
131+
# Charlie joins
132+
git pull origin main
133+
kiro-cli chat "claim unit shopping-cart"
134+
# → Works on unit
135+
kiro-cli chat "complete unit shopping-cart"
136+
137+
# Alice consolidates
138+
kiro-cli chat "consolidate units"
139+
# → All units merged, build & test starts
140+
```
141+
142+
## 💡 Pro Tips
143+
144+
- Use `kiro-cli chat "I want to work on X"` instead of `claim unit X`
145+
- Use `kiro-cli chat "I'm done with X"` instead of `complete unit X`
146+
- Use `kiro-cli chat "what's available?"` instead of `list units`
147+
- AI understands natural language!
148+
149+
---
150+
151+
**Full Guide**: See `MULTI-USER-GUIDE.md`
152+
**Implementation Details**: See `MULTI-USER-IMPLEMENTATION.md`

‎README.md‎

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -102,6 +102,52 @@ AI-DLC follows a structured three-phase approach that adapts to your project's c
102102
- **Risk-Based**: Complex changes get comprehensive treatment, simple changes stay efficient
103103
- **Question-Driven**: Structured multiple-choice questions in files, not chat
104104
- **Always in Control**: Review execution plans and approve each phase
105+
- **Multi-User Parallel Development**: Multiple developers can work on different units simultaneously with automatic branch management and audit isolation
106+
107+
## Project Configuration
108+
109+
### AGENTS.md (Optional)
110+
111+
Customize multi-user behavior and folder structure by creating an `AGENTS.md` file in your project root:
112+
113+
```bash
114+
cp $AIDLC_WORKFLOWS/AGENTS.md.example ./AGENTS.md
115+
```
116+
117+
This file allows you to configure:
118+
- Generated code folder structure per unit
119+
- Audit file locations
120+
- Branch naming conventions
121+
- Custom paths for your project
122+
123+
See [AGENTS.md.example](AGENTS.md.example) for details.
124+
125+
## Multi-User Parallel Development
126+
127+
AI-DLC includes built-in team collaboration with automatic workflow management:
128+
129+
- 🔀 **Automatic Branch Creation**: Each developer works in isolated branches
130+
- 📝 **User-Scoped Audits**: No audit file conflicts between team members
131+
- 🎯 **Unit Assignment Tracking**: Clear visibility of who's working on what
132+
- 🔄 **Dependency-Aware Consolidation**: Automatic merging in correct order
133+
- 📊 **Consolidated Views**: Project-wide visibility with automatic indexing
134+
135+
**Quick Start**:
136+
```bash
137+
# Lead completes inception
138+
kiro-cli chat "Create microservices architecture"
139+
# → Choose "Enable team collaboration"
140+
141+
# Team members claim units
142+
kiro-cli chat "claim unit user-service"
143+
144+
# Integrator consolidates
145+
kiro-cli chat "consolidate units"
146+
```
147+
148+
Multi-user functionality is automatically available when using AI-DLC - no additional setup required.
149+
150+
**Learn More**: See [Quick Reference](QUICK-REFERENCE.md) for commands and workflows
105151

106152
## Prerequisites
107153

0 commit comments

Comments
 (0)