appiq-solution 1.1.0 → 1.3.0

package/#Tools/SuperClaude/.claude/commands/shared/checkpoint.yml

@@ -0,0 +1,28 @@
+# Checkpoint System
+
+```yaml
+Create:
+  Tag: git tag checkpoint/<type>-$(date +%Y%m%d-%H%M%S)
+  Stash: git stash push -m "checkpoint-<operation>-<timestamp>"
+  Manifest: .claude/checkpoints/manifest.yml
+  Summary: .claudedocs/summaries/checkpoint-<type>-<timestamp>.md
+
+Triggers:
+  Auto: Destructive|Refactor|Migration|Permissions|Deploy
+  Manual: User request|Risky ops|Experiments
+
+Types: feature|fix|refactor|migrate|deploy|manual
+
+Rollback:
+  Full: git reset --hard <checkpoint>
+  Selective: git checkout <checkpoint> -- <files>
+  Incremental: git revert <commits>
+  Stash: git stash pop
+
+Process:
+  - Verify checkpoint exists
+  - Check working tree
+  - Confirm w/ user
+  - Create pre-rollback checkpoint
+  - Execute & verify
+```

package/#Tools/SuperClaude/.claude/commands/shared/cleanup-patterns.yml

@@ -0,0 +1,107 @@
+# Cleanup Patterns & Safety Rules
+
+## Safe→Remove (Auto)
+```yaml
+Files: 
+  - node_modules (if package-lock exists)
+  - dist/, build/, .next/, .nuxt/
+  - .tmp, temp/, cache/
+  - *.log, *.tmp, *.cache
+  - .DS_Store, thumbs.db, desktop.ini
+  - coverage/, .nyc_output/
+
+Code:
+  - console.log(), console.debug()
+  - debugger; statements
+  - TODO comments >30 days old
+  - Commented code blocks >7 days old
+  - Unused imports (if safe analysis confirms)
+```
+
+## Requires Confirmation (Manual)
+```yaml
+Files:
+  - Large files >10MB
+  - Untracked files in git
+  - User-specific cfgs (.vscode/, .idea/)
+  - DB files, logs w/ data
+
+Code:
+  - Unused functions (if no external refs)
+  - Dead code branches
+  - Deprecated API calls
+  - Large commented blocks
+
+Deps:
+  - Unused packages in package.json
+  - Packages w/ security vulns
+  - Major version updates
+  - Dev deps in prod
+```
+
+## Never Remove (Protected)
+```yaml
+Files:
+  - .env.example, .env.template
+  - README.md, LICENSE, CHANGELOG
+  - .gitignore, .gitattributes
+  - package.json, package-lock.json
+  - Source code in src/, lib/
+
+Code:
+  - Error handling blocks
+  - Type definitions
+  - API interfaces
+  - Configuration objects
+  - Test files
+
+Dependencies:
+  - Core framework packages
+  - Peer dependencies
+  - Packages used in production
+```
+
+## Risk Assessment
+```yaml
+LOW [1-3]:
+  - Temporary files
+  - Build artifacts  
+  - Log files
+  - Cache directories
+
+MEDIUM [4-6]:
+  - Unused code
+  - Old git branches
+  - Dev dependencies
+  - Config cleanup
+
+HIGH [7-9]:
+  - Dependency updates
+  - Git history changes
+  - Production configs
+  - Database cleanup
+
+CRITICAL [10]:
+  - Production data
+  - Security configs
+  - Core framework files
+  - User data
+```
+
+## Cleanup Strategies
+```yaml
+Incremental:
+  - Start with safe files
+  - Progress to code cleanup
+  - Finish with dependencies
+  
+Verification:
+  - Run tests after code cleanup
+  - Verify builds after file cleanup
+  - Check functionality after deps
+
+Rollback:
+  - Git commit before cleanup
+  - Backup configs before changes
+  - Document what was removed
+```

package/#Tools/SuperClaude/.claude/commands/shared/command-memory.yml

