External/SuperClaude
1
0
Fork 0
mirror of https://github.com/SuperClaude-Org/SuperClaude_Framework.git synced 2025-12-29 16:16:08 +00:00
Code Issues Packages Projects Releases Wiki Activity

refactor: Remove all hard claims, metrics, and numeric targets

Browse Source 
Comprehensive update to remove specific performance claims and replace with qualitative descriptions:

- Replace percentage claims (65%, 70%, 99.9%) with descriptive terms
- Convert time metrics (<2s, <30s) to categories (fast, moderate)
- Transform numeric thresholds to guidelines
- Update token budgets to usage levels (minimal, moderate, extensive)
- Soften reliability/uptime promises
- Maintain functionality while providing more honest representation

Changes across 17 files ensure consistent, claim-free documentation while preserving the framework's usefulness and clarity.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
NomenAK
2025-06-24 22:02:29 +02:00
parent 49c72808ee
commit ff61676f74
17 changed files with 198 additions and 204 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
.claude/commands/shared/compression-patterns.yml
View File

@@ -21,7 +21,7 @@ Activation_Triggers:
Manual_Flags: ["--ultracompressed", "--uc"]
Natural_Language: ["ultracompressed", "minimal tokens", "telegram style", "compress output"]
Automatic_Triggers:
Context_Threshold: ">70% context used"
Context_Threshold: "High context usage"
Token_Budget: "User specifies token limit"
Session_History: "User previously requested compression"
Task_Operations: "Always for task files"
@@ -205,12 +205,12 @@ Error_Messages:
```yaml
Compression_Metrics:
Token_Reduction:
Target: "70% reduction"
Minimum: "50% reduction"
Target: "Substantial reduction"
Minimum: "Significant reduction"
Measure: "Compare before/after token count"
Clarity_Preservation:
Requirement: ">80% information retained"
Requirement: "Essential information retained"
Test: "Key facts still accessible"
Validation: "No critical info lost"
@@ -240,7 +240,7 @@ Performance_Guidelines:
```yaml
Context_Sensitive_Compression:
High_Context_Usage:
Threshold: ">70%"
Threshold: "High context usage"
Action: "Auto-enable UC mode"
Notice: "⚡ UC mode: high context"
@@ -256,15 +256,15 @@ Context_Sensitive_Compression:
Progressive_Compression:
Level_1_Light:
Context: "50-70%"
Context: "Moderate to high usage"
Actions: "Remove articles, use common abbreviations"
Level_2_Medium:
Context: "70-85%"
Context: "High usage"
Actions: "Full UC mode, all rules active"
Level_3_Heavy:
Context: ">85%"
Context: "Very high usage"
Actions: "Extreme compression, summary only"
```

2
.claude/commands/shared/docs-patterns.yml
View File

@@ -99,7 +99,7 @@ Document_Standards:
Duration: "Operation time"
UltraCompressed_Mode:
Token_Reduction: "~70% from standard format"
Token_Reduction: "Substantial reduction from standard format"
Symbols_Required: "→ & @ ∀ ∃ ∴ ∵ based on legend"
Structure: "YAML > Tables > Lists > Prose"
Legend_Requirement: "Auto-generate symbol/abbreviation legend"

74
.claude/commands/shared/execution-patterns.yml
View File

@@ -18,13 +18,13 @@
Standard_Lifecycle:
Pre_Execution:
Risk_Assessment:
Calculate: "Score operation risk 1-10"
Calculate: "Assess operation risk level"
Factors: ["Data loss potential", "Irreversibility", "Scope", "Security"]
Actions:
Low_1_3: "Proceed w/ monitoring"
Med_4_6: "Warn & log"
High_7_9: "Require confirmation"
Critical_10: "Block & alert"
Low: "Proceed w/ monitoring"
Medium: "Warn & log"
High: "Require confirmation"
Critical: "Block & alert"
Environment_Validation:
Check: ["Required tools", "Permissions", "Resources", "Dependencies"]
Verify: ["Git state", "Network access", "Disk space", "Memory"]
@@ -65,32 +65,32 @@ Servers:
Context7:
Purpose: "Library documentation and code examples"
Best_For: ["API usage", "framework patterns", "library integration"]
Token_Cost: "Low-Medium (100-2000 tokens)"
Token_Cost: "Low-Medium usage"
Capabilities:
- resolve-library-id: "Find Context7-compatible library ID"
- get-library-docs: "Fetch up-to-date documentation"
Success_Rate: "95% for popular libraries"
Success_Rate: "Very high for popular libraries"
Fallback: "WebSearch official docs"
Sequential:
Purpose: "Step-by-step complex problem solving"
Best_For: ["Architecture", "debugging", "system design", "root cause analysis"]
Token_Cost: "Medium-High (500-10000 tokens)"
Token_Cost: "Medium-High usage"
Capabilities:
- sequentialthinking: "Adaptive multi-step reasoning"
Success_Rate: "90% for complex problems"
Success_Rate: "High for complex problems"
Fallback: "Native step-by-step analysis"
Magic:
Purpose: "UI component generation with 21st.dev"
Best_For: ["React/Vue components", "UI patterns", "prototypes"]
Token_Cost: "Medium (500-2000 tokens)"
Token_Cost: "Medium usage"
Capabilities:
- 21st_magic_component_builder: "Generate UI components"
- 21st_magic_component_refiner: "Improve existing components"
- 21st_magic_component_inspiration: "Search component library"
- logo_search: "Find company logos in TSX/JSX/SVG"
Success_Rate: "85% for common components"
Success_Rate: "High for common components"
Fallback: "Search existing components in project"
Puppeteer:
@@ -104,7 +104,7 @@ Servers:
- click: "Click elements"
- fill: "Fill form inputs"
- evaluate: "Execute JavaScript"
Success_Rate: "98% for standard web interactions"
Success_Rate: "Very high for standard web interactions"
Fallback: "Manual testing guidance"
MCP_Control_Flags:
@@ -181,7 +181,7 @@ Full_Stack_Development:
Chain: "load→analyze→design→build→test→scan→deploy"
Flags: ["--think", "--magic", "--validate"]
MCP_Usage: ["--c7 for docs", "--magic for UI", "--seq for design"]
Time: "45-90 minutes"
Time: "Typical development session"
Context_Handoff:
load→analyze: "Project understanding"
analyze→design: "Issues & architecture"
@@ -194,19 +194,19 @@ Feature_Implementation:
Chain: "analyze --code→design --feature→build --feature→test→git --commit"
Flags: ["--think", "--magic"]
MCP_Usage: ["--magic for components", "--c7 for patterns"]
Time: "20-45 minutes"
Time: "Moderate duration"
Bug_Investigation_Fix:
Chain: "troubleshoot --investigate→analyze --code→improve --quality→test→git --commit"
Flags: ["--think-hard", "--seq"]
MCP_Usage: ["--seq for investigation", "--c7 for solutions"]
Time: "15-60 minutes"
Time: "Variable duration"
Tech_Debt_Reduction:
Chain: "analyze --architecture→design --refactor→improve --quality→test→document"
Flags: ["--think-hard", "--refactor", "--quality"]
MCP_Usage: ["--seq for analysis", "--c7 for patterns"]
Time: "60-180 minutes"
Time: "Extended session"
```
## Git Integration Patterns
@@ -270,10 +270,10 @@ Checkpoint_Management:
- "Production deployments"
- "Data migrations"
Risk_Based:
Score_7_9: "Create checkpoint"
Score_10: "Checkpoint + backup"
High_Score: "Create checkpoint"
Critical_Score: "Checkpoint + backup"
Time_Based:
Interval: "Every 30 min during long ops"
Interval: "Regular intervals during long ops"
Checkpoint_Contents:
State_Snapshot:
@@ -309,10 +309,10 @@ Checkpoint_Management:
```yaml
Cost_Categories:
Native_Tools: "0 tokens"
Light_MCP: "100-500 tokens"
Medium_MCP: "500-2000 tokens"
Heavy_MCP: "2000-10000 tokens"
Native_Tools: "No token cost"
Light_MCP: "Minimal usage"
Medium_MCP: "Moderate usage"
Heavy_MCP: "Extensive usage"
Budget_Escalation:
1: "Native first for simple tasks"
@@ -321,7 +321,7 @@ Budget_Escalation:
4: "Combine MCPs for synergy"
Abort_Conditions:
Context_Usage: ">50% context → native tools"
Context_Usage: "High context usage → native tools"
Timeout_Errors: "MCP timeout/error → fallback"
Diminishing_Returns: "Poor results → stop MCP usage"
@@ -367,19 +367,19 @@ Performance_Tracking:
Update: "Update weekly"
Analysis: "Identify regressions"
Alert_Thresholds:
Build_Time: "> 50% from baseline"
Bundle_Size: "> 20% from baseline"
Test_Time: "> 30% from baseline"
Memory: "> 2x baseline"
MCP_Timeout: "> 30 seconds"
Build_Time: "Significant increase from baseline"
Bundle_Size: "Notable increase from baseline"
Test_Time: "Substantial increase from baseline"
Memory: "Major increase from baseline"
MCP_Timeout: "Extended duration"
Storage: ".claudedocs/metrics/performance-{YYYY-MM-DD}.jsonl"
Server_Performance:
Response_Times:
Context7: "1-5 seconds (network dependent)"
Sequential: "5-30 seconds (complexity dependent)"
Magic: "3-15 seconds (component complexity)"
Puppeteer: "1-10 seconds (page load dependent)"
Context7: "Fast response (network dependent)"
Sequential: "Moderate duration (complexity dependent)"
Magic: "Fast to moderate (component complexity)"
Puppeteer: "Fast to moderate (page load dependent)"
Resource_Usage:
Context7: "Low CPU, Medium Network"
@@ -388,10 +388,10 @@ Server_Performance:
Puppeteer: "Medium CPU, Low Network"
Reliability_Scores:
Context7: "95% (dependent on library availability)"
Sequential: "98% (internal processing)"
Magic: "90% (external service dependency)"
Puppeteer: "95% (browser dependency)"
Context7: "Very high (dependent on library availability)"
Sequential: "Very high (internal processing)"
Magic: "High (external service dependency)"
Puppeteer: "Very high (browser dependency)"
```
## Command Integration

