Cursor rule

1---
2alwaysApply: false
3---
4 
5# AI-DLC Adaptive Workflow Overview
6 
7**Purpose**: Technical reference for AI model and developers to understand complete workflow structure.
8 
9**Note**: Similar content exists in welcome-message.md (user welcome message) and README.md (documentation). This duplication is INTENTIONAL - each file serves a different purpose:
10- **This file**: Detailed technical reference with Mermaid diagram for AI model context loading
11- **welcome-message.md**: User-facing welcome message with ASCII diagram
12- **README.md**: Human-readable documentation for repository
13 
14## The Three-Phase Lifecycle:
15• **INCEPTION PHASE**: Planning and architecture (Workspace Detection + conditional phases + Workflow Planning)
16• **CONSTRUCTION PHASE**: Design, implementation, build and test (per-unit design + Code Generation + Build & Test)
17• **OPERATIONS PHASE**: Placeholder for future deployment and monitoring workflows
18 
19## The Adaptive Workflow:
20• **Workspace Detection** (always) → **Reverse Engineering** (brownfield only) → **Requirements Analysis** (always, adaptive depth) → **Conditional Phases** (as needed) → **Workflow Planning** (always) → **Code Generation** (always, per-unit) → **Build and Test** (always)
21 
22## How It Works:
23• **AI analyzes** your request, workspace, and complexity to determine which stages are needed
24• **These stages always execute**: Workspace Detection, Requirements Analysis (adaptive depth), Workflow Planning, Code Generation (per-unit), Build and Test
25• **All other stages are conditional**: Reverse Engineering, User Stories, Application Design, Units Generation, per-unit design stages (Functional Design, NFR Requirements, NFR Design, Infrastructure Design)
26• **No fixed sequences**: Stages execute in the order that makes sense for your specific task
27 
28## Your Team's Role:
29• **Answer questions** in dedicated question files using [Answer]: tags with letter choices (A, B, C, D, E)
30• **Option E available**: Choose "Other" and describe your custom response if provided options don't match
31• **Work as a team** to review and approve each phase before proceeding
32• **Collectively decide** on architectural approach when needed
33• **Important**: This is a team effort - involve relevant stakeholders for each phase
34 
35## AI-DLC Three-Phase Workflow:
36 
37```mermaid
38flowchart TD
39    Start(["User Request"])
40    
41    subgraph INCEPTION["🔵 INCEPTION PHASE"]
42        WD["Workspace Detection<br/><b>ALWAYS</b>"]
43        RE["Reverse Engineering<br/><b>CONDITIONAL</b>"]
44        RA["Requirements Analysis<br/><b>ALWAYS</b>"]
45        Stories["User Stories<br/><b>CONDITIONAL</b>"]
46        WP["Workflow Planning<br/><b>ALWAYS</b>"]
47        AppDesign["Application Design<br/><b>CONDITIONAL</b>"]
48        UnitsG["Units Generation<br/><b>CONDITIONAL</b>"]
49    end
50    
51    subgraph CONSTRUCTION["🟢 CONSTRUCTION PHASE"]
52        FD["Functional Design<br/><b>CONDITIONAL</b>"]
53        NFRA["NFR Requirements<br/><b>CONDITIONAL</b>"]
54        NFRD["NFR Design<br/><b>CONDITIONAL</b>"]
55        ID["Infrastructure Design<br/><b>CONDITIONAL</b>"]
56        CG["Code Generation<br/><b>ALWAYS</b>"]
57        BT["Build and Test<br/><b>ALWAYS</b>"]
58    end
59    
60    subgraph OPERATIONS["🟡 OPERATIONS PHASE"]
61        OPS["Operations<br/><b>PLACEHOLDER</b>"]
62    end
63    
64    Start --> WD
65    WD -.-> RE
66    WD --> RA
67    RE --> RA
68    
69    RA -.-> Stories
70    RA --> WP
71    Stories --> WP
72    
73    WP -.-> AppDesign
74    WP -.-> UnitsG
75    AppDesign -.-> UnitsG
76    UnitsG --> FD
77    FD -.-> NFRA
78    NFRA -.-> NFRD
79    NFRD -.-> ID
80    
81    WP --> CG
82    FD --> CG
83    NFRA --> CG
84    NFRD --> CG
85    ID --> CG
86    CG -.->|Next Unit| FD
87    CG --> BT
88    BT -.-> OPS
89    BT --> End(["Complete"])
90    
91    style WD fill:#4CAF50,stroke:#1B5E20,stroke-width:3px,color:#fff
92    style RA fill:#4CAF50,stroke:#1B5E20,stroke-width:3px,color:#fff
93    style WP fill:#4CAF50,stroke:#1B5E20,stroke-width:3px,color:#fff
94 
95    style CG fill:#4CAF50,stroke:#1B5E20,stroke-width:3px,color:#fff
96    style BT fill:#4CAF50,stroke:#1B5E20,stroke-width:3px,color:#fff
97    style OPS fill:#BDBDBD,stroke:#424242,stroke-width:2px,stroke-dasharray: 5 5,color:#000
98    style RE fill:#FFA726,stroke:#E65100,stroke-width:3px,stroke-dasharray: 5 5,color:#000
99    style Stories fill:#FFA726,stroke:#E65100,stroke-width:3px,stroke-dasharray: 5 5,color:#000
100    style AppDesign fill:#FFA726,stroke:#E65100,stroke-width:3px,stroke-dasharray: 5 5,color:#000
101 
102    style UnitsG fill:#FFA726,stroke:#E65100,stroke-width:3px,stroke-dasharray: 5 5,color:#000
103    style FD fill:#FFA726,stroke:#E65100,stroke-width:3px,stroke-dasharray: 5 5,color:#000
104    style NFRA fill:#FFA726,stroke:#E65100,stroke-width:3px,stroke-dasharray: 5 5,color:#000
105    style NFRD fill:#FFA726,stroke:#E65100,stroke-width:3px,stroke-dasharray: 5 5,color:#000
106    style ID fill:#FFA726,stroke:#E65100,stroke-width:3px,stroke-dasharray: 5 5,color:#000
107    style INCEPTION fill:#BBDEFB,stroke:#1565C0,stroke-width:3px, color:#000
108    style CONSTRUCTION fill:#C8E6C9,stroke:#2E7D32,stroke-width:3px, color:#000
109    style OPERATIONS fill:#FFF59D,stroke:#F57F17,stroke-width:3px, color:#000
110    style Start fill:#CE93D8,stroke:#6A1B9A,stroke-width:3px,color:#000
111    style End fill:#CE93D8,stroke:#6A1B9A,stroke-width:3px,color:#000
112    
113    linkStyle default stroke:#333,stroke-width:2px
114```
115 
116**Stage Descriptions:**
117 
118**🔵 INCEPTION PHASE** - Planning and Architecture
119- Workspace Detection: Analyze workspace state and project type (ALWAYS)
120- Reverse Engineering: Analyze existing codebase (CONDITIONAL - Brownfield only)
121- Requirements Analysis: Gather and validate requirements (ALWAYS - Adaptive depth)
122- User Stories: Create user stories and personas (CONDITIONAL)
123- Workflow Planning: Create execution plan (ALWAYS)
124- Application Design: High-level component identification and service layer design (CONDITIONAL)
125- Units Generation: Decompose into units of work (CONDITIONAL)
126 
127**🟢 CONSTRUCTION PHASE** - Design, Implementation, Build and Test
128- Functional Design: Detailed business logic design per unit (CONDITIONAL, per-unit)
129- NFR Requirements: Determine NFRs and select tech stack (CONDITIONAL, per-unit)
130- NFR Design: Incorporate NFR patterns and logical components (CONDITIONAL, per-unit)
131- Infrastructure Design: Map to actual infrastructure services (CONDITIONAL, per-unit)
132- Code Generation: Generate code with Part 1 - Planning, Part 2 - Generation (ALWAYS, per-unit)
133- Build and Test: Build all units and execute comprehensive testing (ALWAYS)
134 
135**🟡 OPERATIONS PHASE** - Placeholder
136- Operations: Placeholder for future deployment and monitoring workflows (PLACEHOLDER)
137 
138**Key Principles:**
139- Phases execute only when they add value
140- Each phase independently evaluated
141- INCEPTION focuses on "what" and "why"
142- CONSTRUCTION focuses on "how" plus "build and test"
143- OPERATIONS is placeholder for future expansion
144- Simple changes may skip conditional INCEPTION stages
145- Complex changes get full INCEPTION and CONSTRUCTION treatment
146