@@ -0,0 +1,52 @@
+# Command Result Sharing & Context Mgmt
+
+## Enhanced Result Storage
+```yaml
+Cache Duration: Current session+persistent patterns
+Storage Format:
+  analyze: {issues[], metrics{}, hotspots[], patterns[]}
+  build: {artifacts[], errors[], warnings[], perf{}}
+  test: {passed[], failed[], coverage%, flaky[]}
+  scan: {vulns[], risks{}, fixes[], compliance{}}
+  design: {arch{}, patterns[], decisions[]}
+  troubleshoot: {findings[], root_causes[], solutions[]}
+
+Reuse Rules:
+  Same target+flags: Use cache | Modified files: Invalidate
+  Chained commands: Auto-pass results | Time limit: 30min
+  Persistent patterns: Store successful workflows across sessions
+  Context sharing: Pass relevant subset→next command
+```
+
+## Advanced Context Chaining
+```yaml
+Intelligent Workflows:
+  analyze→improve: Use found issues as targets + priority ranking
+  build→test: Focus on changed modules + integration points
+  scan→fix: Prioritize critical vulnerabilities + context
+  design→build: Apply architectural patterns + decisions
+  troubleshoot→improve: Use root cause analysis for targeted fixes
+  any→deploy: Verify all checks passed + readiness assessment
+
+Context Enrichment:
+  File Change Detection: Track modifications since last analysis
+  Dependency Mapping: Understand component relationships
+  Performance Baseline: Compare against historical metrics
+  Quality Trends: Track improvement over time
+  User Patterns: Learn from successful workflows
+```
+
+## Smart Context Optimization
+```yaml
+Memory Management:
+  Essential Context: Keep critical information accessible
+  Token Optimization: Compress verbose results for efficiency
+  Selective Loading: Load only needed context per command
+  Background Processing: Precompute likely needed context
+
+Pattern Learning:
+  Workflow Recognition: Identify common command sequences
+  Success Patterns: Learn from effective approaches
+  Error Prevention: Remember failure patterns to avoid
+  User Preferences: Adapt to individual working styles
+```

package/#Tools/SuperClaude/.claude/commands/shared/command-templates.yml