8
.claude/commands/shared/flag-inheritance.yml
View File

@@ -17,7 +17,7 @@ Universal_Always:
--plan: "Show execution plan before running"
Compression:
--uc: "UltraCompressed mode (~70% token reduction)"
--uc: "UltraCompressed mode (substantial token reduction)"
--ultracompressed: "Alias for --uc"
Thinking_Modes:
@@ -56,7 +56,7 @@ Quality_Assurance:
Performance:
--profile: "Detailed performance profiling & metrics"
--iterate: "Iterative improvement until threshold met"
--threshold: "Set target percentage (default 85%)"
--threshold: "Set quality target (default high)"
--watch-perf: "Continuous performance monitoring"
Development:
@@ -95,7 +95,7 @@ Quality_Commands:
--coverage: "Generate comprehensive test coverage"
--quality: "Focus on code quality improvements"
--iterate: "Iterative improvement until threshold"
--threshold: "Set target percentage (default 85%)"
--threshold: "Set quality target (default high)"
--all: "Comprehensive operation across all areas"
--quick: "Fast operation focusing on critical issues"
@@ -204,7 +204,7 @@ Template_Usage:
Duplication_Reduction:
Before: "~400 lines of flag definitions across 18 commands"
After: "~80 lines in template + ~120 lines command-specific"
Savings: "~200 lines (50% reduction in flag definitions)"
Savings: "Significant reduction in flag definitions"
Consistency_Improvements:
Standardized_Descriptions: "Single source of truth for flag meanings"

