geminize 1.0.0 → 1.2.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.
- checksums.yaml +4 -4
- data/.cursor/mcp.json +3 -0
- data/.cursor/rules/isolation_rules/Core/command-execution.mdc +235 -0
- data/.cursor/rules/isolation_rules/Core/complexity-decision-tree.mdc +187 -0
- data/.cursor/rules/isolation_rules/Core/creative-phase-enforcement.mdc +145 -0
- data/.cursor/rules/isolation_rules/Core/creative-phase-metrics.mdc +195 -0
- data/.cursor/rules/isolation_rules/Core/file-verification.mdc +198 -0
- data/.cursor/rules/isolation_rules/Core/platform-awareness.mdc +71 -0
- data/.cursor/rules/isolation_rules/Level3/planning-comprehensive.mdc +159 -0
- data/.cursor/rules/isolation_rules/Level3/task-tracking-intermediate.mdc +135 -0
- data/.cursor/rules/isolation_rules/Phases/CreativePhase/creative-phase-architecture.mdc +187 -0
- data/.cursor/rules/isolation_rules/main.mdc +123 -0
- data/.cursor/rules/isolation_rules/visual-maps/archive-mode-map.mdc +277 -0
- data/.cursor/rules/isolation_rules/visual-maps/creative-mode-map.mdc +224 -0
- data/.cursor/rules/isolation_rules/visual-maps/implement-mode-map.mdc +321 -0
- data/.cursor/rules/isolation_rules/visual-maps/plan-mode-map.mdc +269 -0
- data/.cursor/rules/isolation_rules/visual-maps/qa-mode-map.mdc +495 -0
- data/.cursor/rules/isolation_rules/visual-maps/reflect-mode-map.mdc +234 -0
- data/.cursor/rules/isolation_rules/visual-maps/van-mode-map.mdc +902 -0
- data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-complexity-determination.mdc +60 -0
- data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-file-verification.mdc +49 -0
- data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-mode-map.mdc +49 -0
- data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-platform-detection.mdc +50 -0
- data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-checks/build-test.mdc +117 -0
- data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-checks/config-check.mdc +103 -0
- data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-checks/dependency-check.mdc +147 -0
- data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-checks/environment-check.mdc +104 -0
- data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-checks/file-verification.mdc +1 -0
- data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-main.mdc +142 -0
- data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-utils/common-fixes.mdc +92 -0
- data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-utils/mode-transitions.mdc +101 -0
- data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-utils/reports.mdc +149 -0
- data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-utils/rule-calling-guide.mdc +66 -0
- data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-utils/rule-calling-help.mdc +19 -0
- data/.cursor/rules/isolation_rules/visual-maps/van_mode_split/van-qa-validation.md.old +363 -0
- data/.env.example +7 -0
- data/.memory_bank/activeContext.md +102 -0
- data/.memory_bank/progress.md +93 -0
- data/.memory_bank/projectbrief.md +45 -0
- data/.memory_bank/systemPatterns.md +90 -0
- data/.memory_bank/tasks.md +142 -0
- data/.memory_bank/techContext.md +73 -0
- data/.tool-versions +1 -0
- data/CHANGELOG.md +42 -0
- data/README.md +223 -5
- data/examples/function_calling.rb +218 -0
- data/examples/models_api.rb +125 -0
- data/examples/safety_settings.rb +82 -0
- data/lib/geminize/configuration.rb +4 -4
- data/lib/geminize/model_info.rb +87 -8
- data/lib/geminize/models/content_request_extensions.rb +219 -0
- data/lib/geminize/models/content_request_safety.rb +123 -0
- data/lib/geminize/models/content_response_extensions.rb +120 -0
- data/lib/geminize/models/function_declaration.rb +112 -0
- data/lib/geminize/models/function_response.rb +70 -0
- data/lib/geminize/models/model.rb +101 -109
- data/lib/geminize/models/model_list.rb +70 -28
- data/lib/geminize/models/safety_setting.rb +102 -0
- data/lib/geminize/models/tool.rb +47 -0
- data/lib/geminize/models/tool_config.rb +52 -0
- data/lib/geminize/module_extensions.rb +228 -0
- data/lib/geminize/module_safety.rb +135 -0
- data/lib/geminize/request_builder.rb +29 -0
- data/lib/geminize/version.rb +1 -1
- data/lib/geminize.rb +83 -14
- metadata +57 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 900c19e9cf075e32779e3ee2f4f4530fdced2c027e8bc393d05250c1b20e5dac
|
4
|
+
data.tar.gz: 7d1a9a2f365eff24d2625492916d578f661fd881263c1cd4101352d7b16780ce
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: b1e3a5235a330b9bba4690a2452992f331bf4b76294109e2d4a8beb3fbc357c3f06be8b9728d607aff8653367458827bf17b166a1c89c6d243062272e747b154
|
7
|
+
data.tar.gz: a9c73fc3264fccaa26ba6b525d89807a9a99052232c12387281844d1cca821609c795fe199ed222c601962e8f144fc73854b73eccc75994fc3ab6ac70e4f7b2d
|
data/.cursor/mcp.json
ADDED
@@ -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
|
+
```
|