@@ -0,0 +1,167 @@
+# Command Templates - Token Optimized Patterns
+
+## Legend
+| Symbol | Meaning | | Abbrev | Meaning |
+|--------|---------|---|--------|---------|
+| → | leads to | | cfg | configuration |
+| & | and/with | | impl | implementation |
+| w/ | with | | perf | performance |
+| @ | at/located | | ops | operations |
+| ∀ | for all/every | | val | validation |
+| ∃ | exists/there is | | req | requirements |
+
+## Universal Command Structure Template
+
+```yaml
+Command_Header:
+  Execute: "immediately. Add --plan flag if user wants to see plan first."
+  Legend: "@command-specific legend generation"
+  Purpose: "[Action] [Subject] specified in $ARGUMENTS"
+
+Universal_Flags:
+  Planning: "@include shared/constants.yml#Standard_Flags.Planning"
+  Thinking: "@include shared/constants.yml#Standard_Flags.Thinking"
+  Compression: "@include shared/constants.yml#Standard_Flags.Compression"
+  MCP_Control: "@include shared/constants.yml#Standard_Flags.MCP_Control"
+  Execution: "@include shared/constants.yml#Standard_Flags.Execution"
+  
+Flag_Templates:
+  MCP_Control: "@see shared/mcp-flags.yml"
+  Thinking_Modes: "@see shared/thinking-modes.yml"
+  Planning_Mode: "@see shared/planning-mode.yml"
+  
+Research_Requirements:
+  Standard: "@include shared/research-first.yml#Research_Policy"
+  External_Libs: "@include shared/research-first.yml#Library_Requirements"
+  Patterns: "@include shared/research-first.yml#Pattern_Verification"
+  Citations: "@include shared/constants.yml#Standard_Messages.Report_References"
+  
+Report_Output:
+  Location: "@include shared/constants.yml#Documentation_Paths"
+  Directory: "@include shared/execution-lifecycle.yml#Preparation_Actions"
+  Reference: "@include shared/constants.yml#Standard_Messages.Report_References"
+  
+Error_Handling:
+  Classification: "@include shared/severity-levels.yml#Severity_Levels"
+  Recovery: "@include shared/error-handling.yml#Recovery_Strategies"
+  Escalation: "@include shared/severity-levels.yml#Escalation_Pathways"
+```
+
+## Command Type Templates
+
+```yaml
+Analysis_Commands:
+  Structure: "Analyze [subject] using [method]"
+  Flags: "--code --architecture --security --performance"
+  Output: "Analysis reports→.claudedocs/reports/"
+  
+Build_Commands:
+  Structure: "Build [type] w/ [requirements]"
+  Flags: "--init --feature --tdd --watch"
+  Output: "Working code + tests + docs"
+  
+Workflow_Commands:
+  Structure: "[Action] using [workflow] pattern"
+  Flags: "--dry-run --interactive --iterate"
+  Output: "Process results + metrics"
+```
+
+## Shared Flag Descriptions
+
+```yaml
+Core_Flags:
+  plan: "Show execution plan before running"
+  think: "Multi-file analysis w/ context (4K)"
+  think_hard: "Deep system analysis (10K)"
+  ultrathink: "Comprehensive analysis (32K)"
+  uc: "UltraCompressed mode (~70% token reduction)"
+  
+MCP_Flags:
+  c7: "Context7→docs & examples"
+  seq: "Sequential→complex thinking"
+  magic: "Magic→UI component generation"
+  pup: "Puppeteer→browser automation"
+  no_mcp: "Disable all MCP servers"
+  
+Quality_Flags:
+  tdd: "Test-driven development"
+  coverage: "Code coverage analysis"
+  validate: "Validation & verification"
+  security: "Security scan & audit"
+  
+Workflow_Flags:
+  dry_run: "Preview w/o execution"
+  watch: "Continuous monitoring"
+  interactive: "Step-by-step guidance"
+  iterate: "Iterative improvement"
+```
+
+## Cross-Reference System
+
+```yaml
+Instead_Of_Repeating:
+  MCP_Explanations: "@see shared/mcp-flags.yml"
+  Thinking_Modes: "@see shared/thinking-modes.yml"
+  Research_Standards: "@see shared/research-first.yml"
+  Validation_Rules: "@see shared/validation.yml"
+  Performance_Patterns: "@see shared/performance.yml"
+  
+Template_Usage:
+  Command_File: |
+    @include shared/command-templates.yml#Analysis_Commands
+    @flags shared/command-templates.yml#Core_Flags,MCP_Flags
+    
+Reference_Format: "@see [file]#[section]"
+Include_Format: "@include [file]#[section]"
+```
+
+## Token Optimization Patterns
+
+```yaml
+Compression_Rules:
+  Articles: Remove "the|a|an" where clear
+  Conjunctions: Replace "and"→"&" | "with"→"w/"
+  Prepositions: Compress "at"→"@" | "to"→"→"
+  Verbose_Phrases: "in order to"→"to" | "make sure"→"ensure"
+  
+Symbol_Expansion:
+  Mathematics: ∀(all) ∃(exists) ∈(member) ⊂(subset) ∪(union) ∩(intersection)
+  Logic: ∴(therefore) ∵(because) ≡(equivalent) ≈(approximately)
+  Process: ▶(start) ⏸(pause) ⏹(stop) ⚡(fast) 🔄(cycle)
+  Quality: ✅(success) ❌(failure) ⚠(warning) 📊(metrics)
+  
+Structure_Priority:
+  1_YAML: Most compact structured data
+  2_Tables: Comparison & reference data
+  3_Lists: Enumeration & sequences
+  4_Prose: Only when necessary
+  
+Abbreviation_Standards:
+  Technical: cfg(config) impl(implementation) perf(performance) val(validation)
+  Actions: analyze→anlz | build→bld | deploy→dply | test→tst
+  Objects: database→db | interface→api | environment→env | dependency→dep
+```
+
+## Implementation Notes
+
+```yaml
+Usage_Pattern:
+  1_Define_Template: Create in shared/command-templates.yml
+  2_Reference_Template: Use @include in command files
+  3_Override_Specific: Add command-specific details only
+  4_Validate_Consistency: Auto-check cross-references
+  
+Benefits:
+  Token_Reduction: ~40% reduction in command file size
+  Consistency: Standardized patterns across all commands
+  Maintenance: Single source of truth for common elements
+  Scalability: Easy addition of new commands using templates
+  
+Migration_Strategy:
+  Phase_1: Create templates for most common patterns
+  Phase_2: Update existing commands to use templates
+  Phase_3: Implement auto-validation of template usage
+```
+
+---
+*Command Templates v1.0 - Token-optimized reusable patterns for SuperClaude commands*

