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.
- 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 +78 -0
- data/.memory_bank/progress.md +80 -0
- data/.memory_bank/projectbrief.md +29 -0
- data/.memory_bank/systemPatterns.md +90 -0
- data/.memory_bank/tasks.md +98 -0
- data/.memory_bank/techContext.md +73 -0
- data/.tool-versions +1 -0
- data/CHANGELOG.md +20 -0
- data/README.md +42 -5
- data/examples/models_api.rb +125 -0
- data/lib/geminize/configuration.rb +4 -4
- data/lib/geminize/model_info.rb +87 -8
- data/lib/geminize/models/model.rb +101 -109
- data/lib/geminize/models/model_list.rb +70 -28
- data/lib/geminize/request_builder.rb +29 -0
- data/lib/geminize/version.rb +1 -1
- data/lib/geminize.rb +71 -14
- metadata +45 -2
@@ -0,0 +1,195 @@
|
|
1
|
+
---
|
2
|
+
description: creative phase metrics
|
3
|
+
globs: creative-phase-metrics.md
|
4
|
+
alwaysApply: false
|
5
|
+
---
|
6
|
+
|
7
|
+
|
8
|
+
|
9
|
+
# CREATIVE PHASE METRICS
|
10
|
+
|
11
|
+
> **TL;DR:** This document defines comprehensive quality metrics and measurement criteria for creative phases, ensuring that design decisions meet required standards and are properly documented.
|
12
|
+
|
13
|
+
## ๐ METRICS OVERVIEW
|
14
|
+
|
15
|
+
```mermaid
|
16
|
+
graph TD
|
17
|
+
subgraph "CREATIVE PHASE METRICS"
|
18
|
+
M1["Documentation<br>Quality"]
|
19
|
+
M2["Decision<br>Coverage"]
|
20
|
+
M3["Option<br>Analysis"]
|
21
|
+
M4["Impact<br>Assessment"]
|
22
|
+
M5["Verification<br>Score"]
|
23
|
+
end
|
24
|
+
|
25
|
+
M1 --> Score["Quality<br>Score"]
|
26
|
+
M2 --> Score
|
27
|
+
M3 --> Score
|
28
|
+
M4 --> Score
|
29
|
+
M5 --> Score
|
30
|
+
|
31
|
+
style M1 fill:#4dbb5f,stroke:#36873f,color:white
|
32
|
+
style M2 fill:#ffa64d,stroke:#cc7a30,color:white
|
33
|
+
style M3 fill:#d94dbb,stroke:#a3378a,color:white
|
34
|
+
style M4 fill:#4dbbbb,stroke:#368787,color:white
|
35
|
+
style M5 fill:#d971ff,stroke:#a33bc2,color:white
|
36
|
+
style Score fill:#ff71c2,stroke:#c23b8a,color:white
|
37
|
+
```
|
38
|
+
|
39
|
+
## ๐ QUALITY METRICS SCORECARD
|
40
|
+
|
41
|
+
```markdown
|
42
|
+
# Creative Phase Quality Assessment
|
43
|
+
|
44
|
+
## 1. Documentation Quality [0-10]
|
45
|
+
- [ ] Clear problem statement (2 points)
|
46
|
+
- [ ] Well-defined objectives (2 points)
|
47
|
+
- [ ] Comprehensive requirements list (2 points)
|
48
|
+
- [ ] Proper formatting and structure (2 points)
|
49
|
+
- [ ] Cross-references to related documents (2 points)
|
50
|
+
|
51
|
+
## 2. Decision Coverage [0-10]
|
52
|
+
- [ ] All required decisions identified (2 points)
|
53
|
+
- [ ] Each decision point documented (2 points)
|
54
|
+
- [ ] Dependencies mapped (2 points)
|
55
|
+
- [ ] Impact analysis included (2 points)
|
56
|
+
- [ ] Future considerations noted (2 points)
|
57
|
+
|
58
|
+
## 3. Option Analysis [0-10]
|
59
|
+
- [ ] Multiple options considered (2 points)
|
60
|
+
- [ ] Pros/cons documented (2 points)
|
61
|
+
- [ ] Technical feasibility assessed (2 points)
|
62
|
+
- [ ] Resource requirements estimated (2 points)
|
63
|
+
- [ ] Risk factors identified (2 points)
|
64
|
+
|
65
|
+
## 4. Impact Assessment [0-10]
|
66
|
+
- [ ] System impact documented (2 points)
|
67
|
+
- [ ] Performance implications assessed (2 points)
|
68
|
+
- [ ] Security considerations addressed (2 points)
|
69
|
+
- [ ] Maintenance impact evaluated (2 points)
|
70
|
+
- [ ] Cost implications analyzed (2 points)
|
71
|
+
|
72
|
+
## 5. Verification Score [0-10]
|
73
|
+
- [ ] Requirements traced (2 points)
|
74
|
+
- [ ] Constraints validated (2 points)
|
75
|
+
- [ ] Test scenarios defined (2 points)
|
76
|
+
- [ ] Review feedback incorporated (2 points)
|
77
|
+
- [ ] Final verification completed (2 points)
|
78
|
+
|
79
|
+
Total Score: [Sum of all categories] / 50
|
80
|
+
Minimum Required Score: 40/50 (80%)
|
81
|
+
```
|
82
|
+
|
83
|
+
## ๐ QUALITY THRESHOLDS
|
84
|
+
|
85
|
+
```mermaid
|
86
|
+
graph TD
|
87
|
+
subgraph "QUALITY GATES"
|
88
|
+
T1["Minimum<br>40/50 (80%)"]
|
89
|
+
T2["Target<br>45/50 (90%)"]
|
90
|
+
T3["Excellent<br>48/50 (96%)"]
|
91
|
+
end
|
92
|
+
|
93
|
+
Score["Quality<br>Score"] --> Check{"Meets<br>Threshold?"}
|
94
|
+
Check -->|"< 80%"| Block["โ BLOCKED<br>Improvements Required"]
|
95
|
+
Check -->|"โฅ 80%"| Pass["โ PASSED<br>Can Proceed"]
|
96
|
+
|
97
|
+
style T1 fill:#4dbb5f,stroke:#36873f,color:white
|
98
|
+
style T2 fill:#ffa64d,stroke:#cc7a30,color:white
|
99
|
+
style T3 fill:#d94dbb,stroke:#a3378a,color:white
|
100
|
+
style Score fill:#4dbbbb,stroke:#368787,color:white
|
101
|
+
style Check fill:#d971ff,stroke:#a33bc2,color:white
|
102
|
+
```
|
103
|
+
|
104
|
+
## ๐ฏ METRIC EVALUATION PROCESS
|
105
|
+
|
106
|
+
```mermaid
|
107
|
+
graph TD
|
108
|
+
Start["Start<br>Evaluation"] --> Doc["1. Score<br>Documentation"]
|
109
|
+
Doc --> Dec["2. Assess<br>Decisions"]
|
110
|
+
Dec --> Opt["3. Review<br>Options"]
|
111
|
+
Opt --> Imp["4. Evaluate<br>Impact"]
|
112
|
+
Imp --> Ver["5. Verify<br>Completeness"]
|
113
|
+
Ver --> Total["Calculate<br>Total Score"]
|
114
|
+
Total --> Check{"Meets<br>Threshold?"}
|
115
|
+
Check -->|No| Return["Return for<br>Improvements"]
|
116
|
+
Check -->|Yes| Proceed["Proceed to<br>Next Phase"]
|
117
|
+
|
118
|
+
style Start fill:#4da6ff,stroke:#0066cc,color:white
|
119
|
+
style Doc fill:#ffa64d,stroke:#cc7a30,color:white
|
120
|
+
style Dec fill:#4dbb5f,stroke:#36873f,color:white
|
121
|
+
style Opt fill:#d94dbb,stroke:#a3378a,color:white
|
122
|
+
style Imp fill:#4dbbbb,stroke:#368787,color:white
|
123
|
+
style Ver fill:#d971ff,stroke:#a33bc2,color:white
|
124
|
+
```
|
125
|
+
|
126
|
+
## ๐ IMPROVEMENT RECOMMENDATIONS
|
127
|
+
|
128
|
+
For scores below threshold:
|
129
|
+
|
130
|
+
```markdown
|
131
|
+
## Documentation Quality Improvements
|
132
|
+
- Add clear problem statements
|
133
|
+
- Include specific objectives
|
134
|
+
- List all requirements
|
135
|
+
- Improve formatting
|
136
|
+
- Add cross-references
|
137
|
+
|
138
|
+
## Decision Coverage Improvements
|
139
|
+
- Identify missing decisions
|
140
|
+
- Document all decision points
|
141
|
+
- Map dependencies
|
142
|
+
- Add impact analysis
|
143
|
+
- Consider future implications
|
144
|
+
|
145
|
+
## Option Analysis Improvements
|
146
|
+
- Consider more alternatives
|
147
|
+
- Detail pros/cons
|
148
|
+
- Assess technical feasibility
|
149
|
+
- Estimate resource needs
|
150
|
+
- Identify risks
|
151
|
+
|
152
|
+
## Impact Assessment Improvements
|
153
|
+
- Document system impact
|
154
|
+
- Assess performance
|
155
|
+
- Address security
|
156
|
+
- Evaluate maintenance
|
157
|
+
- Analyze costs
|
158
|
+
|
159
|
+
## Verification Improvements
|
160
|
+
- Trace requirements
|
161
|
+
- Validate constraints
|
162
|
+
- Define test scenarios
|
163
|
+
- Incorporate feedback
|
164
|
+
- Complete verification
|
165
|
+
```
|
166
|
+
|
167
|
+
## โ
METRICS VERIFICATION CHECKLIST
|
168
|
+
|
169
|
+
```markdown
|
170
|
+
## Pre-Review Verification
|
171
|
+
- [ ] All sections scored
|
172
|
+
- [ ] Calculations verified
|
173
|
+
- [ ] Supporting evidence attached
|
174
|
+
- [ ] Improvement areas identified
|
175
|
+
- [ ] Review feedback incorporated
|
176
|
+
|
177
|
+
## Final Metrics Verification
|
178
|
+
- [ ] Minimum score achieved
|
179
|
+
- [ ] All categories passed
|
180
|
+
- [ ] Documentation complete
|
181
|
+
- [ ] Improvements addressed
|
182
|
+
- [ ] Final approval obtained
|
183
|
+
```
|
184
|
+
|
185
|
+
## ๐ DOCUMENT MANAGEMENT
|
186
|
+
|
187
|
+
```mermaid
|
188
|
+
graph TD
|
189
|
+
Current["Current Document"] --> Active["Active:<br>- creative-phase-metrics.md"]
|
190
|
+
Current --> Related["Related:<br>- creative-phase-enforcement.md<br>- creative-phase-architecture.md"]
|
191
|
+
|
192
|
+
style Current fill:#4da6ff,stroke:#0066cc,color:white
|
193
|
+
style Active fill:#4dbb5f,stroke:#36873f,color:white
|
194
|
+
style Related fill:#ffa64d,stroke:#cc7a30,color:white
|
195
|
+
```
|
@@ -0,0 +1,198 @@
|
|
1
|
+
---
|
2
|
+
description: Optimized file verification
|
3
|
+
globs: file-verification.mdc
|
4
|
+
alwaysApply: false
|
5
|
+
---
|
6
|
+
# OPTIMIZED FILE VERIFICATION SYSTEM
|
7
|
+
|
8
|
+
> **TL;DR:** This system efficiently verifies and creates required Memory Bank file structures using batch operations and platform-optimized commands.
|
9
|
+
|
10
|
+
## ๐ OPTIMIZED FILE VERIFICATION WORKFLOW
|
11
|
+
|
12
|
+
```mermaid
|
13
|
+
graph TD
|
14
|
+
Start["Start File<br>Verification"] --> VerifyAll["Verify All<br>Required Components"]
|
15
|
+
VerifyAll --> MissingCheck{"Missing<br>Components?"}
|
16
|
+
MissingCheck -->|"Yes"| BatchCreate["Batch Create<br>All Missing Items"]
|
17
|
+
MissingCheck -->|"No"| Complete["Verification<br>Complete"]
|
18
|
+
BatchCreate --> Report["Generate<br>Verification Report"]
|
19
|
+
Report --> Complete
|
20
|
+
```
|
21
|
+
|
22
|
+
## ๐ OPTIMIZED DIRECTORY CREATION
|
23
|
+
|
24
|
+
```mermaid
|
25
|
+
graph TD
|
26
|
+
Start["Directory<br>Creation"] --> DetectOS["Detect Operating<br>System"]
|
27
|
+
DetectOS -->|"Windows"| WinCmd["Batch Create<br>Windows Command"]
|
28
|
+
DetectOS -->|"Mac/Linux"| UnixCmd["Batch Create<br>Unix Command"]
|
29
|
+
WinCmd & UnixCmd --> Verify["Verify<br>Creation Success"]
|
30
|
+
Verify --> Complete["Directory Setup<br>Complete"]
|
31
|
+
```
|
32
|
+
|
33
|
+
### Platform-Specific Commands
|
34
|
+
|
35
|
+
#### Windows (PowerShell)
|
36
|
+
```powershell
|
37
|
+
# Create all directories in one command
|
38
|
+
mkdir memory-bank, docs, docs\archive -ErrorAction SilentlyContinue
|
39
|
+
|
40
|
+
# Create all required files
|
41
|
+
$files = @(".cursorrules", "tasks.md",
|
42
|
+
"memory-bank\projectbrief.md",
|
43
|
+
"memory-bank\productContext.md",
|
44
|
+
"memory-bank\systemPatterns.md",
|
45
|
+
"memory-bank\techContext.md",
|
46
|
+
"memory-bank\activeContext.md",
|
47
|
+
"memory-bank\progress.md")
|
48
|
+
|
49
|
+
foreach ($file in $files) {
|
50
|
+
if (-not (Test-Path $file)) {
|
51
|
+
New-Item -Path $file -ItemType File -Force
|
52
|
+
}
|
53
|
+
}
|
54
|
+
```
|
55
|
+
|
56
|
+
#### Mac/Linux (Bash)
|
57
|
+
```bash
|
58
|
+
# Create all directories in one command
|
59
|
+
mkdir -p memory-bank docs/archive
|
60
|
+
|
61
|
+
# Create all required files
|
62
|
+
touch .cursorrules tasks.md \
|
63
|
+
memory-bank/projectbrief.md \
|
64
|
+
memory-bank/productContext.md \
|
65
|
+
memory-bank/systemPatterns.md \
|
66
|
+
memory-bank/techContext.md \
|
67
|
+
memory-bank/activeContext.md \
|
68
|
+
memory-bank/progress.md
|
69
|
+
```
|
70
|
+
|
71
|
+
## ๐ STREAMLINED VERIFICATION PROCESS
|
72
|
+
|
73
|
+
Instead of checking each component separately, perform batch verification:
|
74
|
+
|
75
|
+
```powershell
|
76
|
+
# Windows - PowerShell
|
77
|
+
$requiredDirs = @("memory-bank", "docs", "docs\archive")
|
78
|
+
$requiredFiles = @(".cursorrules", "tasks.md")
|
79
|
+
$mbFiles = @("projectbrief.md", "productContext.md", "systemPatterns.md",
|
80
|
+
"techContext.md", "activeContext.md", "progress.md")
|
81
|
+
|
82
|
+
$missingDirs = $requiredDirs | Where-Object { -not (Test-Path $_) -or -not (Test-Path $_ -PathType Container) }
|
83
|
+
$missingFiles = $requiredFiles | Where-Object { -not (Test-Path $_) -or (Test-Path $_ -PathType Container) }
|
84
|
+
$missingMBFiles = $mbFiles | ForEach-Object { "memory-bank\$_" } |
|
85
|
+
Where-Object { -not (Test-Path $_) -or (Test-Path $_ -PathType Container) }
|
86
|
+
|
87
|
+
if ($missingDirs.Count -eq 0 -and $missingFiles.Count -eq 0 -and $missingMBFiles.Count -eq 0) {
|
88
|
+
Write-Output "โ All required components verified"
|
89
|
+
} else {
|
90
|
+
# Create all missing items at once
|
91
|
+
if ($missingDirs.Count -gt 0) {
|
92
|
+
$missingDirs | ForEach-Object { mkdir $_ -Force }
|
93
|
+
}
|
94
|
+
if ($missingFiles.Count -gt 0 -or $missingMBFiles.Count -gt 0) {
|
95
|
+
$allMissingFiles = $missingFiles + $missingMBFiles
|
96
|
+
$allMissingFiles | ForEach-Object { New-Item -Path $_ -ItemType File -Force }
|
97
|
+
}
|
98
|
+
}
|
99
|
+
```
|
100
|
+
|
101
|
+
## ๐ TEMPLATE INITIALIZATION
|
102
|
+
|
103
|
+
Optimize template creation with a single script:
|
104
|
+
|
105
|
+
```powershell
|
106
|
+
# Windows - PowerShell
|
107
|
+
$templates = @{
|
108
|
+
"tasks.md" = @"
|
109
|
+
# Memory Bank: Tasks
|
110
|
+
|
111
|
+
## Current Task
|
112
|
+
[Task not yet defined]
|
113
|
+
|
114
|
+
## Status
|
115
|
+
- [ ] Task definition
|
116
|
+
- [ ] Implementation plan
|
117
|
+
- [ ] Execution
|
118
|
+
- [ ] Documentation
|
119
|
+
|
120
|
+
## Requirements
|
121
|
+
[No requirements defined yet]
|
122
|
+
"@
|
123
|
+
|
124
|
+
"memory-bank\activeContext.md" = @"
|
125
|
+
# Memory Bank: Active Context
|
126
|
+
|
127
|
+
## Current Focus
|
128
|
+
[No active focus defined]
|
129
|
+
|
130
|
+
## Status
|
131
|
+
[No status defined]
|
132
|
+
|
133
|
+
## Latest Changes
|
134
|
+
[No changes recorded]
|
135
|
+
"@
|
136
|
+
|
137
|
+
# Add other templates here
|
138
|
+
}
|
139
|
+
|
140
|
+
foreach ($file in $templates.Keys) {
|
141
|
+
if (Test-Path $file) {
|
142
|
+
Set-Content -Path $file -Value $templates[$file]
|
143
|
+
}
|
144
|
+
}
|
145
|
+
```
|
146
|
+
|
147
|
+
## ๐ PERFORMANCE OPTIMIZATION BEST PRACTICES
|
148
|
+
|
149
|
+
1. **Batch Operations**: Always use batch operations instead of individual commands
|
150
|
+
```
|
151
|
+
# GOOD: Create all directories at once
|
152
|
+
mkdir memory-bank docs docs\archive
|
153
|
+
|
154
|
+
# BAD: Create directories one at a time
|
155
|
+
mkdir memory-bank
|
156
|
+
mkdir docs
|
157
|
+
mkdir docs\archive
|
158
|
+
```
|
159
|
+
|
160
|
+
2. **Pre-Check Optimization**: Check all requirements first, then create only what's missing
|
161
|
+
```
|
162
|
+
# First check what's missing
|
163
|
+
$missingItems = ...
|
164
|
+
|
165
|
+
# Then create only what's missing
|
166
|
+
if ($missingItems) { ... }
|
167
|
+
```
|
168
|
+
|
169
|
+
3. **Error Handling**: Include error handling in all commands
|
170
|
+
```
|
171
|
+
mkdir memory-bank, docs, docs\archive -ErrorAction SilentlyContinue
|
172
|
+
```
|
173
|
+
|
174
|
+
4. **Platform Adaptation**: Auto-detect platform and use appropriate commands
|
175
|
+
```
|
176
|
+
if ($IsWindows) {
|
177
|
+
# Windows commands
|
178
|
+
} else {
|
179
|
+
# Unix commands
|
180
|
+
}
|
181
|
+
```
|
182
|
+
|
183
|
+
5. **One-Pass Verification**: Verify directory structure in a single pass
|
184
|
+
```
|
185
|
+
$requiredPaths = @("memory-bank", "docs", "docs\archive", ".cursorrules", "tasks.md")
|
186
|
+
$missingPaths = $requiredPaths | Where-Object { -not (Test-Path $_) }
|
187
|
+
```
|
188
|
+
|
189
|
+
## ๐ VERIFICATION REPORT FORMAT
|
190
|
+
|
191
|
+
```
|
192
|
+
โ
VERIFICATION COMPLETE
|
193
|
+
- Created directories: [list]
|
194
|
+
- Created files: [list]
|
195
|
+
- All components verified
|
196
|
+
|
197
|
+
Memory Bank system ready for use.
|
198
|
+
```
|
@@ -0,0 +1,71 @@
|
|
1
|
+
---
|
2
|
+
description: Platform detection and command adaptation for isolation-focused Memory Bank
|
3
|
+
globs: platform-awareness.mdc
|
4
|
+
alwaysApply: false
|
5
|
+
---
|
6
|
+
|
7
|
+
|
8
|
+
# PLATFORM AWARENESS SYSTEM
|
9
|
+
|
10
|
+
> **TL;DR:** This system detects the operating system, path format, and shell environment, then adapts commands accordingly to ensure cross-platform compatibility.
|
11
|
+
|
12
|
+
## ๐ PLATFORM DETECTION PROCESS
|
13
|
+
|
14
|
+
```mermaid
|
15
|
+
graph TD
|
16
|
+
Start["Start Platform<br>Detection"] --> DetectOS["Detect OS<br>Environment"]
|
17
|
+
DetectOS --> Windows["Windows<br>Detection"]
|
18
|
+
DetectOS --> Mac["macOS<br>Detection"]
|
19
|
+
DetectOS --> Linux["Linux<br>Detection"]
|
20
|
+
|
21
|
+
Windows & Mac & Linux --> PathCheck["Path Separator<br>Detection"]
|
22
|
+
PathCheck --> CmdAdapt["Command<br>Adaptation"]
|
23
|
+
CmdAdapt --> ShellCheck["Shell Type<br>Detection"]
|
24
|
+
ShellCheck --> Complete["Platform Detection<br>Complete"]
|
25
|
+
```
|
26
|
+
|
27
|
+
## ๐ PLATFORM DETECTION IMPLEMENTATION
|
28
|
+
|
29
|
+
For reliable platform detection:
|
30
|
+
|
31
|
+
```
|
32
|
+
## Platform Detection Results
|
33
|
+
Operating System: [Windows/macOS/Linux]
|
34
|
+
Path Separator: [\ or /]
|
35
|
+
Shell Environment: [PowerShell/Bash/Zsh/Cmd]
|
36
|
+
Command Adaptation: [Required/Not Required]
|
37
|
+
|
38
|
+
Adapting commands for [detected platform]...
|
39
|
+
```
|
40
|
+
|
41
|
+
## ๐ PATH FORMAT CONVERSION
|
42
|
+
|
43
|
+
When converting paths between formats:
|
44
|
+
|
45
|
+
```mermaid
|
46
|
+
sequenceDiagram
|
47
|
+
participant Input as Path Input
|
48
|
+
participant Detector as Format Detector
|
49
|
+
participant Converter as Format Converter
|
50
|
+
participant Output as Adapted Path
|
51
|
+
|
52
|
+
Input->>Detector: Raw Path
|
53
|
+
Detector->>Detector: Detect Current Format
|
54
|
+
Detector->>Converter: Path + Current Format
|
55
|
+
Converter->>Converter: Apply Target Format
|
56
|
+
Converter->>Output: Platform-Specific Path
|
57
|
+
```
|
58
|
+
|
59
|
+
## ๐ PLATFORM VERIFICATION CHECKLIST
|
60
|
+
|
61
|
+
```
|
62
|
+
โ PLATFORM VERIFICATION
|
63
|
+
- Operating system correctly identified? [YES/NO]
|
64
|
+
- Path separator format detected? [YES/NO]
|
65
|
+
- Shell environment identified? [YES/NO]
|
66
|
+
- Command set adapted appropriately? [YES/NO]
|
67
|
+
- Path format handling configured? [YES/NO]
|
68
|
+
|
69
|
+
โ If all YES: Platform adaptation complete
|
70
|
+
โ If any NO: Run additional detection steps
|
71
|
+
```
|
@@ -0,0 +1,159 @@
|
|
1
|
+
---
|
2
|
+
description: planning comprehensive
|
3
|
+
globs: planning-comprehensive.mdc
|
4
|
+
alwaysApply: false
|
5
|
+
---
|
6
|
+
|
7
|
+
# LEVEL 3 COMPREHENSIVE PLANNING
|
8
|
+
|
9
|
+
> **TL;DR:** This document provides structured planning guidelines for Level 3 (Intermediate Feature) tasks, focusing on comprehensive planning with creative phases and clear implementation strategies.
|
10
|
+
|
11
|
+
## ๐๏ธ PLANNING WORKFLOW
|
12
|
+
|
13
|
+
```mermaid
|
14
|
+
graph TD
|
15
|
+
Start["Planning Start"] --> Req["๐ Requirements<br>Analysis"]
|
16
|
+
Req --> Comp["๐ Component<br>Analysis"]
|
17
|
+
Comp --> Design["๐จ Design<br>Decisions"]
|
18
|
+
Design --> Impl["โ๏ธ Implementation<br>Strategy"]
|
19
|
+
Impl --> Test["๐งช Testing<br>Strategy"]
|
20
|
+
Test --> Doc["๐ Documentation<br>Plan"]
|
21
|
+
|
22
|
+
Design --> Creative["Creative Phases:"]
|
23
|
+
Creative --> UI["UI/UX Design"]
|
24
|
+
Creative --> Arch["Architecture"]
|
25
|
+
Creative --> Algo["Algorithm"]
|
26
|
+
|
27
|
+
style Start fill:#4da6ff,stroke:#0066cc,color:white
|
28
|
+
style Req fill:#ffa64d,stroke:#cc7a30,color:white
|
29
|
+
style Comp fill:#4dbb5f,stroke:#36873f,color:white
|
30
|
+
style Design fill:#d94dbb,stroke:#a3378a,color:white
|
31
|
+
style Impl fill:#4dbbbb,stroke:#368787,color:white
|
32
|
+
style Test fill:#d971ff,stroke:#a33bc2,color:white
|
33
|
+
style Doc fill:#ff71c2,stroke:#c23b8a,color:white
|
34
|
+
```
|
35
|
+
|
36
|
+
## ๐ PLANNING TEMPLATE
|
37
|
+
|
38
|
+
```markdown
|
39
|
+
# Feature Planning Document
|
40
|
+
|
41
|
+
## Requirements Analysis
|
42
|
+
- Core Requirements:
|
43
|
+
- [ ] Requirement 1
|
44
|
+
- [ ] Requirement 2
|
45
|
+
- Technical Constraints:
|
46
|
+
- [ ] Constraint 1
|
47
|
+
- [ ] Constraint 2
|
48
|
+
|
49
|
+
## Component Analysis
|
50
|
+
- Affected Components:
|
51
|
+
- Component 1
|
52
|
+
- Changes needed:
|
53
|
+
- Dependencies:
|
54
|
+
- Component 2
|
55
|
+
- Changes needed:
|
56
|
+
- Dependencies:
|
57
|
+
|
58
|
+
## Design Decisions
|
59
|
+
- Architecture:
|
60
|
+
- [ ] Decision 1
|
61
|
+
- [ ] Decision 2
|
62
|
+
- UI/UX:
|
63
|
+
- [ ] Design 1
|
64
|
+
- [ ] Design 2
|
65
|
+
- Algorithms:
|
66
|
+
- [ ] Algorithm 1
|
67
|
+
- [ ] Algorithm 2
|
68
|
+
|
69
|
+
## Implementation Strategy
|
70
|
+
1. Phase 1:
|
71
|
+
- [ ] Task 1
|
72
|
+
- [ ] Task 2
|
73
|
+
2. Phase 2:
|
74
|
+
- [ ] Task 3
|
75
|
+
- [ ] Task 4
|
76
|
+
|
77
|
+
## Testing Strategy
|
78
|
+
- Unit Tests:
|
79
|
+
- [ ] Test 1
|
80
|
+
- [ ] Test 2
|
81
|
+
- Integration Tests:
|
82
|
+
- [ ] Test 3
|
83
|
+
- [ ] Test 4
|
84
|
+
|
85
|
+
## Documentation Plan
|
86
|
+
- [ ] API Documentation
|
87
|
+
- [ ] User Guide Updates
|
88
|
+
- [ ] Architecture Documentation
|
89
|
+
```
|
90
|
+
|
91
|
+
## ๐จ CREATIVE PHASE IDENTIFICATION
|
92
|
+
|
93
|
+
```mermaid
|
94
|
+
graph TD
|
95
|
+
subgraph "CREATIVE PHASES REQUIRED"
|
96
|
+
UI["๐จ UI/UX Design<br>Required: Yes/No"]
|
97
|
+
Arch["๐๏ธ Architecture Design<br>Required: Yes/No"]
|
98
|
+
Algo["โ๏ธ Algorithm Design<br>Required: Yes/No"]
|
99
|
+
end
|
100
|
+
|
101
|
+
UI --> UITrig["Triggers:<br>- New UI Component<br>- UX Flow Change"]
|
102
|
+
Arch --> ArchTrig["Triggers:<br>- System Structure Change<br>- New Integration"]
|
103
|
+
Algo --> AlgoTrig["Triggers:<br>- Performance Critical<br>- Complex Logic"]
|
104
|
+
|
105
|
+
style UI fill:#4dbb5f,stroke:#36873f,color:white
|
106
|
+
style Arch fill:#ffa64d,stroke:#cc7a30,color:white
|
107
|
+
style Algo fill:#d94dbb,stroke:#a3378a,color:white
|
108
|
+
```
|
109
|
+
|
110
|
+
## โ
VERIFICATION CHECKLIST
|
111
|
+
|
112
|
+
```mermaid
|
113
|
+
graph TD
|
114
|
+
subgraph "PLANNING VERIFICATION"
|
115
|
+
R["Requirements<br>Complete"]
|
116
|
+
C["Components<br>Identified"]
|
117
|
+
D["Design Decisions<br>Made"]
|
118
|
+
I["Implementation<br>Plan Ready"]
|
119
|
+
T["Testing Strategy<br>Defined"]
|
120
|
+
Doc["Documentation<br>Plan Ready"]
|
121
|
+
end
|
122
|
+
|
123
|
+
R --> C --> D --> I --> T --> Doc
|
124
|
+
|
125
|
+
style R fill:#4dbb5f,stroke:#36873f,color:white
|
126
|
+
style C fill:#ffa64d,stroke:#cc7a30,color:white
|
127
|
+
style D fill:#d94dbb,stroke:#a3378a,color:white
|
128
|
+
style I fill:#4dbbbb,stroke:#368787,color:white
|
129
|
+
style T fill:#d971ff,stroke:#a33bc2,color:white
|
130
|
+
style Doc fill:#ff71c2,stroke:#c23b8a,color:white
|
131
|
+
```
|
132
|
+
|
133
|
+
## ๐ IMPLEMENTATION PHASES
|
134
|
+
|
135
|
+
```mermaid
|
136
|
+
graph LR
|
137
|
+
Setup["๐ ๏ธ Setup"] --> Core["โ๏ธ Core<br>Implementation"]
|
138
|
+
Core --> UI["๐จ UI<br>Implementation"]
|
139
|
+
UI --> Test["๐งช Testing"]
|
140
|
+
Test --> Doc["๐ Documentation"]
|
141
|
+
|
142
|
+
style Setup fill:#4da6ff,stroke:#0066cc,color:white
|
143
|
+
style Core fill:#4dbb5f,stroke:#36873f,color:white
|
144
|
+
style UI fill:#ffa64d,stroke:#cc7a30,color:white
|
145
|
+
style Test fill:#d94dbb,stroke:#a3378a,color:white
|
146
|
+
style Doc fill:#4dbbbb,stroke:#368787,color:white
|
147
|
+
```
|
148
|
+
|
149
|
+
## ๐ DOCUMENT MANAGEMENT
|
150
|
+
|
151
|
+
```mermaid
|
152
|
+
graph TD
|
153
|
+
Current["Current Documents"] --> Active["Active:<br>- planning-comprehensive.md<br>- task-tracking-intermediate.md"]
|
154
|
+
Current --> Next["Next Document:<br>- creative-phase-enforcement.md"]
|
155
|
+
|
156
|
+
style Current fill:#4da6ff,stroke:#0066cc,color:white
|
157
|
+
style Active fill:#4dbb5f,stroke:#36873f,color:white
|
158
|
+
style Next fill:#ffa64d,stroke:#cc7a30,color:white
|
159
|
+
```
|