geminize 1.0.0 → 1.2.0

data/.cursor/rules/isolation_rules/visual-maps/archive-mode-map.mdc

@@ -0,0 +1,277 @@
+---
+description: 
+globs: 
+alwaysApply: false
+---
+---
+description: Visual process map for ARCHIVE mode (Task Documentation)
+globs: "**/archive*/**", "**/document*/**", "**/complete*/**"
+alwaysApply: false
+---
+
+# ARCHIVE MODE: TASK DOCUMENTATION PROCESS MAP
+
+> **TL;DR:** This visual map guides the ARCHIVE mode process, focusing on creating comprehensive documentation of the completed task, archiving relevant files, and updating the Memory Bank for future reference.
+
+## 🧭 ARCHIVE MODE PROCESS FLOW
+
+```mermaid
+graph TD
+    Start["START ARCHIVE MODE"] --> ReadTasks["Read tasks.md<br>reflection.md and<br>progress.md"]
+    
+    %% Initial Assessment
+    ReadTasks --> VerifyReflect{"Reflection<br>Complete?"}
+    VerifyReflect -->|"No"| ReturnReflect["Return to<br>REFLECT Mode"]
+    VerifyReflect -->|"Yes"| AssessLevel{"Determine<br>Complexity Level"}
+    
+    %% Level-Based Archiving
+    AssessLevel -->|"Level 1"| L1Archive["LEVEL 1 ARCHIVING<br>Level1/archive-minimal.md"]
+    AssessLevel -->|"Level 2"| L2Archive["LEVEL 2 ARCHIVING<br>Level2/archive-basic.md"]
+    AssessLevel -->|"Level 3"| L3Archive["LEVEL 3 ARCHIVING<br>Level3/archive-standard.md"]
+    AssessLevel -->|"Level 4"| L4Archive["LEVEL 4 ARCHIVING<br>Level4/archive-comprehensive.md"]
+    
+    %% Level 1 Archiving (Minimal)
+    L1Archive --> L1Summary["Create Quick<br>Summary"]
+    L1Summary --> L1Task["Update<br>tasks.md"]
+    L1Task --> L1Complete["Mark Task<br>Complete"]
+    
+    %% Level 2 Archiving (Basic)
+    L2Archive --> L2Summary["Create Basic<br>Archive Document"]
+    L2Summary --> L2Doc["Document<br>Changes"]
+    L2Doc --> L2Task["Update<br>tasks.md"]
+    L2Task --> L2Progress["Update<br>progress.md"]
+    L2Progress --> L2Complete["Mark Task<br>Complete"]
+    
+    %% Level 3-4 Archiving (Comprehensive)
+    L3Archive & L4Archive --> L34Summary["Create Comprehensive<br>Archive Document"]
+    L34Summary --> L34Doc["Document<br>Implementation"]
+    L34Doc --> L34Creative["Archive Creative<br>Phase Documents"]
+    L34Creative --> L34Code["Document Code<br>Changes"]
+    L34Code --> L34Test["Document<br>Testing"]
+    L34Test --> L34Lessons["Summarize<br>Lessons Learned"]
+    L34Lessons --> L34Task["Update<br>tasks.md"]
+    L34Task --> L34Progress["Update<br>progress.md"]
+    L34Progress --> L34System["Update System<br>Documentation"]
+    L34System --> L34Complete["Mark Task<br>Complete"]
+    
+    %% Completion
+    L1Complete & L2Complete & L34Complete --> CreateArchive["Create Archive<br>Document in<br>docs/archive/"]
+    CreateArchive --> UpdateActive["Update<br>activeContext.md"]
+    UpdateActive --> Reset["Reset for<br>Next Task"]
+```
+
+## 📋 ARCHIVE DOCUMENT STRUCTURE
+
+The archive document should follow this structured format:
+
+```mermaid
+graph TD
+    subgraph "Archive Document Structure"
+        Header["# TASK ARCHIVE: [Task Name]"]
+        Meta["## METADATA<br>Task info, dates, complexity"]
+        Summary["## SUMMARY<br>Brief overview of the task"]
+        Requirements["## REQUIREMENTS<br>What the task needed to accomplish"]
+        Implementation["## IMPLEMENTATION<br>How the task was implemented"]
+        Testing["## TESTING<br>How the solution was verified"]
+        Lessons["## LESSONS LEARNED<br>Key takeaways from the task"]
+        Refs["## REFERENCES<br>Links to related documents"]
+    end
+    
+    Header --> Meta --> Summary --> Requirements --> Implementation --> Testing --> Lessons --> Refs
+```
+
+## 📊 REQUIRED FILE STATE VERIFICATION
+
+Before archiving can begin, verify file state:
+
+```mermaid
+graph TD
+    Start["File State<br>Verification"] --> CheckTasks{"tasks.md has<br>reflection<br>complete?"}
+    
+    CheckTasks -->|"No"| ErrorReflect["ERROR:<br>Return to REFLECT Mode"]
+    CheckTasks -->|"Yes"| CheckReflection{"reflection.md<br>exists?"}
+    
+    CheckReflection -->|"No"| ErrorCreate["ERROR:<br>Create reflection.md first"]
+    CheckReflection -->|"Yes"| CheckProgress{"progress.md<br>updated?"}
+    
+    CheckProgress -->|"No"| ErrorProgress["ERROR:<br>Update progress.md first"]
+    CheckProgress -->|"Yes"| ReadyArchive["Ready for<br>Archiving"]
+```
+
+## 🔍 ARCHIVE TYPES BY COMPLEXITY
+
+```mermaid
+graph TD
+    subgraph "Level 1: Minimal Archive"
+        L1A["Basic Bug<br>Description"]
+        L1B["Solution<br>Summary"]
+        L1C["Affected<br>Files"]
+    end
+    
+    subgraph "Level 2: Basic Archive"
+        L2A["Enhancement<br>Description"]
+        L2B["Implementation<br>Summary"]
+        L2C["Testing<br>Results"]
+        L2D["Lessons<br>Learned"]
+    end
+    
+    subgraph "Level 3-4: Comprehensive Archive"
+        L3A["Detailed<br>Requirements"]
+        L3B["Architecture/<br>Design Decisions"]
+        L3C["Implementation<br>Details"]
+        L3D["Testing<br>Strategy"]
+        L3E["Performance<br>Considerations"]
+        L3F["Future<br>Enhancements"]
+        L3G["Cross-References<br>to Other Systems"]
+    end
+    
+    L1A --> L1B --> L1C
+    
+    L2A --> L2B --> L2C --> L2D
+    
+    L3A --> L3B --> L3C --> L3D --> L3E --> L3F --> L3G
+```
+
+## 📝 ARCHIVE DOCUMENT TEMPLATES
+
+### Level 1 (Minimal) Archive
+```
+# Bug Fix Archive: [Bug Name]
+
+## Date
+[Date of fix]
+
+## Summary
+[Brief description of the bug and solution]
+
+## Implementation
+[Description of the fix implemented]
+
+## Files Changed
+- [File 1]
+- [File 2]
+```
+
+### Levels 2-4 (Comprehensive) Archive
+```
+# Task Archive: [Task Name]
+
+## Metadata
+- **Complexity**: Level [2/3/4]
+- **Type**: [Enhancement/Feature/System]
+- **Date Completed**: [Date]
+- **Related Tasks**: [Related task references]
+
+## Summary
+[Comprehensive summary of the task]
+
+## Requirements
+- [Requirement 1]
+- [Requirement 2]
+- [Requirement 3]
+
+## Implementation
+### Approach
+[Description of implementation approach]
+
+### Key Components
+- [Component 1]: [Description]
+- [Component 2]: [Description]
+
+### Files Changed
+- [File 1]: [Description of changes]
+- [File 2]: [Description of changes]
+
+## Testing
+- [Test 1]: [Result]
+- [Test 2]: [Result]
+
+## Lessons Learned
+- [Lesson 1]
+- [Lesson 2]
+- [Lesson 3]
+
+## Future Considerations
+- [Future enhancement 1]
+- [Future enhancement 2]
+
+## References
+- [Link to reflection document]
+- [Link to creative phase documents]
+- [Other relevant references]
+```
+
+## 📋 ARCHIVE LOCATION AND NAMING
+
+Archive documents should be organized following this pattern:
+
+```mermaid
+graph TD
+    subgraph "Archive Structure"
+        Root["docs/archive/"]
+        Tasks["tasks/"]
+        Features["features/"]
+        Systems["systems/"]
+        
+        Root --> Tasks
+        Root --> Features
+        Root --> Systems
+        
+        Tasks --> Bug["bug-fix-name-YYYYMMDD.md"]
+        Tasks --> Enhancement["enhancement-name-YYYYMMDD.md"]
+        Features --> Feature["feature-name-YYYYMMDD.md"]
+        Systems --> System["system-name-YYYYMMDD.md"]
+    end
+```
+
+## 📊 TASKS.MD FINAL UPDATE
+
+When archiving is complete, update tasks.md with:
+
+```
+## Status
+- [x] Initialization complete
+- [x] Planning complete
+[For Level 3-4:]
+- [x] Creative phases complete
+- [x] Implementation complete
+- [x] Reflection complete
+- [x] Archiving complete
+
+## Archive
+- **Date**: [Completion date]
+- **Archive Document**: [Link to archive document]
+- **Status**: COMPLETED
+```
+
+## 📋 ARCHIVE VERIFICATION CHECKLIST
+
+```
+✓ ARCHIVE VERIFICATION
+- Reflection document reviewed? [YES/NO]
+- Archive document created with all sections? [YES/NO]
+- Archive document placed in correct location? [YES/NO]
+- tasks.md marked as completed? [YES/NO]
+- progress.md updated with archive reference? [YES/NO]
+- activeContext.md updated for next task? [YES/NO]
+- Creative phase documents archived (Level 3-4)? [YES/NO/NA]
+
+→ If all YES: Archiving complete - Memory Bank reset for next task
+→ If any NO: Complete missing archive elements
+```
+
+## 🔄 TASK COMPLETION NOTIFICATION
+
+When archiving is complete, notify user with:
+
+```
+## TASK ARCHIVED
+
+✅ Archive document created in docs/archive/
+✅ All task documentation preserved
+✅ Memory Bank updated with references
+✅ Task marked as COMPLETED
+
+→ Memory Bank is ready for the next task
+→ To start a new task, use VAN MODE
+``` 