package/#Tools/SuperClaude/.claude/commands/shared/config-validator.yml

@@ -0,0 +1,206 @@
+# Config Validation System
+
+## Legend
+| Symbol | Meaning | | Abbrev | Meaning |
+|--------|---------|---|--------|---------|
+| → | leads to | | cfg | configuration |
+| & | and/with | | val | validation |
+| ✅ | valid/success | | req | required |
+| ❌ | invalid/error | | dep | dependency |
+
+## Validation Rules
+
+```yaml
+Core_Config_Files:
+  Required_Files:
+    - ~/.claude/CLAUDE.md
+    - ~/.claude/RULES.md  
+    - ~/.claude/PERSONAS.md
+    - ~/.claude/MCP.md
+    
+  YAML_Syntax_Check:
+    Tool: "yamllint --strict"
+    Rules: "No syntax errors, proper indentation, valid structure"
+    Action_On_Fail: "Block loading, show specific line errors"
+    
+  Cross_Reference_Validation:
+    Persona_Command_Matrix:
+      Check: "All personas reference valid commands"
+      Example: "architect → /user:design --api (must exist)"
+      
+    MCP_Server_References:  
+      Check: "All MCP flags reference available servers"
+      Valid: "--c7 --seq --magic --pup"
+      Invalid: "--unknown-mcp"
+      
+    Shared_Resource_Links:
+      Check: "@see shared/file.yml references exist"
+      Pattern: "@see shared/([^\\s]+)"
+      Validation: "File exists & section valid"
+      
+    Command_Flag_Consistency:
+      Check: "Universal flags defined consistently"
+      Universal: "--plan --think --think-hard --ultrathink --uc"
+      MCP: "--c7 --seq --magic --pup --no-mcp"
+```
+
+## Dependency Validation
+
+```yaml
+Command_Dependencies:
+  Required_Sections:
+    - Legend (w/ symbols used in file)
+    - Command description
+    - Examples
+    - Deliverables
+    
+  Flag_Definitions:
+    Check: "All flags mentioned have descriptions"
+    Pattern: "--([a-z-]+)"
+    Validation: "Flag documented in file or shared templates"
+    
+  MCP_Integration:
+    Consistency: "MCP usage matches persona preferences"
+    Example: "frontend persona → prefers --magic flag"
+    
+  Research_Requirements:
+    Check: "All commands reference research-first.yml"
+    Required: "@see shared/research-first.yml"
+    
+Shared_Resource_Dependencies:
+  Template_Usage:
+    Pattern: "@include shared/([^#]+)#([^\\s]+)"
+    Validation: "Template file exists & section defined"
+    
+  Cross_References:
+    Pattern: "@see shared/([^\\s]+)"
+    Validation: "Referenced files exist & accessible"
+    
+  Symbol_Consistency:
+    Check: "Symbols used match legend definitions"
+    Validation: "All symbols (→ & w/ @) defined in legend"
+```
+
+## Validation Implementation
+
+```yaml
+Pre_Load_Checks:
+  1_File_Existence:
+    Check: "All required files present"
+    Action: "Create missing w/ defaults or block"
+    
+  2_YAML_Syntax:
+    Tool: "Built-in YAML parser"
+    Report: "Line-specific syntax errors"
+    
+  3_Cross_References:
+    Check: "All @see & @include links valid"  
+    Report: "Broken references w/ suggestions"
+    
+  4_Consistency:
+    Check: "Persona↔command↔MCP alignment"
+    Report: "Inconsistencies w/ recommended fixes"
+    
+Runtime_Validation:
+  Command_Execution:
+    Check: "Requested command exists & valid"
+    Check: "All flags recognized"
+    Check: "MCP servers available"
+    
+  Context_Validation:
+    Check: "Required dependencies present"
+    Check: "Permissions adequate"
+    Check: "No circular references"
+    
+Auto_Repair:
+  Missing_Sections:
+    Action: "Generate w/ templates"
+    Example: "Missing legend → auto-generate from symbols used"
+    
+  Broken_References:
+    Action: "Suggest alternatives or create stubs"
+    Example: "@see missing-file.yml → create basic template"
+    
+  Outdated_Patterns:
+    Action: "Suggest modernization"
+    Example: "Old flag syntax → new standardized format"
+```
+
+## Validation Reports
+
+```yaml
+Report_Structure:
+  Location: ".claudedocs/validation/config-validation-<timestamp>.md"
+  Sections:
+    - Executive Summary (✅❌ counts)
+    - File-by-file detailed results
+    - Cross-reference matrix
+    - Recommended actions
+    - Auto-repair options
+    
+Severity_Levels:
+  CRITICAL: "Syntax errors, missing required files"
+  HIGH: "Broken cross-references, invalid MCP refs"  
+  MEDIUM: "Missing documentation, inconsistent patterns"
+  LOW: "Style issues, optimization opportunities"
+  
+Actions_By_Severity:
+  CRITICAL: "Block loading until fixed"
+  HIGH: "Warn & continue w/ degraded functionality"
+  MEDIUM: "Note in report, suggest fixes"
+  LOW: "Background report only"
+```
+
+## Integration Points
+
+```yaml
+SuperClaude_Startup:
+  1_Run_Validation: "Before loading any configs"
+  2_Report_Issues: "Show summary to user"
+  3_Auto_Repair: "Fix what can be auto-repaired"
+  4_Block_Critical: "Don't load if critical errors"
+  
+Command_Execution:
+  Pre_Execution: "Validate command & flags exist"
+  Runtime: "Check dependencies available"
+  Post_Execution: "Validate output format"
+  
+Config_Updates:
+  On_File_Change: "Re-validate affected files"
+  On_Install: "Full validation before deployment"
+  Periodic: "Weekly validation health check"
+  
+Developer_Tools:
+  CLI_Command: "/user:validate --config"
+  Report_Command: "/user:validate --report"
+  Fix_Command: "/user:validate --auto-repair"
+```
+
+## Implementation Examples
+
+```yaml
+Basic_Usage:
+  Manual: "validate_config() before load"
+  Automatic: "Built into SuperClaude startup"
+  Reporting: "Generate .claudedocs/validation/ reports"
+  
+Error_Examples:
+  Syntax_Error: |
+    "YAML syntax error in PERSONAS.md line 42:
+     Expected scalar, found sequence
+     Fix: Check indentation & structure"
+     
+  Broken_Reference: |
+    "@see shared/missing-file.yml not found
+     Suggestions: 
+     - Create missing-file.yml w/ template
+     - Fix reference to shared/existing-file.yml"
+     
+  Inconsistency: |
+    "Persona 'frontend' references --magic flag
+     but MCP.md shows Magic server disabled
+     Fix: Enable Magic server or update persona"
+```
+
+---
+*Config Validator v1.0 - Automated validation for SuperClaude configuration integrity*