54
.claude/commands/shared/performance.yml
View File

@@ -61,43 +61,43 @@ Success_Rate_Monitoring:
```yaml
Command_Benchmarks:
Simple_Commands:
read_file: "<2s, <200 tokens"
edit_file: "<3s, <300 tokens"
analyze_single_file: "<5s, <500 tokens"
git_status: "<3s, <100 tokens"
read_file: "fast, minimal tokens"
edit_file: "fast, minimal tokens"
analyze_single_file: "fast, minimal tokens"
git_status: "fast, minimal tokens"
Medium_Commands:
build_component: "<30s, <2000 tokens"
test_execution: "<45s, <1500 tokens"
security_scan: "<60s, <3000 tokens"
analyze_multiple_files: "<45s, <2500 tokens"
build_component: "moderate duration, moderate tokens"
test_execution: "moderate duration, moderate tokens"
security_scan: "moderate duration, moderate tokens"
analyze_multiple_files: "moderate duration, moderate tokens"
Complex_Commands:
full_codebase_analysis: "<120s, <5000 tokens"
architecture_design: "<180s, <8000 tokens"
comprehensive_security_audit: "<300s, <10000 tokens"
full_codebase_analysis: "extended duration, extensive tokens"
architecture_design: "extended duration, extensive tokens"
comprehensive_security_audit: "extended duration, extensive tokens"
MCP_Server_Performance:
Context7: "<5s response, 100-2000 tokens typical"
Sequential: "<30s analysis, 500-10000 tokens typical"
Magic: "<10s generation, 500-2000 tokens typical"
Puppeteer: "<15s operation, minimal tokens"
Context7: "fast response, minimal to moderate tokens typical"
Sequential: "moderate analysis time, moderate to extensive tokens typical"
Magic: "fast generation, moderate tokens typical"
Puppeteer: "fast operation, minimal tokens"
Performance_Thresholds:
Time_Limits:
Yellow_Warning: ">30s operations → Consider alternatives"
Red_Alert: ">60s → Force timeout, explain delay, offer cancellation"
Critical: ">120s → Immediate intervention required"
Yellow_Warning: "Extended operations → Consider alternatives"
Red_Alert: "Very long operations → Force timeout, explain delay, offer cancellation"
Critical: "Excessive duration → Immediate intervention required"
Token_Limits:
Moderate_Usage: ">2K tokens single op → Simplify approach"
High_Usage: ">5K session → Suggest /compact mode"
Critical_Usage: ">10K → Force optimization"
Moderate_Usage: "High token usage single op → Simplify approach"
High_Usage: "Very high session usage → Suggest /compact mode"
Critical_Usage: "Excessive usage → Force optimization"
Error_Patterns:
Concern_Level: "3+ retries same operation → Switch strategy"
Concern_Level: "Multiple retries same operation → Switch strategy"
Critical_Level: "Repeated failures → Escalate to manual approach"
System_Issue: "5+ consecutive failures → System health check"
System_Issue: "Many consecutive failures → System health check"
```
## Adaptive Optimization Strategies
@@ -105,7 +105,7 @@ Performance_Thresholds:
```yaml
Real_Time_Performance_Optimization:
Slow_Operations_Response:
Detection: "Operations exceeding 30s threshold"
Detection: "Operations exceeding moderate duration threshold"
Immediate_Actions:
- Switch to faster tools (rg vs grep, parallel processing)
- Reduce operation scope (specific files vs full scan)
@@ -113,7 +113,7 @@ Real_Time_Performance_Optimization:
- Break large operations into smaller chunks
High_Token_Usage_Response:
Detection: ">70% context or >5K tokens in single operation"
Detection: "High context usage or extensive tokens in single operation"
Immediate_Actions:
- Auto-suggest UltraCompressed mode (--uc)
- Cache repeated content and use references
@@ -122,7 +122,7 @@ Real_Time_Performance_Optimization:
Error_Pattern_Response:
Repeated_Failures:
Detection: "3+ failures of same operation type"
Detection: "Multiple failures of same operation type"
Actions:
- Switch to alternative tool/approach
- Adjust strategy based on error type
@@ -165,7 +165,7 @@ When_Errors_Occur:
```yaml
Data_Collection:
Lightweight_Tracking:
Performance_Impact: "<1% overhead on operations"
Performance_Impact: "Minimal overhead on operations"
Background_Collection: "No user interruption during monitoring"
Privacy_Preserving: "Local storage only, no external transmission"
User_Configurable: "Can be disabled via settings"

