🏛️ Claude Code Rules & Framework 🏛️

Your Claude Code AI assistant, elevated to professional standards

100% Factual Accuracy

82% Token Savings

50% Faster Response

100% Constitutional

---

📑 Table of Contents

• ⚡ Quick Start
• 📦 Installation
• 🔗 Integration Guide
• ✨ Features
• 📁 Rule Files
• 🖼️ Visual Guide
• 🎓 Framework Highlights
• 📊 Before & After
• 🤝 Contributing

---

⚡ Quick Start

# 🚀 One-line installation - Clone and install
git clone https://github.com/DarKWinGTM/claude-code-rules.git && \
mkdir -p ~/.claude/rules && \
cp claude-code-rules/*.md ~/.claude/rules/

✨ That's it! Your Claude Code is now enhanced with professional rules.

---

📦 Installation

🎯 Method 1: Full Installation (Recommended)

Complete setup with all rules:

# Step 1: Clone the repository
git clone https://github.com/DarKWinGTM/claude-code-rules.git
cd claude-code-rules

# Step 2: Create rules directory (if not exists)
mkdir -p ~/.claude/rules

# Step 3: Copy all rule files
cp *.md ~/.claude/rules/

# Step 4: Verify installation
ls ~/.claude/rules/

# Step 5 (optional): Verify unified controller rule exists
ls ~/.claude/rules/unified-version-control-system.md

🎯 Method 2: Pick Your Rules

Install only what you need:

# Example: Install just the anti-sycophancy rule
curl -o ~/.claude/rules/anti-sycophancy.md \
  https://raw.githubusercontent.com/DarKWinGTM/claude-code-rules/master/anti-sycophancy.md

🎯 Method 3: Project-Specific

Add rules to a single project:

# In your project directory
mkdir -p .claude/rules
cp /path/to/claude-code-rules/*.md .claude/rules/

📍 Installation Paths

Location	Scope	Path	Use Case
Global	All projects	~/.claude/rules/*.md	Default recommendation
Project	Current project only	./.claude/rules/*.md	Project-specific needs

📂 Design Documentation Structure

Location	Purpose	File Type
./design/*.design.md	Design specifications	Design docs
*.md (root)	Working rules	Rules files
./changelog/*.md	Version history	Changelogs

💡 Single Source of Truth Principle:

• Design files (.design.md) contain Version History sections
• Rules files rely on Git for history tracking
• One authoritative source per document type

✅ Verify Installation

# Check if rules are loaded
claude --version
cat ~/.claude/rules/anti-sycophancy.md | head -20

---

🔗 Integration Guide

This section defines how design, changelog, runtime rules, and TODO should be updated together.

Document Roles

Document	Role	Update Trigger
design/*.design.md	Target behavior/specification	Requirement or policy change
*.md (root runtime rules)	Active runtime behavior	Approved design change requires runtime sync
changelog/*.changelog.md	Authoritative version history	Any rule/design update with version impact
TODO.md	Execution and progress tracking	Work starts/completes or task state changes

Recommended Update Flow

Change request received
  → Update design target state
  → Synchronize runtime rule wording
  → Record changelog version + summary
  → Update TODO pending/completed/history
  → Verify links, versions, and consistency

Verification Checklist

• Design file links to the correct changelog file
• Changelog unified row maps to an existing detailed section
• Runtime rule version/header aligns with changelog current version
• TODO pending section contains pending-only items (- [ ])
• TODO history has a dated entry for completed milestone work

Real Examples (This Repository)

Example 1: Deterministic Recovery Contract Synchronization (WS-1)

design/recovery-contract.design.md
  → recovery-contract.md
  → changelog/recovery-contract.changelog.md
  → TODO.md (history/progress)

What was synchronized:

• Deterministic response keys were aligned across design and runtime (decision_output, refusal_class, reason, what_can_be_done_now, how_to_proceed)
• Changelog recorded the runtime/design version sync event
• TODO recorded completion in the hardening program history

Example 2: Verification + Output-Cap Consolidation (WS-5)

design/safe-file-reading.design.md + design/safe-terminal-output.design.md
  → safe-file-reading.md + safe-terminal-output.md
  → changelog/safe-file-reading.changelog.md + changelog/safe-terminal-output.changelog.md
  → TODO.md (WS-5 completion)

What was synchronized:

• Shared verification-trigger model applied across related rules
• Deterministic output-cap wording standardized (head -100 | head -c 5000, risky-file variant)
• Changelog and TODO were updated to preserve traceability

Example 3: TODO Governance Alignment (WS-6)

TODO.md pending section audit
  → remove completed items from pending block
  → remove duplicate pending headings
  → add closure row in TODO history

What was synchronized:

• Pending section kept pending-only (- [ ])
• Duplicate heading drift removed
• Program closure logged in dated history row

---

✨ Features

🎯 Core Capabilities

🔍 Zero Hallucination 100% verified information only Evidence-based responses No guessing or assumptions Source citations always included	🛡️ Anti-Sycophancy Truth over agreement Direct corrections when needed No false praise Honest feedback, always
🔒 Security First Real systems over simulations No mock implementations by default Verified configurations only Production-ready patterns	⚡ Performance Optimized 30-50% faster responses 40-82% token reduction Adaptive complexity (TRAAC) Cost-efficient operations

---

📁 Rule Files

🔴 Core Policies (3 rules)

Fundamental principles that govern all AI behavior

Rule	Purpose	Key Benefit
anti-mockup.md	Real systems over simulations	No fake implementations
anti-sycophancy.md	Truth over agreement	Honest feedback always
zero-hallucination.md	Verified information only	100% accuracy

---

🟡 Quality & Safety (16 rules)

Ensure consistent, safe, and well-documented outputs

Rule	Purpose	Key Benefit
accurate-communication.md	Clear, honest communication	No vague claims
authority-and-scope.md	Decision hierarchy	User authority respected
dan-safe-normalization.md	Prompt-wrapper normalization	Safer intent evaluation before decisioning
document-consistency.md	Cross-reference validation	No contradictions
document-changelog-control.md	Version tracking system	Single Source of Truth
document-design-control.md	Design document standards	Standardized structure
document-patch-control.md	Patch Control	Tactical implementation plans
emergency-protocol.md	Crisis response	Fast, safe reactions
functional-intent-verification.md	Intent validation	Commands verified before run
recovery-contract.md	Blocked-response contract	Every constrained/refused path has actionable next steps
refusal-classification.md	Deterministic refusal taxonomy	Consistent block decisions and traceable output modes
refusal-minimization.md	False-refusal reduction	Prefer recoverable constrained/context paths when authorized
strict-file-hygiene.md	File hygiene	No unrequested docs
todo-standards.md	Task management	Focused work
project-documentation-standards.md	Project documentation standards	Standardized docs for all projects
unified-version-control-system.md	Unified version governance	Single deterministic UDVC-1 controller

---

🟢 Best Practices (4 rules)

Optimize your daily workflow efficiency

Rule	Purpose	Key Benefit
flow-diagram-no-frame.md	Clean ASCII diagrams	Better readability
no-variable-guessing.md	Read before reference	No wrong assumptions
safe-file-reading.md	Plan-before-read	Efficient file handling
safe-terminal-output.md	Output management	No terminal flooding

📊 Active Runtime Rules: 23

📊 Framework Summary: 23 active runtime rules

---

🖼️ Visual Guide

🔴 Core Policies Visual

Anti-Sycophancy Truth over pleasing

Anti-Mockup Real systems only

Zero Hallucination Verified info only

---

🟡 Quality & Safety Visual

Authority & Scope User authority supreme	Emergency Protocol Rapid response	Document Consistency Cross-reference check	Functional Intent Intent validation
Document Changelog Control Version tracking system	Document Design Control Design standards	Strict File Hygiene No unrequested docs	Project Documentation Standards Standardized docs

---

🟢 Best Practices Visual

Flow Diagram No frames, clean arrows

No Guessing Read before reference

Safe File Reading Plan before read

Safe Terminal Output management

---

🎓 Framework Highlights

🧠 TRAAC (Task Runtime Adaptive AI Compression)

Dynamic complexity adjustment based on task requirements

Simple Tasks (Level 0-2)     → Minimal Processing
     ↓
Standard Tasks (Level 3-5)   → Balanced Approach
     ↓
Complex Tasks (Level 6-7)    → Deep Analysis

Metric	Improvement	Impact
Response Speed	+30-50%	Faster answers
Token Efficiency	+40-82%	Lower costs
Cost Reduction	-25-35%	Budget-friendly

---

👥 TUMIX Multi-Agent System

Three expert perspectives analyzing every complex problem

Developer  ──┐
Security   ──┼──→ Unified Recommendation
Architect  ──┘

How It Works:

1. Developer Agent → Technical feasibility analysis
2. Security Agent → Security & privacy evaluation
3. Architect Agent → System design considerations
4. Synthesis → All perspectives merge into unified recommendation

Result: Comprehensive analysis from multiple angles

---

📚 RoT (Retrieval of Thoughts)

Cache and reuse verified reasoning patterns

Action	Benefit
Cache verified patterns	Store successful approaches
Reuse for similar tasks	40% speed improvement
Validate before use	Ensure accuracy maintained

Performance: 82% cache hit rate for recurring patterns

---

📊 Before & After

❌ Without Rules

User: "Set up database connection"
       ↓
AI: "Here's the connection string:
     DATABASE_URL=postgres://localhost:5432/mydb"

Result: ❌ Guessed values
        ❌ No verification
        ❌ Potentially wrong
        ❌ User frustrated

---

✅ With Rules

User: "Set up database connection"
       ↓
AI: "Let me check your .env file first..."
     [Reading configuration...]
     "Found your existing config:
      DATABASE_URL=postgres://prod-server:5432/app_db

      Should I use this, or do you want to change it?"

Result: ✅ Verified from actual files
        ✅ No guessing
        ✅ User confirmation
        ✅ Professional interaction

The difference? Professional AI behavior that respects your existing configuration.

---

📊 Performance Metrics

Metric	Target	Status	Impact
Factual Accuracy	100%	✅	Zero hallucinations
Constitutional Compliance	100%	✅	User sovereignty maintained
Token Efficiency	+40-82%	✅	Cost reduction
Response Speed	+30-50%	✅	Faster delivery
User Sovereignty	Absolute	✅	User always in control

---

🔒 Safety Guarantees

✅ Our Commitment to You

Guarantee	Description
No Mock/Stub	Real implementations unless explicitly requested
No Guessing	Always verify from actual sources
No Hallucinations	100% fact-based responses
No Sycophancy	Truth over agreement, always
Constitutional	Principles override everything

Your safety and accuracy are non-negotiable.

---

🤝 Contributing

These rules evolve based on real-world usage:

• 🔄 Real-world usage patterns → What actually works
• 💬 User feedback → Your experience matters
• 🔐 Safety considerations → Always improving
• ⚡ Performance optimization → Getting faster

📝 Contribution Guidelines

Pull requests welcome! Please ensure:

1. New rules follow existing format
2. Include clear documentation
3. Add visual assets if applicable
4. Update changelog

We value: Quality over quantity, clarity over complexity

---

📜 License

MIT License - Feel free to adapt for your own use case.

Attribution appreciated but not required.

---

🙏 Acknowledgments

Personal rule set and configuration framework for Claude Code CLI.

Inspired by:

• Constitutional AI principles (Anthropic)
• Best practices for AI assistant development
• Real-world production experience
• Community feedback and contributions

Built with ❤️ for the Claude Code community

---

---

Version: 2.1.0 | Last Updated: 2026-02-24 | Framework: Sophisticated AI Framework with Constitutional Governance

⬆️ Back to Top

---

_{Made with 💙 by developers who care about AI quality}