Docs consolidation

.claude/rules/command-routing.md

@@ -1,6 +1,6 @@
 # Dynamic Command Routing Rules
 
-This file defines intelligent routing logic for selecting optimal commands from **214+ commands across 25 categories**.
+This file defines intelligent routing logic for selecting optimal commands from **234 commands across 27 categories**.
 
 ## Smart Routing Configuration
 
@@ -104,11 +104,23 @@ CLASSIFICATION_TRIGGERS:
       prd_generation: true
       parallel_implementation: true
       quality_validation: true
+
+  decision_frameworks:
+    keywords: ["decide", "trade-off", "prioritize", "analyze decision", "first principles", "80/20", "root cause", "mental model"]
+    route_to: /consider:* commands
+
+  skill_management:
+    keywords: ["skill", "create skill", "audit skill", "heal skill", "skill authoring"]
+    route_to: /create-agent-skill OR /audit-skill OR /heal-skill
+
+  context_management:
+    keywords: ["context", "prime", "load context", "project context"]
+    route_to: /context:* commands
 ```
 
 ---
 
-## Complete Command Reference (214+ Commands)
+## Complete Command Reference (234 Commands)
 
 ### /sc:* - SuperClaude Commands (26 commands)
 Meta-routing and high-level operations.
@@ -142,6 +154,27 @@ Meta-routing and high-level operations.
 | `/sc:troubleshoot` | Debugging | "fix", "debug", "error", "broken" |
 | `/sc:workflow` | Workflow generation | "workflow", "process", "pipeline" |
 
+#### Root-Level Commands (15 commands)
+Direct commands without namespace prefix.
+
+| Command | Purpose | Use When |
+|---------|---------|----------|
+| `/create-plan` | Plan creation | "create plan", "plan project" |
+| `/create-prompt` | Prompt creation | "create prompt", "new prompt" |
+| `/create-hook` | Hook creation | "create hook", "new hook" |
+| `/create-subagent` | Subagent creation | "create agent", "new agent" |
+| `/create-agent-skill` | Skill creation | "create skill", "new skill" |
+| `/debug` | Debug mode | "debug", "investigate issue" |
+| `/run-plan` | Execute plan | "run plan", "execute plan" |
+| `/run-prompt` | Execute prompt | "run prompt" |
+| `/whats-next` | Next steps | "what's next", "continue work" |
+| `/check-todos` | Check todos | "check todos", "show todos" |
+| `/add-to-todos` | Add todo | "add todo" |
+| `/heal-skill` | Fix skills | "heal skill", "fix skill" |
+| `/audit-skill` | Audit skill | "audit skill" |
+| `/audit-slash-command` | Audit command | "audit command" |
+| `/audit-subagent` | Audit agent | "audit agent" |
+
 ---
 
 ### /sparc:* - SPARC Methodology (18 commands)
@@ -522,6 +555,53 @@ System-level operations.
 
 ---
 
+### /consider:* - Decision Frameworks (12 commands)
+Mental models and decision-making frameworks.
+
+| Command | Purpose | Use When |
+|---------|---------|----------|
+| `/consider:first-principles` | Break down to fundamentals | "first principles", "fundamental" |
+| `/consider:second-order` | Consequences of consequences | "second order", "ripple effects" |
+| `/consider:opportunity-cost` | What you give up | "opportunity cost", "trade-off" |
+| `/consider:pareto` | 80/20 analysis | "pareto", "80/20" |
+| `/consider:eisenhower-matrix` | Urgent/important matrix | "eisenhower", "prioritize" |
+| `/consider:inversion` | Solve backwards | "inversion", "reverse" |
+| `/consider:occams-razor` | Simplest explanation | "occam", "simplest" |
+| `/consider:5-whys` | Root cause drilling | "5 whys", "root cause" |
+| `/consider:swot` | Strengths/weaknesses | "swot", "strengths" |
+| `/consider:10-10-10` | Time horizon decisions | "10-10-10", "time horizon" |
+| `/consider:one-thing` | Highest leverage action | "one thing", "focus" |
+| `/consider:via-negativa` | Improve by removing | "via negativa", "remove" |
+
+---
+
+### /context:* - Context Management (3 commands)
+Project context and priming.
+
+| Command | Purpose | Use When |
+|---------|---------|----------|
+| `/context:create` | Create context | "create context" |
+| `/context:update` | Update context | "update context" |
+| `/context:prime` | Prime context | "prime", "load context" |
+
+---
+
+### Skills Integration (8 skills)
+Skills are invoked via the Skill tool for specialized guidance.
+
+| Skill | Trigger Keywords | Purpose |
+|-------|-----------------|---------|
+| `agent-sandboxes` | "sandbox", "isolated", "e2b" | E2B sandbox operations |
+| `create-agent-skills` | "create skill", "skill authoring" | Skill creation guidance |
+| `create-hooks` | "create hook", "hook config" | Hook development |
+| `create-meta-prompts` | "meta prompt", "prompt pipeline" | Multi-stage prompts |
+| `create-plans` | "create plan", "project plan" | Hierarchical planning |
+| `create-slash-commands` | "create command", "slash command" | Command development |
+| `create-subagents` | "create agent", "subagent" | Agent configuration |
+| `debug-like-expert` | "deep debug", "root cause analysis" | Expert debugging methodology |
+
+---
+
 ## Routing Algorithm
 
 ```yaml
@@ -579,3 +659,9 @@ When uncertain which command to use:
 | "Check status" | `/monitoring:status` | `/swarm:swarm-status` |
 | "What's next" | `/pm:next` | `/pm:status` |
 | "Not sure..." | `/sc:brainstorm` | `/sparc:innovator` |