48
.claude/commands/shared/quality-patterns.yml
View File

@@ -13,28 +13,28 @@
```yaml
Severity_Levels:
CRITICAL_10:
CRITICAL:
Definition: "Data loss, security breach, production down"
Response: "Immediate stop, alert, rollback, incident response"
Recovery: "Manual intervention required"
Response_Time: "< 1 second"
Response_Time: "Immediate"
Examples: ["Delete prod data", "Expose secrets", "Force push main"]
HIGH_7_9:
HIGH:
Definition: "Build failure, test failure, deployment issues"
Response: "Stop workflow, notify user, suggest fixes"
Recovery: "Automated retry w/ backoff"
Response_Time: "< 10 seconds"
Response_Time: "Rapid"
Examples: ["Syntax error", "Permission denied", "Test failure"]
MEDIUM_4_6:
MEDIUM:
Definition: "Warning conditions, performance issues, code quality"
Response: "Continue w/ warning, log for review"
Recovery: "Attempt optimization, monitor"
Response_Time: "< 60 seconds"
Response_Time: "Standard"
Examples: ["Slow operation", "Deprecated API", "Large file"]
LOW_1_3:
LOW:
Definition: "Info messages, style violations, suggestions"
Response: "Note in output, continue"
Recovery: "Background fixes, cleanup"
@@ -67,15 +67,15 @@ Validation_Sequence:
Risk_Assessment:
Score_Factors:
Data_Loss: "+3 | Irreversibility: +2"
Scope: "+2 | Security: +3"
Backup: "-2 | Test_Coverage: -1"
Sandbox: "-2 | Checkpoint: -1"
Data_Loss: "High impact | Irreversibility: Moderate impact"
Scope: "Moderate impact | Security: High impact"
Backup: "Reduces risk | Test_Coverage: Slightly reduces risk"
Sandbox: "Reduces risk | Checkpoint: Slightly reduces risk"
Thresholds:
Low_1_3: "Proceed w/ info"
Medium_4_6: "Warn & confirm"
High_7_9: "Require approval"
Critical_10: "Block completely"
Low: "Proceed w/ info"
Medium: "Warn & confirm"
High: "Require approval"
Critical: "Block completely"
```
## Error Handling Patterns
@@ -85,7 +85,7 @@ Error_Categories:
Transient:
Types: ["Network timeout", "Resource busy", "Rate limit"]
Strategy: "Exponential backoff retry"
Retry: "Base 1s, Max 60s, 3 attempts, ±25% jitter"
Retry: "Base short, Max moderate duration, multiple attempts, with jitter"
Permanent:
Types: ["Syntax error", "Permission denied", "Not found"]
@@ -101,8 +101,8 @@ Error_Categories:
Strategy: "Monitor, cleanup, queue management"
Circuit_Breaker:
Threshold: "3 consecutive failures"
Recovery: "5 minutes before re-enable"
Threshold: "Multiple consecutive failures"
Recovery: "Brief pause before re-enable"
States:
Closed: "Normal operation"
Open: "Blocking calls after threshold"
@@ -114,8 +114,8 @@ Circuit_Breaker:
```yaml
Automatic_Recovery:
Retry_Patterns:
Simple: "3 attempts, 1s delay"
Exponential: "1s→2s→4s→8s w/ jitter"
Simple: "Multiple attempts, short delay"
Exponential: "Progressive backoff w/ jitter"
Circuit: "Stop after threshold"
Fallback_Options:
Alternative: "Use native if MCP fails"
@@ -192,10 +192,10 @@ Context_Preservation:
Partial: "Use completed work in recovery"
Health_Monitoring:
Frequency: "Every 5 min during active use"
Timeout: "3 seconds per check"
Degradation: ">30s response → switch alternatives"
Recovery: "Re-enable after 5 minutes"
Frequency: "Regular intervals during active use"
Timeout: "Brief timeout per check"
Degradation: "Slow response → switch alternatives"
Recovery: "Re-enable after brief pause"
```
## Command-Specific Recovery

