geminize 1.0.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (54) hide show
  1. checksums.yaml +4 -4
  2. data/.cursor/mcp.json +3 -0
  3. data/.cursor/rules/isolation_rules/Core/command-execution.mdc +235 -0
  4. data/.cursor/rules/isolation_rules/Core/complexity-decision-tree.mdc +187 -0
  5. data/.cursor/rules/isolation_rules/Core/creative-phase-enforcement.mdc +145 -0
  6. data/.cursor/rules/isolation_rules/Core/creative-phase-metrics.mdc +195 -0
  7. data/.cursor/rules/isolation_rules/Core/file-verification.mdc +198 -0
  8. data/.cursor/rules/isolation_rules/Core/platform-awareness.mdc +71 -0
  9. data/.cursor/rules/isolation_rules/Level3/planning-comprehensive.mdc +159 -0
  10. data/.cursor/rules/isolation_rules/Level3/task-tracking-intermediate.mdc +135 -0
  11. data/.cursor/rules/isolation_rules/Phases/CreativePhase/creative-phase-architecture.mdc +187 -0
  12. data/.cursor/rules/isolation_rules/main.mdc +123 -0
  13. data/.cursor/rules/isolation_rules/visual-maps/archive-mode-map.mdc +277 -0
  14. data/.cursor/rules/isolation_rules/visual-maps/creative-mode-map.mdc +224 -0
  15. data/.cursor/rules/isolation_rules/visual-maps/implement-mode-map.mdc +321 -0
  16. data/.cursor/rules/isolation_rules/visual-maps/plan-mode-map.mdc +269 -0
  17. data/.cursor/rules/isolation_rules/visual-maps/qa-mode-map.mdc +495 -0
  18. data/.cursor/rules/isolation_rules/visual-maps/reflect-mode-map.mdc +234 -0
  19. data/.cursor/rules/isolation_rules/visual-maps/van-mode-map.mdc +902 -0
  20. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-complexity-determination.mdc +60 -0
  21. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-file-verification.mdc +49 -0
  22. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-mode-map.mdc +49 -0
  23. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-platform-detection.mdc +50 -0
  24. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-checks/build-test.mdc +117 -0
  25. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-checks/config-check.mdc +103 -0
  26. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-checks/dependency-check.mdc +147 -0
  27. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-checks/environment-check.mdc +104 -0
  28. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-checks/file-verification.mdc +1 -0
  29. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-main.mdc +142 -0
  30. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-utils/common-fixes.mdc +92 -0
  31. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-utils/mode-transitions.mdc +101 -0
  32. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-utils/reports.mdc +149 -0
  33. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-utils/rule-calling-guide.mdc +66 -0
  34. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-utils/rule-calling-help.mdc +19 -0
  35. data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-validation.md.old +363 -0
  36. data/.env.example +7 -0
  37. data/.memory_bank/activeContext.md +78 -0
  38. data/.memory_bank/progress.md +80 -0
  39. data/.memory_bank/projectbrief.md +29 -0
  40. data/.memory_bank/systemPatterns.md +90 -0
  41. data/.memory_bank/tasks.md +98 -0
  42. data/.memory_bank/techContext.md +73 -0
  43. data/.tool-versions +1 -0
  44. data/CHANGELOG.md +20 -0
  45. data/README.md +42 -5
  46. data/examples/models_api.rb +125 -0
  47. data/lib/geminize/configuration.rb +4 -4
  48. data/lib/geminize/model_info.rb +87 -8
  49. data/lib/geminize/models/model.rb +101 -109
  50. data/lib/geminize/models/model_list.rb +70 -28
  51. data/lib/geminize/request_builder.rb +29 -0
  52. data/lib/geminize/version.rb +1 -1
  53. data/lib/geminize.rb +71 -14
  54. metadata +45 -2
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: c08ca1105b496592ec06cd7b7aab2b1b9a1dde2cb0f1c31be6feda85281683a2
4
- data.tar.gz: ae7352a06b607dbd1e98cf30cd069551765156d088513a4cf780f94033d8ab89
3
+ metadata.gz: 1b3672d83fd6ff1d0a803808ee2c6d71681053229a84b3f33e0ea8b64b78dc74
4
+ data.tar.gz: 79eca877306a66edcf9dd6bfa3afc3dd1b1222c6127d4391cdc077944557a3bf
5
5
  SHA512:
