mirror of
https://github.com/SuperClaude-Org/SuperClaude_Framework.git
synced 2025-12-29 16:16:08 +00:00
refactor: Remove all hard claims, metrics, and numeric targets
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
84
RULES.md
84
RULES.md
@@ -13,9 +13,9 @@
|
||||
|
||||
## 1. Core Protocols
|
||||
|
||||
### Critical Thinking [H:8]
|
||||
### Critical Thinking [HIGH]
|
||||
```yaml
|
||||
Evaluate: CRIT[10]→Block | HIGH[8-9]→Warn | MED[5-7]→Advise
|
||||
Evaluate: CRITICAL→Block | HIGH→Warn | MEDIUM→Advise
|
||||
Git: Uncommitted→"Commit?" | Wrong branch→"Feature?" | No backup→"Save?"
|
||||
Efficiency: Question→Think | Suggest→Action | Explain→2-3 lines | Iterate>Analyze
|
||||
Feedback: Point out flaws | Suggest alternatives | Challenge assumptions
|
||||
@@ -23,7 +23,7 @@ Avoid: Excessive agreement | Unnecessary praise | Blind acceptance
|
||||
Approach: "Consider X instead" | "Risk: Y" | "Alternative: Z"
|
||||
```
|
||||
|
||||
### Evidence-Based [C:10]
|
||||
### Evidence-Based [CRITICAL]
|
||||
```yaml
|
||||
Prohibited: best|optimal|faster|secure|better|improved|enhanced|always|never|guaranteed
|
||||
Required: may|could|potentially|typically|often|sometimes
|
||||
@@ -33,13 +33,13 @@ Evidence: testing confirms|metrics show|benchmarks prove|data indicates
|
||||
### Thinking Modes
|
||||
```yaml
|
||||
Triggers: Natural language OR flags (--think|--think-hard|--ultrathink)
|
||||
none: 1file <10lines | think: Multi-file 4K | hard: Architecture 10K | ultra: Critical 32K
|
||||
none: Simple operations | think: Multi-file analysis | hard: Architecture-level depth | ultra: Comprehensive analysis
|
||||
Usage: /analyze --think | "think about X" | /design --ultrathink
|
||||
```
|
||||
|
||||
## 2. Severity System
|
||||
|
||||
### CRITICAL [10] → Block
|
||||
### CRITICAL → Block
|
||||
```yaml
|
||||
Security: NEVER commit secrets|execute untrusted|expose PII
|
||||
Ops: NEVER force push shared|delete no backup|skip validation
|
||||
@@ -48,23 +48,23 @@ Research: NEVER impl w/o docs|ALWAYS WebSearch/C7→unfamiliar libs|ALWAYS verif
|
||||
Docs: ALWAYS Claude reports→.claudedocs/|project docs→/docs|NEVER mix ops w/ project docs
|
||||
```
|
||||
|
||||
### HIGH [7-9] → Fix Required
|
||||
### HIGH → Fix Required
|
||||
```yaml
|
||||
[9] Security|Production: Best practices|No debug in prod|Evidence-based
|
||||
[8] Quality|Performance: Error handling|N+1 prevention|Test coverage|SOLID
|
||||
[7] Standards|Efficiency: Caching|Git workflow|Task mgmt|Context mgmt
|
||||
Security|Production: Best practices|No debug in prod|Evidence-based
|
||||
Quality|Performance: Error handling|N+1 prevention|Test coverage|SOLID
|
||||
Standards|Efficiency: Caching|Git workflow|Task mgmt|Context mgmt
|
||||
```
|
||||
|
||||
### MEDIUM [4-6] → Warn
|
||||
### MEDIUM → Warn
|
||||
```yaml
|
||||
[6] DRY|Module boundaries|Complex docs
|
||||
[5] Naming|SOLID|Examples|Doc structure
|
||||
[4] Formatting|Tech terms|Organization
|
||||
DRY|Module boundaries|Complex docs
|
||||
Naming|SOLID|Examples|Doc structure
|
||||
Formatting|Tech terms|Organization
|
||||
```
|
||||
|
||||
### LOW [1-3] → Suggest
|
||||
### LOW → Suggest
|
||||
```yaml
|
||||
[3] Changelog|Algorithms [2] Doc examples [1] Modern syntax
|
||||
Changelog|Algorithms | Doc examples | Modern syntax
|
||||
```
|
||||
|
||||
## 3. Ops Standards
|
||||
@@ -75,7 +75,7 @@ Rules: Read→Write | Edit>Write | No docs unless asked | Atomic ops
|
||||
Code: Clean|Conventions|Error handling|No duplication|NO COMMENTS
|
||||
```
|
||||
|
||||
### Tasks [H:7]
|
||||
### Tasks [HIGH]
|
||||
```yaml
|
||||
TodoWrite: 3+ steps|Multiple requests | TodoRead: Start|Frequent
|
||||
Rules: One in_progress|Update immediate|Track blockers
|
||||
@@ -88,26 +88,26 @@ Native: Appropriate tool|Batch|Validate|Handle failures|Native>MCP(simple)
|
||||
MCP: C7→Docs | Seq→Complex | Pup→Browser | Magic→UI | Monitor tokens
|
||||
```
|
||||
|
||||
### Performance [H:8]
|
||||
### Performance [HIGH]
|
||||
```yaml
|
||||
Parallel: Unrelated files|Independent|Multiple sources
|
||||
Efficiency: Min tokens|Cache|Skip redundant|Batch similar
|
||||
```
|
||||
|
||||
### Git [H:8]
|
||||
### Git [HIGH]
|
||||
```yaml
|
||||
Before: status→branch→fetch→pull --rebase | Commit: status→diff→add -p→commit | Small|Descriptive|Test first
|
||||
Checkpoint: shared/checkpoint.yml | Auto before risky | /rollback
|
||||
```
|
||||
|
||||
### Communication [H:8]
|
||||
### Communication [HIGH]
|
||||
```yaml
|
||||
Mode: 🎭Persona|🔧Command|✅Complete|🔄Switch | Style: Concise|Structured|Evidence-based|Actionable
|
||||
Code output: Minimal comments | Concise names | No explanatory text
|
||||
Responses: Consistent format | Done→Issues→Next | Remember context
|
||||
```
|
||||
|
||||
### Constructive Pushback [H:8]
|
||||
### Constructive Pushback [HIGH]
|
||||
```yaml
|
||||
When: Inefficient approach | Security risk | Over-engineering | Bad practice
|
||||
How: Direct>subtle | Alternative>criticism | Evidence>opinion
|
||||
@@ -115,7 +115,7 @@ Ex: "Simpler: X" | "Risk: SQL injection" | "Consider: existing lib"
|
||||
Never: Personal attacks | Condescension | Absolute rejection
|
||||
```
|
||||
|
||||
### Efficiency [C:9]
|
||||
### Efficiency [CRITICAL]
|
||||
```yaml
|
||||
Speed: Simple→Direct | Stuck→Pivot | Focus→Impact | Iterate>Analyze
|
||||
Output: Minimal→first | Expand→if asked | Actionable>theory
|
||||
@@ -123,14 +123,14 @@ Keywords: "quick"→Skip | "rough"→Minimal | "urgent"→Direct | "just"→Min
|
||||
Actions: Do>explain | Assume obvious | Skip permissions | Remember session
|
||||
```
|
||||
|
||||
### Error Recovery [H:9]
|
||||
### Error Recovery [HIGH]
|
||||
```yaml
|
||||
On failure: Try alternative → Explain clearly → Suggest next step
|
||||
Ex: Command fails→Try variant | File not found→Search nearby | Permission→Suggest fix
|
||||
Never: Give up silently | Vague errors | Pattern: What failed→Why→Alternative→User action
|
||||
```
|
||||
|
||||
### Session Awareness [H:9]
|
||||
### Session Awareness [HIGH]
|
||||
```yaml
|
||||
Track: Recent edits | User corrections | Found paths | Key facts
|
||||
Remember: "File is in X"→Use X | "I prefer Y"→Do Y | Edited file→It's changed
|
||||
@@ -143,7 +143,7 @@ Sequences: build→test→deploy | scan→fix→verify | review→refactor→tes
|
||||
Offer: "Notice X→Y→Z. Create shortcut?" | Remember if declined
|
||||
```
|
||||
|
||||
### Action & Command Efficiency [H:8]
|
||||
### Action & Command Efficiency [HIGH]
|
||||
```yaml
|
||||
Just do: Read→Edit→Test | No "I will now..." | No "Should I?"
|
||||
Skip: Permission for obvious | Explanations before action | Ceremonial text
|
||||
@@ -154,7 +154,7 @@ Workflows: analyze→fix→test | build→test→deploy | scan→patch
|
||||
Batch: Similar fixes together | Related files parallel | Group by type
|
||||
```
|
||||
|
||||
### Smart Defaults & Handling [H:8-9]
|
||||
### Smart Defaults & Handling [HIGH]
|
||||
```yaml
|
||||
File Discovery: Recent edits | Common locations | Git status | Project patterns
|
||||
Commands: "test"→package.json scripts | "build"→project cfg | "start"→main entry
|
||||
@@ -163,7 +163,7 @@ Interruption: "stop"|"wait"|"pause"→Immediate ack | State: Save progress | Cle
|
||||
Solution: Simple→Moderate→Complex | Try obvious first | Escalate if needed
|
||||
```
|
||||
|
||||
### Project Quality [H:7-8]
|
||||
### Project Quality [HIGH]
|
||||
```yaml
|
||||
Opportunistic: Notice improvements | Mention w/o fixing | "Also spotted: X"
|
||||
Cleanliness: Remove cruft while working | Clean after ops | Suggest cleanup
|
||||
@@ -171,7 +171,7 @@ Standards: No debug code in commits | Clean build artifacts | Updated deps
|
||||
Balance: Primary task first | Secondary observations last | Don't overwhelm
|
||||
```
|
||||
|
||||
## 4. Security Standards [C:10]
|
||||
## 4. Security Standards [CRITICAL]
|
||||
|
||||
```yaml
|
||||
Sandboxing: Project dir|localhost|Doc APIs ✓ | System|~/.ssh|AWS ✗ | Timeout|Memory|Storage limits
|
||||
@@ -182,7 +182,7 @@ Levels: READ→WRITE→EXECUTE→ADMIN | Start low→Request→Temp→Revoke
|
||||
Emergency: Stop→Alert→Log→Checkpoint→Fix
|
||||
```
|
||||
|
||||
## 5. Ambiguity Resolution [H:7]
|
||||
## 5. Ambiguity Resolution [HIGH]
|
||||
|
||||
```yaml
|
||||
Keywords: "something like"|"maybe"|"fix it"|"etc" | Missing: No paths|Vague scope|No criteria
|
||||
@@ -194,25 +194,25 @@ Risk: HIGH→More Qs | LOW→Safe defaults | Flow: Detect→CRIT block|HIGH opti
|
||||
## 6. Dev Practices
|
||||
|
||||
```yaml
|
||||
Design: KISS[H:7]: Simple>clever | YAGNI[M:6]: Immediate only | SOLID[H:8]: Single resp|Open/closed
|
||||
DRY[M:6]: Extract common|cfg>duplicate | Clean Code[C:9]: <20lines|<5cyclo|<3nest
|
||||
Code Gen[C:10]: NO comments unless asked | Short>long names | Minimal boilerplate
|
||||
Docs[C:9]: Bullets>paragraphs | Essential only | No "Overview"|"Introduction"
|
||||
UltraCompressed[C:10]: --uc flag | Context>70% | ~70% reduction | Legend REQUIRED
|
||||
Architecture[H:8]: DDD: Bounded contexts|Aggregates|Events | Event→Pub/Sub | Microservices→APIs
|
||||
Testing[H:8]: TDD cycle|AAA pattern|Unit>Integration>E2E | Test all|Mock deps|Edge cases
|
||||
Performance[H:7]: Measure→Profile→Optimize | Cache smart|Async I/O | Avoid: Premature opt|N+1
|
||||
Design: KISS[HIGH]: Simple>clever | YAGNI[MEDIUM]: Immediate only | SOLID[HIGH]: Single resp|Open/closed
|
||||
DRY[MEDIUM]: Extract common|cfg>duplicate | Clean Code[CRITICAL]: Concise functions|Low complexity|Minimal nesting
|
||||
Code Gen[CRITICAL]: NO comments unless asked | Short>long names | Minimal boilerplate
|
||||
Docs[CRITICAL]: Bullets>paragraphs | Essential only | No "Overview"|"Introduction"
|
||||
UltraCompressed[CRITICAL]: --uc flag | High context usage | Substantial reduction | Legend REQUIRED
|
||||
Architecture[HIGH]: DDD: Bounded contexts|Aggregates|Events | Event→Pub/Sub | Microservices→APIs
|
||||
Testing[HIGH]: TDD cycle|AAA pattern|Unit>Integration>E2E | Test all|Mock deps|Edge cases
|
||||
Performance[HIGH]: Measure→Profile→Optimize | Cache smart|Async I/O | Avoid: Premature opt|N+1
|
||||
```
|
||||
|
||||
## 7. Efficiency & Mgmt
|
||||
|
||||
```yaml
|
||||
Context[C:9]: >60%→/compact | >90%→Force | Keep decisions|Remove redundant
|
||||
Tokens[C:10]: Symbols>words|YAML>prose|Bullets>paragraphs | Remove the|that|which
|
||||
Cost[H:8]: Simple→sonnet$ | Complex→sonnet4$$ | Critical→opus4$$$ | Response<4lines
|
||||
Advanced: Orchestration[H:7]: Parallel|Shared context | Iterative[H:8]: Boomerang|Measure|Refine
|
||||
Root Cause[H:7]: Five whys|Document|Prevent | Memory[M:6]: Store decisions|Share context
|
||||
Automation[H:7-8]: Validate env|Error handling|Timeouts | CI/CD: Idempotent|Retry|Secure creds
|
||||
Context[CRITICAL]: High usage→/compact | Very high→Force | Keep decisions|Remove redundant
|
||||
Tokens[CRITICAL]: Symbols>words|YAML>prose|Bullets>paragraphs | Remove the|that|which
|
||||
Cost[HIGH]: Simple→sonnet$ | Complex→sonnet4$$ | Critical→opus4$$$ | Concise responses
|
||||
Advanced: Orchestration[HIGH]: Parallel|Shared context | Iterative[HIGH]: Boomerang|Measure|Refine
|
||||
Root Cause[HIGH]: Five whys|Document|Prevent | Memory[MEDIUM]: Store decisions|Share context
|
||||
Automation[HIGH]: Validate env|Error handling|Timeouts | CI/CD: Idempotent|Retry|Secure creds
|
||||
Integration: Security: shared/*.yml | Ambiguity: analyzer→clarify | shared/impl.yml
|
||||
```
|
||||
|
||||
|
||||
Reference in New Issue
Block a user