data/.cursor/rules/isolation_rules/visual-maps/creative-mode-map.mdc

@@ -0,0 +1,224 @@
+---
+description: Visual process map for CREATIVE mode (Design Decisions)
+globs: "**/creative*/**", "**/design*/**", "**/decision*/**"
+alwaysApply: false
+---
+
+# CREATIVE MODE: DESIGN PROCESS MAP
+
+> **TL;DR:** This visual map guides the CREATIVE mode process, focusing on structured design decision-making for components that require deeper exploration before implementation.
+
+## 🧭 CREATIVE MODE PROCESS FLOW
+
+```mermaid
+graph TD
+    Start["START CREATIVE MODE"] --> ReadTasks["Read tasks.md<br>For Creative Requirements"]
+    
+    %% Initial Assessment
+    ReadTasks --> VerifyPlan{"Plan Complete<br>& Creative Phases<br>Identified?"}
+    VerifyPlan -->|"No"| ReturnPlan["Return to<br>PLAN Mode"]
+    VerifyPlan -->|"Yes"| IdentifyPhases["Identify Creative<br>Phases Required"]
+    
+    %% Creative Phase Selection
+    IdentifyPhases --> SelectPhase["Select Next<br>Creative Phase"]
+    SelectPhase --> PhaseType{"Creative<br>Phase Type?"}
+    
+    %% Creative Phase Types
+    PhaseType -->|"UI/UX<br>Design"| UIPhase["UI/UX CREATIVE PHASE<br>Core/creative-phase-uiux.md"]
+    PhaseType -->|"Architecture<br>Design"| ArchPhase["ARCHITECTURE CREATIVE PHASE<br>Core/creative-phase-architecture.md"]
+    PhaseType -->|"Data Model<br>Design"| DataPhase["DATA MODEL CREATIVE PHASE<br>Core/creative-phase-data.md"]
+    PhaseType -->|"Algorithm<br>Design"| AlgoPhase["ALGORITHM CREATIVE PHASE<br>Core/creative-phase-algorithm.md"]
+    
+    %% UI/UX Creative Phase
+    UIPhase --> UI_Problem["Define UI/UX<br>Problem"]
+    UI_Problem --> UI_Research["Research UI<br>Patterns"]
+    UI_Research --> UI_Options["Explore UI<br>Options"]
+    UI_Options --> UI_Evaluate["Evaluate User<br>Experience"]
+    UI_Evaluate --> UI_Decision["Make Design<br>Decision"]
+    UI_Decision --> UI_Document["Document UI<br>Design"]
+    
+    %% Architecture Creative Phase
+    ArchPhase --> Arch_Problem["Define Architecture<br>Challenge"]
+    Arch_Problem --> Arch_Options["Explore Architecture<br>Options"]
+    Arch_Options --> Arch_Analyze["Analyze Tradeoffs"]
+    Arch_Analyze --> Arch_Decision["Make Architecture<br>Decision"]
+    Arch_Decision --> Arch_Document["Document<br>Architecture"]
+    Arch_Document --> Arch_Diagram["Create Architecture<br>Diagram"]
+    
+    %% Data Model Creative Phase
+    DataPhase --> Data_Requirements["Define Data<br>Requirements"]
+    Data_Requirements --> Data_Structure["Design Data<br>Structure"]
+    Data_Structure --> Data_Relations["Define<br>Relationships"]
+    Data_Relations --> Data_Validation["Design<br>Validation"]
+    Data_Validation --> Data_Document["Document<br>Data Model"]
+    
+    %% Algorithm Creative Phase
+    AlgoPhase --> Algo_Problem["Define Algorithm<br>Problem"]
+    Algo_Problem --> Algo_Options["Explore Algorithm<br>Approaches"]
+    Algo_Options --> Algo_Evaluate["Evaluate Time/Space<br>Complexity"]
+    Algo_Evaluate --> Algo_Decision["Make Algorithm<br>Decision"]
+    Algo_Decision --> Algo_Document["Document<br>Algorithm"]
+    
+    %% Documentation & Completion
+    UI_Document & Arch_Diagram & Data_Document & Algo_Document --> CreateDoc["Create Creative<br>Phase Document"]
+    CreateDoc --> UpdateTasks["Update tasks.md<br>with Decision"]
+    UpdateTasks --> MorePhases{"More Creative<br>Phases?"}
+    MorePhases -->|"Yes"| SelectPhase
+    MorePhases -->|"No"| VerifyComplete["Verify All<br>Phases Complete"]
+    VerifyComplete --> NotifyComplete["Signal Creative<br>Phases Complete"]
+```
+
+## 📋 CREATIVE PHASE DOCUMENT FORMAT
+
+Each creative phase should produce a document with this structure:
+
+```mermaid
+graph TD
+    subgraph "Creative Phase Document"
+        Header["🎨 CREATIVE PHASE: [TYPE]"]
+        Problem["PROBLEM STATEMENT<br>Clear definition of the problem"]
+        Options["OPTIONS ANALYSIS<br>Multiple approaches considered"]
+        Pros["PROS & CONS<br>Tradeoffs for each option"]
+        Decision["DECISION<br>Selected approach + rationale"]
+        Impl["IMPLEMENTATION PLAN<br>Steps to implement the decision"]
+        Diagram["VISUALIZATION<br>Diagrams of the solution"]
+    end
+    
+    Header --> Problem --> Options --> Pros --> Decision --> Impl --> Diagram
+```
+
+## 🔍 CREATIVE TYPES AND APPROACHES
+
+```mermaid
+graph TD
+    subgraph "UI/UX Design"
+        UI1["User Flow<br>Analysis"]
+        UI2["Component<br>Hierarchy"]
+        UI3["Interaction<br>Patterns"]
+        UI4["Visual Design<br>Principles"]
+    end
+    
+    subgraph "Architecture Design"
+        A1["Component<br>Structure"]
+        A2["Data Flow<br>Patterns"]
+        A3["Interface<br>Design"]
+        A4["System<br>Integration"]
+    end
+    
+    subgraph "Data Model Design"
+        D1["Entity<br>Relationships"]
+        D2["Schema<br>Design"]
+        D3["Validation<br>Rules"]
+        D4["Query<br>Optimization"]
+    end
+    
+    subgraph "Algorithm Design"
+        AL1["Complexity<br>Analysis"]
+        AL2["Efficiency<br>Optimization"]
+        AL3["Edge Case<br>Handling"]
+        AL4["Scaling<br>Considerations"]
+    end
+```
+
+## 📊 REQUIRED FILE STATE VERIFICATION
+
+Before creative phase work can begin, verify file state:
+
+```mermaid
+graph TD
+    Start["File State<br>Verification"] --> CheckTasks{"tasks.md has<br>planning complete?"}
+    
+    CheckTasks -->|"No"| ErrorPlan["ERROR:<br>Return to PLAN Mode"]
+    CheckTasks -->|"Yes"| CheckCreative{"Creative phases<br>identified?"}
+    
+    CheckCreative -->|"No"| ErrorCreative["ERROR:<br>Return to PLAN Mode"]
+    CheckCreative -->|"Yes"| ReadyCreative["Ready for<br>Creative Phase"]
+```
+
+## 📋 OPTIONS ANALYSIS TEMPLATE
+
+For each creative phase, analyze multiple options:
+
+```
+## OPTIONS ANALYSIS
+
+### Option 1: [Name]
+**Description**: [Brief description]
+**Pros**:
+- [Pro 1]
+- [Pro 2]
+**Cons**:
+- [Con 1]
+- [Con 2]
+**Complexity**: [Low/Medium/High]
+**Implementation Time**: [Estimate]
+
+### Option 2: [Name]
+**Description**: [Brief description]
+**Pros**:
+- [Pro 1]
+- [Pro 2]
+**Cons**:
+- [Con 1]
+- [Con 2]
+**Complexity**: [Low/Medium/High]
+**Implementation Time**: [Estimate]
+
+### Option 3: [Name]
+**Description**: [Brief description]
+**Pros**:
+- [Pro 1]
+- [Pro 2]
+**Cons**:
+- [Con 1]
+- [Con 2]
+**Complexity**: [Low/Medium/High]
+**Implementation Time**: [Estimate]
+```
+
+## 🎨 CREATIVE PHASE MARKERS
+
+Use these visual markers for creative phases:
+
+```
+🎨🎨🎨 ENTERING CREATIVE PHASE: [TYPE] 🎨🎨🎨
+
+[Creative phase content]
+
+🎨 CREATIVE CHECKPOINT: [Milestone]
+
+[Additional content]
+
+🎨🎨🎨 EXITING CREATIVE PHASE - DECISION MADE 🎨🎨🎨
+```
+
+## 📊 CREATIVE PHASE VERIFICATION CHECKLIST
+
+```
+✓ CREATIVE PHASE VERIFICATION
+- Problem clearly defined? [YES/NO]
+- Multiple options considered (3+)? [YES/NO]
+- Pros/cons documented for each option? [YES/NO]
+- Decision made with clear rationale? [YES/NO]
+- Implementation plan included? [YES/NO]
+- Visualization/diagrams created? [YES/NO]
+- tasks.md updated with decision? [YES/NO]
+
+→ If all YES: Creative phase complete
+→ If any NO: Complete missing elements
+```
+
+## 🔄 MODE TRANSITION NOTIFICATION
+
+When all creative phases are complete, notify user with:
+
+```
+## CREATIVE PHASES COMPLETE
+
+✅ All required design decisions made
+✅ Creative phase documents created
+✅ tasks.md updated with decisions
+✅ Implementation plan updated
+
+→ NEXT RECOMMENDED MODE: IMPLEMENT MODE
+```