6
- metadata.gz: 9041ba768b03996f4b2a6fdd9d45dd9a1430298d6d555e54951a9736e24ac713397b1010ffb640bd3a3bcb5b647eb37d15193852e0df31cdfb9bafe6da6a6779
7
- data.tar.gz: 3a99e5d5a7e2a7b1d3b8ac7d6ca3450a8a54dd4636b614fa53b4e6175e0ead68981ecb7390b00f9d6c7f5f4fd3bcb9bb44e46b84d9e97702cdca7803227fc022
6
+ metadata.gz: 81c4a2324a026449c00e983a2ad0f7e4e89e5d77564a62b6e7d430303eeeb129f32002f0c9a41055b4001044ec6272386ebba920e3e0565b8ac8c61f7bbc2d5d
7
+ data.tar.gz: 7aeb4afe504891c0849f83b04d3afc7b50fa45c1b60d6ae5ebcaea681b403e13c1bc86613694713162fff8ab220b0f447fedf808f0611fb0dbfb7476a2243148
data/.cursor/mcp.json ADDED
@@ -0,0 +1,3 @@
1
+ {
2
+ "mcpServers": {}
3
+ }
@@ -0,0 +1,235 @@
1
+ ---
2
+ description: Command execution guidelines for isolation-focused Memory Bank
3
+ globs: command-execution.mdc
4
+ alwaysApply: false
5
+ ---
6
+
7
+ # COMMAND EXECUTION SYSTEM
8
+
9
+ > **TL;DR:** This system provides guidelines for efficient command execution, balancing clarity and token optimization through appropriate command chaining, with proper documentation of commands and results.
10
+
11
+ ## 🔍 COMMAND EFFICIENCY WORKFLOW
12
+
13
+ ```mermaid
14
+ graph TD
15
+ Start["Command<br>Planning"] --> Analyze["Analyze Command<br>Requirements"]
16
+ Analyze --> Balance["Balance Clarity<br>vs. Efficiency"]
17
+ Balance --> Complexity{"Command<br>Complexity?"}
18
+
19
+ Complexity -->|"Simple"| Single["Execute<br>Single Command"]
20
+ Complexity -->|"Moderate"| Chain["Use Efficient<br>Command Chaining"]
21
+ Complexity -->|"Complex"| Group["Group Into<br>Logical Steps"]
22
+
23
+ Single & Chain & Group --> Verify["Verify<br>Results"]
24
+ Verify --> Document["Document<br>Command & Result"]
25
+ Document --> Next["Next<br>Command"]
26
+ ```
27
+
28
+ ## 📋 COMMAND CHAINING GUIDELINES
29
+
30
+ ```mermaid
31
+ graph TD
32
+ Command["Command<br>Execution"] --> ChainApprop{"Is Chaining<br>Appropriate?"}
33
+
34
+ ChainApprop -->|"Yes"| ChainTypes["Chain<br>Types"]
35
+ ChainApprop -->|"No"| SingleCmd["Use Single<br>Commands"]
36
+
37
+ ChainTypes --> Sequential["Sequential Operations<br>cmd1 && cmd2"]
38
+ ChainTypes --> Conditional["Conditional Operations<br>cmd1 || cmd2"]
39
+ ChainTypes --> Piping["Piping<br>cmd1 | cmd2"]
40
+ ChainTypes --> Grouping["Command Grouping<br>(cmd1; cmd2)"]
41
+
42
+ Sequential & Conditional & Piping & Grouping --> Doc["Document<br>Commands & Results"]
43
+ ```
44
+
45
+ ## 🚦 DIRECTORY VERIFICATION WORKFLOW
46
+
47
+ ```mermaid
48
+ graph TD
49
+ Command["Command<br>Execution"] --> DirCheck["Check Current<br>Directory"]
50
+ DirCheck --> ProjectRoot{"In Project<br>Root?"}
51
+
52
+ ProjectRoot -->|"Yes"| Execute["Execute<br>Command"]
53
+ ProjectRoot -->|"No"| Locate["Locate<br>Project Root"]
54
+
55
+ Locate --> Found{"Project Root<br>Found?"}
56
+ Found -->|"Yes"| Navigate["Navigate to<br>Project Root"]
57
+ Found -->|"No"| Error["Error: Cannot<br>Find Project Root"]
58
+
59
+ Navigate --> Execute
60
+ Execute --> Verify["Verify<br>Results"]
61
+ ```
62
+
63
+ ## 📋 DIRECTORY VERIFICATION CHECKLIST
64
+
65
+ Before executing any npm or build command:
66
+
67
+ | Step | Windows (PowerShell) | Unix/Linux/Mac | Purpose |
68
+ |------|----------------------|----------------|---------|
69
+ | **Check package.json** | `Test-Path package.json` | `ls package.json` | Verify current directory is project root |
70
+ | **Check for parent directory** | `Test-Path "*/package.json"` | `find . -maxdepth 2 -name package.json` | Find potential project directories |
71
+ | **Navigate to project root** | `cd [project-dir]` | `cd [project-dir]` | Move to correct directory before executing commands |
72
+
73
+ ## 📋 REACT-SPECIFIC COMMAND GUIDELINES
74
+
75
+ For React applications, follow these strict guidelines:
76
+
77
+ | Command | Correct Usage | Incorrect Usage | Notes |
78
+ |---------|---------------|----------------|-------|
79
+ | **npm start** | `cd [project-root] && npm start` | `npm start` (from parent dir) | Must execute from directory with package.json |
80
+ | **npm run build** | `cd [project-root] && npm run build` | `cd [parent-dir] && npm run build` | Must execute from directory with package.json |
81
+ | **npm install** | `cd [project-root] && npm install [pkg]` | `npm install [pkg]` (wrong dir) | Dependencies installed to nearest package.json |
82
+ | **npm create** | `npm create vite@latest my-app -- --template react` | Manually configuring webpack | Use standard tools for project creation |
83
+
84
+ ## 🔄 COMMAND CHAINING PATTERNS
85
+
86
+ Effective command chaining patterns include:
87
+
88
+ | Pattern | Format | Examples | Use Case |
89
+ |---------|--------|----------|----------|
90
+ | **Sequential** | `cmd1 && cmd2` | `mkdir dir && cd dir` | Commands that should run in sequence, second only if first succeeds |
91
+ | **Conditional** | `cmd1 || cmd2` | `test -f file.txt || touch file.txt` | Fallback commands, second only if first fails |
92
+ | **Piping** | `cmd1 \| cmd2` | `grep "pattern" file.txt \| wc -l` | Pass output of first command as input to second |
93
+ | **Background** | `cmd &` | `npm start &` | Run command in background |
94
+ | **Grouping** | `(cmd1; cmd2)` | `(echo "Start"; npm test; echo "End")` | Group commands to run as a unit |
95
+
96
+ ## 📋 COMMAND DOCUMENTATION TEMPLATE
97
+
98
+ ```
99
+ ## Command Execution: [Purpose]
100
+
101
+ ### Command
102
+ ```
103
+ [actual command or chain]
104
+ ```
105
+
106
+ ### Result
107
+ ```
108
+ [command output]
109
+ ```
110
+
111
+ ### Effect
112
+ [Brief description of what changed in the system]
113
+
114
+ ### Next Steps
115
+ [What needs to be done next]
116
+ ```
117
+
118
+ ## 🔍 PLATFORM-SPECIFIC CONSIDERATIONS
119
+
120
+ ```mermaid
121
+ graph TD
122
+ Platform["Platform<br>Detection"] --> Windows["Windows<br>Commands"]
123
+ Platform --> Unix["Unix/Linux/Mac<br>Commands"]
124
+
125
+ Windows --> WinAdapt["Windows Command<br>Adaptations"]
126
+ Unix --> UnixAdapt["Unix Command<br>Adaptations"]
127
+
128
+ WinAdapt --> WinChain["Windows Chaining:<br>Commands separated by &"]
129
+ UnixAdapt --> UnixChain["Unix Chaining:<br>Commands separated by ;"]
130
+
131
+ WinChain & UnixChain --> Execute["Execute<br>Platform-Specific<br>Commands"]
132
+ ```
133
+
134
+ ## 📋 COMMAND EFFICIENCY EXAMPLES
135
+
136
+ Examples of efficient command usage:
137
+
138
+ | Inefficient | Efficient | Explanation |
139
+ |-------------|-----------|-------------|
140
+ | `mkdir dir`<br>`cd dir`<br>`npm init -y` | `mkdir dir && cd dir && npm init -y` | Combines related sequential operations |
141
+ | `ls`<br>`grep "\.js$"` | `ls \| grep "\.js$"` | Pipes output of first command to second |
142
+ | `test -f file.txt`<br>`if not exists, touch file.txt` | `test -f file.txt \|\| touch file.txt` | Creates file only if it doesn't exist |
143
+ | `mkdir dir1`<br>`mkdir dir2`<br>`mkdir dir3` | `mkdir dir1 dir2 dir3` | Uses command's built-in multiple argument capability |
144
+ | `npm install pkg1`<br>`npm install pkg2` | `npm install pkg1 pkg2` | Installs multiple packages in one command |
145
+
146
+ ## 📋 REACT PROJECT INITIALIZATION STANDARDS
147
+
148
+ Always use these standard approaches for React project creation:
149
+
150
+ | Approach | Command | Benefits | Avoids |
151
+ |----------|---------|----------|--------|
152
+ | **Create React App** | `npx create-react-app my-app` | Preconfigured webpack & babel | Manual configuration errors |
153
+ | **Create React App w/TypeScript** | `npx create-react-app my-app --template typescript` | Type safety + preconfigured | Inconsistent module systems |
154
+ | **Vite** | `npm create vite@latest my-app -- --template react` | Faster build times | Complex webpack setups |
155
+ | **Next.js** | `npx create-next-app@latest my-app` | SSR support | Module system conflicts |
156
+
157
+ ## ⚠️ ERROR HANDLING WORKFLOW
158
+
159
+ ```mermaid
160
+ sequenceDiagram
161
+ participant User
162
+ participant AI
163
+ participant System
164
+
165
+ AI->>System: Execute Command
166
+ System->>AI: Return Result
167
+
168
+ alt Success
169
+ AI->>AI: Verify Expected Result
170
+ AI->>User: Report Success
171
+ else Error
172
+ AI->>AI: Analyze Error Message
173
+ AI->>AI: Identify Likely Cause
174
+ AI->>User: Explain Error & Cause
175
+ AI->>User: Suggest Corrective Action
176
+ User->>AI: Approve Correction
177
+ AI->>System: Execute Corrected Command
178
+ end
179
+ ```
180
+
181
+ ## 📋 COMMAND RESULT VERIFICATION
182
+
183
+ After command execution, verify:
184
+
185
+ ```mermaid
186
+ graph TD
187
+ Execute["Execute<br>Command"] --> Check{"Check<br>Result"}
188
+
189
+ Check -->|"Success"| Verify["Verify Expected<br>Outcome"]
190
+ Check -->|"Error"| Analyze["Analyze<br>Error"]
191
+
192
+ Verify -->|"Expected"| Document["Document<br>Success"]
193
+ Verify -->|"Unexpected"| Investigate["Investigate<br>Unexpected Result"]
194
+
195
+ Analyze --> Diagnose["Diagnose<br>Error Cause"]
196
+ Diagnose --> Correct["Propose<br>Correction"]
197
+
198
+ Document & Investigate & Correct --> Next["Next Step<br>in Process"]
199
+ ```
200
+
201
+ ## 📝 COMMAND EXECUTION CHECKLIST
202
+
203
+ ```
204
+ ✓ COMMAND EXECUTION CHECKLIST
205
+ - Command purpose clearly identified? [YES/NO]
206
+ - Appropriate balance of clarity vs. efficiency? [YES/NO]
207
+ - Platform-specific considerations addressed? [YES/NO]
208
+ - Command documented with results? [YES/NO]
209
+ - Outcome verified against expectations? [YES/NO]
210
+ - Errors properly handled (if any)? [YES/NO/NA]
211
+ - For npm/build commands: Executed from project root? [YES/NO/NA]
212
+ - For React projects: Using standard tooling? [YES/NO/NA]
213
+
214
+ → If all YES: Command execution complete
215
+ → If any NO: Address missing elements
216
+ ```
217
+
218
+ ## 🚨 COMMAND EXECUTION WARNINGS
219
+
220
+ Avoid these common command issues:
221
+
222
+ ```mermaid
223
+ graph TD
224
+ Warning["Command<br>Warnings"] --> W1["Excessive<br>Verbosity"]
225
+ Warning --> W2["Insufficient<br>Error Handling"]
226
+ Warning --> W3["Unnecessary<br>Complexity"]
227
+ Warning --> W4["Destructive<br>Operations Without<br>Confirmation"]
228
+ Warning --> W5["Wrong Directory<br>Execution"]
229
+
230
+ W1 --> S1["Use flags to reduce<br>unnecessary output"]
231
+ W2 --> S2["Include error handling<br>in command chains"]
232
+ W3 --> S3["Prefer built-in<br>command capabilities"]
233
+ W4 --> S4["Show confirmation<br>before destructive actions"]
234
+ W5 --> S5["Verify directory before<br>npm/build commands"]
235
+ ```
@@ -0,0 +1,187 @@
1
+ ---
2
+ description: complexity decision tree
3
+ globs: complexity-decision-tree.mdc
4
+ alwaysApply: false
5
+ ---
6
+ # TASK COMPLEXITY DETERMINATION
7
+
8
+ > **TL;DR:** This document helps determine the appropriate complexity level (1-4) for any task. Use the decision tree and indicators to select the right process level, then load the corresponding process map.
9
+
10
+ ## 🌳 COMPLEXITY DECISION TREE
11
+
12
+ ```mermaid
13
+ graph TD
14
+ Start["New Task"] --> Q1{"Bug fix or<br>error correction?"}
15
+ Q1 -->|Yes| Q1a{"Affects single<br>component?"}
16
+ Q1a -->|Yes| L1["Level 1:<br>Quick Bug Fix"]
17
+ Q1a -->|No| Q1b{"Affects multiple<br>components?"}
18
+ Q1b -->|Yes| L2["Level 2:<br>Simple Enhancement"]
19
+ Q1b -->|No| Q1c{"Affects system<br>architecture?"}
20
+ Q1c -->|Yes| L3["Level 3:<br>Intermediate Feature"]
21
+ Q1c -->|No| L2
22
+
23
+ Q1 -->|No| Q2{"Adding small<br>feature or<br>enhancement?"}
24
+ Q2 -->|Yes| Q2a{"Self-contained<br>change?"}
25
+ Q2a -->|Yes| L2
26
+ Q2a -->|No| Q2b{"Affects multiple<br>components?"}
27
+ Q2b -->|Yes| L3
28
+ Q2b -->|No| L2
29
+
30
+ Q2 -->|No| Q3{"Complete feature<br>requiring multiple<br>components?"}
31
+ Q3 -->|Yes| Q3a{"Architectural<br>implications?"}
32
+ Q3a -->|Yes| L4["Level 4:<br>Complex System"]
33
+ Q3a -->|No| L3
34
+
35
+ Q3 -->|No| Q4{"System-wide or<br>architectural<br>change?"}
36
+ Q4 -->|Yes| L4
37
+ Q4 -->|No| L3
38
+
39
+ L1 --> LoadL1["Load Level 1 Map"]
40
+ L2 --> LoadL2["Load Level 2 Map"]
41
+ L3 --> LoadL3["Load Level 3 Map"]
42
+ L4 --> LoadL4["Load Level 4 Map"]
43
+ ```
44
+
45
+ ## 📊 COMPLEXITY LEVEL INDICATORS
46
+
47
+ Use these indicators to help determine task complexity:
48
+
49
+ ### Level 1: Quick Bug Fix
50
+ - **Keywords**: "fix", "broken", "not working", "issue", "bug", "error", "crash"
51
+ - **Scope**: Single component or UI element
52
+ - **Duration**: Can be completed quickly (minutes to hours)
53
+ - **Risk**: Low, isolated changes
54
+ - **Examples**:
55
+ - Fix button not working
56
+ - Correct styling issue
57
+ - Fix validation error
58
+ - Resolve broken link
59
+ - Fix typo or text issue
60
+
61
+ ### Level 2: Simple Enhancement
62
+ - **Keywords**: "add", "improve", "update", "change", "enhance", "modify"
63
+ - **Scope**: Single component or subsystem
64
+ - **Duration**: Hours to 1-2 days
65
+ - **Risk**: Moderate, contained to specific area
66
+ - **Examples**:
67
+ - Add form field
68
+ - Improve validation
69
+ - Update styling
70
+ - Add simple feature
71
+ - Change text content
72
+ - Enhance existing component
73
+
74
+ ### Level 3: Intermediate Feature
75
+ - **Keywords**: "implement", "create", "develop", "build", "feature"
76
+ - **Scope**: Multiple components, complete feature
77
+ - **Duration**: Days to 1-2 weeks
78
+ - **Risk**: Significant, affects multiple areas
79
+ - **Examples**:
80
+ - Implement user authentication
81
+ - Create dashboard
82
+ - Develop search functionality
83
+ - Build user profile system
84
+ - Implement data visualization
85
+ - Create complex form system
86
+
87
+ ### Level 4: Complex System
88
+ - **Keywords**: "system", "architecture", "redesign", "integration", "framework"
89
+ - **Scope**: Multiple subsystems or entire application
90
+ - **Duration**: Weeks to months
91
+ - **Risk**: High, architectural implications
92
+ - **Examples**:
93
+ - Implement authentication system
94
+ - Build payment processing framework
95
+ - Create microservice architecture
96
+ - Implement database migration system
97
+ - Develop real-time communication system
98
+ - Create multi-tenant architecture
99
+
100
+ ## 🔍 COMPLEXITY ASSESSMENT QUESTIONS
101
+
102
+ Answer these questions to determine complexity:
103
+
104
+ 1. **Scope Impact**
105
+ - Does it affect a single component or multiple?
106
+ - Are there system-wide implications?
107
+ - How many files will need to be modified?
108
+
109
+ 2. **Design Decisions**
110
+ - Are complex design decisions required?
111
+ - Will it require creative phases for design?
112
+ - Are there architectural considerations?
113
+
114
+ 3. **Risk Assessment**
115
+ - What happens if it fails?
116
+ - Are there security implications?
117
+ - Will it affect critical functionality?
118
+
119
+ 4. **Implementation Effort**
120
+ - How long will it take to implement?
121
+ - Does it require specialized knowledge?
122
+ - Is extensive testing needed?
123
+
124
+ ## 📊 KEYWORD ANALYSIS TABLE
125
+
126
+ | Keyword | Likely Level | Notes |
127
+ |---------|--------------|-------|
128
+ | "Fix" | Level 1 | Unless system-wide |
129
+ | "Bug" | Level 1 | Unless multiple components |
130
+ | "Error" | Level 1 | Unless architectural |
131
+ | "Add" | Level 2 | Unless complex feature |
132
+ | "Update" | Level 2 | Unless architectural |
133
+ | "Improve" | Level 2 | Unless system-wide |
134
+ | "Implement" | Level 3 | Complex components |
135
+ | "Create" | Level 3 | New functionality |
136
+ | "Develop" | Level 3 | Significant scope |
137
+ | "System" | Level 4 | Architectural implications |
138
+ | "Architecture" | Level 4 | Major structural changes |
139
+ | "Framework" | Level 4 | Core infrastructure |
140
+
141
+ ## 🔄 COMPLEXITY ESCALATION
142
+
143
+ If during a task you discover it's more complex than initially determined:
144
+
145
+ ```
146
+ ⚠️ TASK ESCALATION NEEDED
147
+ Current Level: Level [X]
148
+ Recommended Level: Level [Y]
149
+ Reason: [Brief explanation]
150
+
151
+ Would you like me to escalate this task to Level [Y]?
152
+ ```
153
+
154
+ If approved, switch to the appropriate higher-level process map.
155
+
156
+ ## 🎯 PROCESS SELECTION
157
+
158
+ After determining complexity, load the appropriate process map:
159
+
160
+ | Level | Description | Process Map |
161
+ |-------|-------------|-------------|
162
+ | 1 | Quick Bug Fix | [Level 1 Map](mdc:.cursor/rules/visual-maps/level1-map.mdc) |
163
+ | 2 | Simple Enhancement | [Level 2 Map](mdc:.cursor/rules/visual-maps/level2-map.mdc) |
164
+ | 3 | Intermediate Feature | [Level 3 Map](mdc:.cursor/rules/visual-maps/level3-map.mdc) |
165
+ | 4 | Complex System | [Level 4 Map](mdc:.cursor/rules/visual-maps/level4-map.mdc) |
166
+
167
+ ## 📝 COMPLEXITY DETERMINATION TEMPLATE
168
+
169
+ Use this template to document complexity determination:
170
+
171
+ ```
172
+ ## COMPLEXITY DETERMINATION
173
+
174
+ Task: [Task description]
175
+
176
+ Assessment:
177
+ - Scope: [Single component/Multiple components/System-wide]
178
+ - Design decisions: [Simple/Moderate/Complex]
179
+ - Risk: [Low/Moderate/High]
180
+ - Implementation effort: [Low/Moderate/High]
181
+
182
+ Keywords identified: [List relevant keywords]
183
+
184
+ Determination: Level [1/2/3/4] - [Quick Bug Fix/Simple Enhancement/Intermediate Feature/Complex System]
185
+
186
+ Loading process map: [Level X Map]
187
+ ```
@@ -0,0 +1,145 @@
1
+ ---
2
+ description: creative phase enforcement
3
+ globs: creative-phase-enforcement.md
4
+ alwaysApply: false
5
+ ---
6
+
7
+ # CREATIVE PHASE ENFORCEMENT
8
+
9
+ > **TL;DR:** This document implements strict enforcement of creative phase requirements for Level 3-4 tasks, ensuring all design decisions are properly documented and verified before implementation can proceed.
10
+
11
+ ## 🔍 ENFORCEMENT WORKFLOW
12
+
13
+ ```mermaid
14
+ graph TD
15
+ Start["Task Start"] --> Check{"Level 3-4<br>Task?"}
16
+ Check -->|Yes| Analyze["Analyze Design<br>Decision Points"]
17
+ Check -->|No| Optional["Creative Phase<br>Optional"]
18
+
19
+ Analyze --> Decision{"Design Decisions<br>Required?"}
20
+ Decision -->|Yes| Gate["🚨 IMPLEMENTATION<br>BLOCKED"]
21
+ Decision -->|No| Allow["Allow<br>Implementation"]
22
+
23
+ Gate --> Creative["Enter Creative<br>Phase"]
24
+ Creative --> Verify{"All Decisions<br>Documented?"}
25
+ Verify -->|No| Return["Return to<br>Creative Phase"]
26
+ Verify -->|Yes| Proceed["Allow<br>Implementation"]
27
+
28
+ style Start fill:#4da6ff,stroke:#0066cc,color:white
29
+ style Check fill:#ffa64d,stroke:#cc7a30,color:white
30
+ style Analyze fill:#4dbb5f,stroke:#36873f,color:white
31
+ style Gate fill:#d94dbb,stroke:#a3378a,color:white
32
+ style Creative fill:#4dbbbb,stroke:#368787,color:white
33
+ style Verify fill:#d971ff,stroke:#a33bc2,color:white
34
+ ```
35
+
36
+ ## 🚨 ENFORCEMENT GATES
37
+
38
+ ```mermaid
39
+ graph TD
40
+ subgraph "CREATIVE PHASE GATES"
41
+ G1["Entry Gate<br>Verify Requirements"]
42
+ G2["Process Gate<br>Verify Progress"]
43
+ G3["Exit Gate<br>Verify Completion"]
44
+ end
45
+
46
+ G1 --> G2 --> G3
47
+
48
+ style G1 fill:#4dbb5f,stroke:#36873f,color:white
49
+ style G2 fill:#ffa64d,stroke:#cc7a30,color:white
50
+ style G3 fill:#d94dbb,stroke:#a3378a,color:white
51
+ ```
52
+
53
+ ## 📋 ENFORCEMENT CHECKLIST
54
+
55
+ ```markdown
56
+ ## Entry Gate Verification
57
+ - [ ] Task complexity is Level 3-4
58
+ - [ ] Design decisions identified
59
+ - [ ] Creative phase requirements documented
60
+ - [ ] Required participants notified
61
+
62
+ ## Process Gate Verification
63
+ - [ ] All options being considered
64
+ - [ ] Pros/cons documented
65
+ - [ ] Technical constraints identified
66
+ - [ ] Implementation impacts assessed
67
+
68
+ ## Exit Gate Verification
69
+ - [ ] All decisions documented
70
+ - [ ] Rationale provided for choices
71
+ - [ ] Implementation plan outlined
72
+ - [ ] Verification against requirements
73
+ ```
74
+
75
+ ## 🚨 IMPLEMENTATION BLOCK NOTICE
76
+
77
+ When a creative phase is required but not completed:
78
+
79
+ ```
80
+ 🚨 IMPLEMENTATION BLOCKED
81
+ Creative phases MUST be completed before implementation.
82
+
83
+ Required Creative Phases:
84
+ - [ ] [Creative Phase 1]
85
+ - [ ] [Creative Phase 2]
86
+ - [ ] [Creative Phase 3]
87
+
88
+ ⛔ This is a HARD BLOCK
89
+ Implementation CANNOT proceed until all creative phases are completed.
90
+ Type "PHASE.REVIEW" to begin creative phase review.
91
+ ```
92
+
93
+ ## ✅ VERIFICATION PROTOCOL
94
+
95
+ ```mermaid
96
+ graph TD
97
+ subgraph "VERIFICATION STEPS"
98
+ V1["1. Requirements<br>Check"]
99
+ V2["2. Documentation<br>Review"]
100
+ V3["3. Decision<br>Validation"]
101
+ V4["4. Implementation<br>Readiness"]
102
+ end
103
+
104
+ V1 --> V2 --> V3 --> V4
105
+
106
+ style V1 fill:#4dbb5f,stroke:#36873f,color:white
107
+ style V2 fill:#ffa64d,stroke:#cc7a30,color:white
108
+ style V3 fill:#d94dbb,stroke:#a3378a,color:white
109
+ style V4 fill:#4dbbbb,stroke:#368787,color:white
110
+ ```
111
+
112
+ ## 🔄 CREATIVE PHASE MARKERS
113
+
114
+ Use these markers to clearly indicate creative phase boundaries:
115
+
116
+ ```markdown
117
+ 🎨🎨🎨 ENTERING CREATIVE PHASE: [TYPE] 🎨🎨🎨
118
+ Focus: [Specific component/feature]
119
+ Objective: [Clear goal of this creative phase]
120
+ Requirements: [List of requirements]
121
+
122
+ [Creative phase content]
123
+
124
+ 🎨 CREATIVE CHECKPOINT: [Milestone]
125
+ - Progress: [Status]
126
+ - Decisions: [List]
127
+ - Next steps: [Plan]
128
+
129
+ 🎨🎨🎨 EXITING CREATIVE PHASE 🎨🎨🎨
130
+ Summary: [Brief description]
131
+ Key Decisions: [List]
132
+ Next Steps: [Implementation plan]
133
+ ```
134
+
135
+ ## 🔄 DOCUMENT MANAGEMENT
136
+
137
+ ```mermaid
138
+ graph TD
139
+ Current["Current Document"] --> Active["Active:<br>- creative-phase-enforcement.md"]
140
+ Current --> Related["Related:<br>- creative-phase-architecture.md<br>- task-tracking-intermediate.md"]
141
+
142
+ style Current fill:#4da6ff,stroke:#0066cc,color:white
143
+ style Active fill:#4dbb5f,stroke:#36873f,color:white
144
+ style Related fill:#ffa64d,stroke:#cc7a30,color:white
145
+ ```