Cursor rule

1---
2alwaysApply: false
3---
4 
5# Workspace Detection
6 
7**Purpose**: Determine workspace state and check for existing AI-DLC projects
8 
9## Step 1: Check for Existing AI-DLC Project
10 
11Check if `aidlc-docs/aidlc-state.md` exists:
12- **If exists**: Resume from last phase (load context from previous phases)
13- **If not exists**: Continue with new project assessment
14 
15## Step 2: Scan Workspace for Existing Code
16 
17**Determine if workspace has existing code:**
18- Scan workspace for source code files (.java, .py, .js, .ts, .jsx, .tsx, .kt, .kts, .scala, .groovy, .go, .rs, .rb, .php, .c, .h, .cpp, .hpp, .cc, .cs, .fs, etc.)
19- Check for build files (pom.xml, package.json, build.gradle, etc.)
20- Look for project structure indicators
21- Identify workspace root directory (NOT aidlc-docs/)
22 
23**Record findings:**
24```markdown
25## Workspace State
26- **Existing Code**: [Yes/No]
27- **Programming Languages**: [List if found]
28- **Build System**: [Maven/Gradle/npm/etc. if found]
29- **Project Structure**: [Monolith/Microservices/Library/Empty]
30- **Workspace Root**: [Absolute path]
31```
32 
33## Step 3: Determine Next Phase
34 
35**IF workspace is empty (no existing code)**:
36- Set flag: `brownfield = false`
37- Next phase: Requirements Analysis
38 
39**IF workspace has existing code**:
40- Set flag: `brownfield = true`
41- Check for existing reverse engineering artifacts in `aidlc-docs/inception/reverse-engineering/`
42- **IF reverse engineering artifacts exist**:
43    - Check if artifacts are stale (compare artifact timestamps against codebase's last significant modification)
44    - **IF artifacts are current**: Load them, skip to Requirements Analysis
45    - **IF artifacts are stale**: Next phase is Reverse Engineering (rerun to refresh artifacts)
46    - **IF user explicitly requests rerun**: Next phase is Reverse Engineering regardless of staleness
47- **IF no reverse engineering artifacts**: Next phase is Reverse Engineering
48 
49## Step 4: Create Initial State File
50 
51Create `aidlc-docs/aidlc-state.md`:
52 
53```markdown
54# AI-DLC State Tracking
55 
56## Project Information
57- **Project Type**: [Greenfield/Brownfield]
58- **Start Date**: [ISO timestamp]
59- **Current Stage**: INCEPTION - Workspace Detection
60 
61## Workspace State
62- **Existing Code**: [Yes/No]
63- **Reverse Engineering Needed**: [Yes/No]
64- **Workspace Root**: [Absolute path]
65 
66## Code Location Rules
67- **Application Code**: Workspace root (NEVER in aidlc-docs/)
68- **Documentation**: aidlc-docs/ only
69- **Structure patterns**: See code-generation.md Critical Rules
70 
71## Stage Progress
72[Will be populated as workflow progresses]
73```
74 
75## Step 5: Present Completion Message
76 
77**For Brownfield Projects:**
78```markdown
79# 🔍 Workspace Detection Complete
80 
81Workspace analysis findings:
82• **Project Type**: Brownfield project
83• [AI-generated summary of workspace findings in bullet points]
84• **Next Step**: Proceeding to **Reverse Engineering** to analyze existing codebase...
85```
86 
87**For Greenfield Projects:**
88```markdown
89# 🔍 Workspace Detection Complete
90 
91Workspace analysis findings:
92• **Project Type**: Greenfield project
93• **Next Step**: Proceeding to **Requirements Analysis**...
94```
95 
96## Step 6: Automatically Proceed
97 
98- **No user approval required** - this is informational only
99- Automatically proceed to next phase:
100  - **Brownfield**: Reverse Engineering (if no existing artifacts) or Requirements Analysis (if artifacts exist)
101  - **Greenfield**: Requirements Analysis
102