+| "First principles" | `/consider:first-principles` | `/consider:5-whys` |
+| "Trade-off analysis" | `/consider:opportunity-cost` | `/consider:swot` |
+| "Prioritize tasks" | `/consider:eisenhower-matrix` | `/consider:pareto` |
+| "Create skill" | `/create-agent-skill` | Skill tool |
+| "Create hook" | `/create-hook` | Skill tool |
+| "Load context" | `/context:prime` | `/sc:load` |

README.md

@@ -10,6 +10,26 @@
 
 This project demonstrates advanced integration of five powerful frameworks to create a development environment where AI agents collaborate systematically, maintain perfect context across sessions, and deliver production-ready code through proven methodologies.
 
+## The C(RAID) Paradigm
+
+**Evolve operates on C(RAID)** - an evolution of CI/CD designed specifically for autonomous AI development:
+
+```
+Traditional CI/CD:  Code -> Build -> Test -> Deploy
+C(RAID):           Research -> Analysis -> Integration -> Deployment -> (feedback) -> Research
+```
+
+| Traditional CI/CD | C(RAID) Paradigm |
+|-------------------|------------------|
+| Starts with code (human wrote it) | Starts with research (AI must understand first) |
+| Human-driven development cycles | AI-driven autonomous cycles |
+| Integration happens AFTER development | Research and Analysis PRECEDE coding |
+| Deployment is the end goal | Deployment feeds back into Research |
+
+**C(RAID) + SPARC**: C(RAID) defines the continuous operational paradigm (outer loop), while SPARC provides the systematic execution methodology (inner loop). Together they enable truly autonomous development at scale.
+
+> **[Read the full C(RAID) Paradigm documentation](docs/paradigm/index.rst)**
+
 ## Why This Matters
 
 **Traditional AI development**: Ad-hoc prompts, lost context, inconsistent quality

claudedocs/01-architecture/CORE_ARCHITECTURE.md

@@ -101,23 +101,65 @@ Main configuration file loaded by Claude Code CLI:
 
 ```
 .claude/
-├── commands/              # Custom slash commands
-│   └── sc/                # SuperClaude command namespace
-│       ├── research.md
-│       ├── implement.md
-│       └── test.md
+├── agents/                # Specialized agent definitions (54+)
+│   ├── analysis/          # Code analysis agents
+│   ├── architecture/      # System design agents
+│   ├── consensus/         # Distributed consensus agents
+│   ├── core/              # Core agents (coder, reviewer, tester, etc.)
+│   ├── development/       # Development specialists
+│   ├── devops/            # CI/CD and infrastructure agents
+│   ├── flow-nexus/        # Cloud platform agents
+│   ├── github/            # GitHub integration agents
+│   ├── goal/              # Goal-oriented planning agents
+│   ├── hive-mind/         # Collective intelligence agents
+│   ├── optimization/      # Performance optimization agents
+│   ├── sparc/             # SPARC methodology agents
+│   ├── swarm/             # Swarm coordination agents
+│   └── testing/           # Testing specialists
+├── commands/              # Slash commands (214+ across 25 categories)
+│   ├── agents/            # Agent management commands
+│   ├── analysis/          # Analysis commands
+│   ├── automation/        # Workflow automation
+│   ├── consider/          # Decision framework commands
+│   ├── flow-nexus/        # Cloud platform commands
+│   ├── github/            # GitHub operations
+│   ├── hive-mind/         # Collective intelligence commands
+│   ├── hooks/             # Hook configuration commands
+│   ├── monitoring/        # System monitoring
+│   ├── optimization/      # Performance optimization
+│   ├── pair/              # Pair programming commands
+│   ├── pm/                # Project management (CCPM)
+│   ├── sc/                # SuperClaude meta commands
+│   ├── sparc/             # SPARC methodology commands
+│   ├── swarm/             # Swarm coordination commands
+│   ├── ui/                # UI/frontend commands
+│   └── workflows/         # Workflow templates
+├── context/               # Project context files
+├── helpers/               # Shell utilities
+├── prds/                  # Product requirements (CCPM)
+├── router/                # Command routing configuration
 ├── rules/                 # Operational rules
 │   ├── agent-coordination.md
-│   ├── path-standards.md
-│   └── github-operations.md
-├── helpers/               # Shell utilities
-│   ├── setup-mcp.sh
-│   ├── github-setup.sh
-│   └── checkpoint-manager.sh
-├── prds/                  # Product requirements
-├── epics/                 # Epic management (gitignored)
-├── context/               # Project context
-└── statusline/            # Status line config
+│   ├── command-routing.md
+│   ├── github-operations.md
+│   └── path-standards.md
+├── sessions/              # Session persistence
+├── skills/                # Reusable skill definitions
+│   ├── agent-sandboxes/   # E2B sandbox operations
+│   ├── create-agent-skills/
+│   ├── create-hooks/
+│   ├── create-meta-prompts/
+│   ├── create-plans/
+│   ├── create-slash-commands/
+│   ├── create-subagents/
+│   ├── debug-like-expert/
+│   └── expertise/         # Domain expertise (iOS, macOS)
+├── statusline/            # Status line config
+├── superclaude/           # SuperClaude framework files
+├── tools/                 # Custom tool definitions
+├── ccpm.config            # CCPM configuration
+├── settings.json          # Claude Code settings
+└── statusline-command.sh  # Status line shell script
 ```
 
 ### 2. SPARC Methodology Engine