2
.claude/commands/shared/security-patterns.yml
View File

@@ -221,7 +221,7 @@ Infrastructure_Security:
Validation_Levels:
Quick_Scan:
Scope: "Critical security issues only"
Time: "< 30 seconds"
Time: "Brief duration"
Focus: ["Hardcoded secrets", "SQL injection", "XSS", "Known CVEs"]
Output: "High-priority findings only"

2
.claude/commands/shared/session-recovery.yml
View File

@@ -104,7 +104,7 @@ checkpoint_restoration:
```yaml
graceful_pause:
auto_triggers:
- context >90% full
- context very high usage
- long inactivity
- error thresholds

2
.claude/commands/shared/system-config.yml
View File

@@ -13,7 +13,7 @@
```yaml
Session_Settings:
Memory_Management:
Context_Limit: "70% warning, 90% critical"
Context_Limit: "High usage warning, very high critical"
Cache_Duration: "30 minutes active session"
Auto_Cleanup: "Clear expired context every 5 minutes"
Persistence: "Store successful workflows across sessions"

54
.claude/commands/shared/universal-constants.yml
View File

@@ -168,32 +168,32 @@ Severity_Levels:
```yaml
Time_Limits:
Quick_Operation: "< 5 seconds"
Standard_Operation: "< 30 seconds"
Long_Operation: "< 120 seconds"
Critical_Timeout: "300 seconds (5 minutes)"
Session_Timeout: "1800 seconds (30 minutes)"
Quick_Operation: "Fast"
Standard_Operation: "Moderate duration"
Long_Operation: "Extended duration"
Critical_Timeout: "Maximum allowed duration"
Session_Timeout: "Extended session limit"
Token_Limits:
Small_Response: "< 500 tokens"
Medium_Response: "< 2000 tokens"
Large_Response: "< 5000 tokens"
Context_Warning: "> 70% context size"
Context_Critical: "> 90% context size"
Small_Response: "Minimal usage"
Medium_Response: "Moderate usage"
Large_Response: "Extensive usage"
Context_Warning: "High context usage"
Context_Critical: "Very high context usage"
File_Size_Limits:
Small_File: "< 10 KB"
Medium_File: "< 100 KB"
Large_File: "< 1 MB"
Huge_File: "> 1 MB"
Max_Analysis: "5 MB"
Small_File: "Minimal size"
Medium_File: "Moderate size"
Large_File: "Large size"
Huge_File: "Very large size"
Max_Analysis: "Maximum analyzable size"
Retry_Limits:
Default_Retries: 3
Network_Retries: 5
File_Lock_Retries: 3
MCP_Server_Retries: 3
Max_Consecutive_Failures: 5
Default_Retries: "Multiple attempts"
Network_Retries: "Several attempts"
File_Lock_Retries: "Multiple attempts"
MCP_Server_Retries: "Multiple attempts"
Max_Consecutive_Failures: "Several failures"
```
## Standard Priority & Status Values
@@ -206,16 +206,10 @@ Priority_Levels:
Low: "low"
Severity_Numbers:
Critical: 10
High_Max: 9
High_Mid: 8
High_Min: 7
Medium_Max: 6
Medium_Mid: 5
Medium_Min: 4
Low_Max: 3
Low_Mid: 2
Low_Min: 1
Critical: "Maximum severity"
High: "High severity"
Medium: "Medium severity"
Low: "Low severity"
Status_Values:
Pending: "pending"

6
.claude/commands/shared/user-experience.yml
View File

@@ -98,9 +98,9 @@ Learning from Errors:
```yaml
Response Time Expectations:
Immediate (<100ms): Command acknowledgment, simple queries
Fast (<1s): File operations, simple analysis
Moderate (<10s): Complex analysis, building, testing
Immediate: Command acknowledgment, simple queries
Fast: File operations, simple analysis
Moderate: Complex analysis, building, testing
Long (>10s): Deployment, migration, comprehensive operations
Progress Communication: