chore: Clean up session documents and old artifacts

Removed session working documents that shouldn't be in user-facing repo:

Root directory cleanup:
- GIT_COMMIT_GUIDE_v4.8.0.md
- HYBRID_CLI_GUIDE.md
- HYBRID_SYSTEM_COMPLETE.md
- HYBRID_SYSTEM_SIMPLIFIED.md (untracked)
- OPTION_A_COMPLETE_SUMMARY.md (untracked)
- OPTION_A_IMPLEMENTATION_COMPLETE.md (untracked)
- RELEASE_NOTES_v4.8.0.md
- SESSION_COMPLETE.txt (untracked)
- SLASH_COMMAND_CLEANUP_PROPOSAL.md (untracked)
- WORKFLOW_CHAINING_ENABLED.md
- test_wizard_risk_analysis.json (untracked)
- v4.8.0_COMPLETE_SUMMARY.md

Docs directory cleanup:
- docs/PHASE2_IMPLEMENTATION_SUMMARY.md
- docs/PHASE2_PERFORMANCE_RESULTS.md
- docs/TEST_IMPROVEMENTS_PHASE1_AND_2_COMPLETE.md
- docs/TEST_IMPROVEMENT_PHASE1_SUMMARY.md
- docs/CI_SECURITY_SCANNING.md (untracked)
- docs/DEVELOPER_ONBOARDING_CHECKLIST.md (untracked)
- docs/DEVELOPER_SECURITY_WORKFLOW.md (untracked)
- docs/SECURITY_COMPLETE_SUMMARY.md (untracked)
- docs/SECURITY_DETAILED_ANALYSIS.md (untracked)
- docs/SECURITY_PHASE2_COMPLETE.md (untracked)
- docs/SECURITY_PHASE3_COMPLETE.md (untracked)
- docs/SECURITY_REMEDIATION_*.md (untracked)
- docs/SECURITY_SCANNER_ARCHITECTURE.md (untracked)

Benchmarks:
- benchmarks/optimization_results.json (untracked)

Old artifacts:
- empathy_framework-4.7.1/ directory (old extraction)

Kept legitimate documentation:
- docs/DEVELOPER_GUIDE.md
- docs/SECURITY_REVIEW.md
- All optimization documentation (REDIS_OPTIMIZATION_SUMMARY.md, etc.)
- .claude/ configuration files

This cleanup prepares the repo for v4.9.1 release with only
user-facing documentation remaining.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: silversurfer562

.claude/commands/agent.md

@@ -183,13 +183,14 @@ Run a specific agent for a task.
 
 Agents can also be invoked from relevant hubs:
 
-| Hub         | Related Agents                                  |
-| ----------- | ----------------------------------------------- |
-| `/dev`      | debugger, code-reviewer, refactorer             |
-| `/testing`  | test-writer, quality-validator                  |
-| `/workflow` | planner, architect                              |
-| `/docs`     | code-reviewer (documentation review)            |
-| `/release`  | security-reviewer, quality-validator            |
+| Hub          | Related Agents                                  |
+| ------------ | ----------------------------------------------- |
+| `/dev`       | debugger, code-reviewer, refactorer             |
+| `/testing`   | test-writer, quality-validator                  |
+| `/workflows` | (runs automated multi-stage workflows)          |
+| `/plan`      | planner, architect                              |
+| `/docs`      | code-reviewer (documentation review)            |
+| `/release`   | security-reviewer, quality-validator            |
 
 ## When to Use This Hub Directly
 
@@ -202,7 +203,8 @@ Use `/agent` when you want to:
 
 ## Related Hubs
 
-- `/workflow` - Development workflows (uses planner, architect)
+- `/workflows` - Run automated AI workflows (security-audit, bug-predict, etc.)
+- `/plan` - Development planning (uses planner, architect)
 - `/dev` - Development tools (uses debugger, code-reviewer)
 - `/testing` - Testing workflows (uses test-writer)
 - `/context` - Context and memory management

.claude/commands/context.md

@@ -5,6 +5,19 @@ category: hub
 aliases: [ctx]
 tags: [context, memory, state, profile, hub]
 version: "2.0"
+question:
+  header: "Context"
+  question: "What context operation do you need?"
+  multiSelect: false
+  options:
+    - label: "📊 Show status"
+      description: "Display current session state, tasks, and context"
+    - label: "💭 View memory"
+      description: "Browse and search learned patterns and preferences"
+    - label: "💾 Save state"
+      description: "Preserve current state for later resumption"
+    - label: "📝 Edit CLAUDE.md"
+      description: "Update project memory and instructions"
 ---
 
 # Context Management
@@ -139,7 +152,8 @@ View session status or update your preferences.
 | ------------------ | ------------ |
 | Create commits     | `/dev`       |
 | Run tests          | `/testing`   |
-| Plan features      | `/workflow`  |
+| Plan features      | `/plan`      |
+| Run workflows      | `/workflows` |
 | Learn patterns     | `/learning`  |
 
 ## Related Hubs

.claude/commands/dev.md

@@ -5,6 +5,19 @@ category: hub
 aliases: [developer]
 tags: [development, git, debugging, quality, hub]
 version: "3.0"
+question:
+  header: "Task"
+  question: "What development task do you need?"
+  multiSelect: false
+  options:
+    - label: "🐛 Debug & analyze"
+      description: "Investigate bugs, review code, refactor with guidance"
+    - label: "📝 Git operations"
+      description: "Create commits, pull requests, manage branches"
+    - label: "✅ Quality check"
+      description: "Run linting, type checking, security scans"
+    - label: "⚡ Performance"
+      description: "Profile code, identify bottlenecks, optimize"
 ---
 
 # Developer Tools
@@ -13,32 +26,30 @@ version: "3.0"
 
 Development operations powered by Socratic agents that guide you through discovery.
 
-## Quick Examples
+---
 
-```bash
-/dev                      # Interactive menu
-/dev debug                # Start debugging with debugger agent
-/dev review               # Code review with code-reviewer agent
-/dev refactor             # Refactoring with refactorer agent
-/dev commit               # Create a git commit
-/dev pr                   # Create a pull request
-```
+**Based on your selection, I will:**
 
-## Discovery
+- **🐛 Debug issue** → Use the debugger agent with Socratic questioning to help you discover root causes
+- **👀 Review code** → Use the code-reviewer agent to provide teaching-focused quality review
+- **🔧 Refactor code** → Use the refactorer agent to guide structural improvements
+- **📝 Git commit** → Stage files and create a well-formatted commit
+- **🚀 Create PR** → Push changes and create a pull request with summary
+- **✅ Quality check** → Run linters, type checking, and security scans
 
-```yaml
-Question:
-  header: "Task"
-  question: "What development task do you need?"
-  options:
-    - label: "Debug issue"
-      description: "Investigate bugs with guided root cause analysis"
-    - label: "Review code"
-      description: "Quality review with teaching explanations"
-    - label: "Refactor code"
-      description: "Improve structure with pattern guidance"
-    - label: "Git operations"
-      description: "Commits, PRs, and version control"
+---
+
+## Quick Direct Access
+
+You can also invoke sub-commands directly:
+
+```bash
+/dev debug                # Start debugging
+/dev review               # Code review
+/dev refactor             # Refactoring
+/dev commit               # Git commit
+/dev pr                   # Create PR
+/dev quality              # Quality check
 ```
 
 ---
@@ -216,17 +227,19 @@ Ready to open PR                 → /dev pr
 
 ## When NOT to Use This Hub
 
-| If you need...         | Use instead |
-|------------------------|-------------|
-| Run tests              | `/testing`  |
-| Write documentation    | `/docs`     |
-| Release/deploy         | `/release`  |
-| Plan a feature         | `/workflow` |
-| Manage context/memory  | `/context`  |
+| If you need...         | Use instead  |
+|------------------------|--------------|
+| Run tests              | `/testing`   |
+| Write documentation    | `/docs`      |
+| Release/deploy         | `/release`   |
+| Plan a feature         | `/plan`      |
+| Run automated analysis | `/workflows` |
+| Manage context/memory  | `/context`   |
 
 ## Related Hubs
 
 - `/testing` - Run tests, coverage, TDD
-- `/workflow` - Plan features, architecture
+- `/workflows` - Run automated workflows (security-audit, bug-predict, etc.)
+- `/plan` - Plan features, architecture
 - `/release` - Prepare and publish releases
 - `/agent` - Direct agent invocation

.claude/commands/docs.md

@@ -5,6 +5,19 @@ category: hub
 aliases: [documentation]
 tags: [documentation, explanation, hub]
 version: "3.0"
+question:
+  header: "Documentation"
+  question: "What documentation task do you need?"
+  multiSelect: false
+  options:
+    - label: "💡 Explain code"
+      description: "Understand how code works with teaching-focused explanations"
+    - label: "📝 Generate docs"
+      description: "Create documentation from code with examples"
+    - label: "📋 Feature overview"
+      description: "Get high-level overview of a feature or module"
+    - label: "🔍 API reference"
+      description: "Generate API documentation with usage examples"
 ---
 
 # Documentation
@@ -176,6 +189,7 @@ Need summary for stakeholders       → /docs overview
 ## Related Hubs
 
 - `/dev` - Code changes, commits, PRs
-- `/workflow` - Feature planning
+- `/workflows` - Run automated workflows (doc-gen, doc-orchestrator)
+- `/plan` - Feature planning
 - `/learning` - Pattern documentation
 - `/agent` - Direct agent invocation

.claude/commands/help.md

@@ -19,7 +19,7 @@ When you type `/` in Claude Code, you'll see two types of commands:
 
 | Type             | Source                             | Examples                                                                          |
 | ---------------- | ---------------------------------- | --------------------------------------------------------------------------------- |
-| **Project Hubs** | This project (`.claude/commands/`) | `/dev`, `/testing`, `/workflow`, `/docs`, etc.                                    |
+| **Project Hubs** | This project (`.claude/commands/`) | `/dev`, `/testing`, `/workflows`, `/plan`, `/docs`, etc.                          |
 | **Built-in**     | Claude Code itself                 | `/clear`, `/compact`, `/config`, `/cost`, `/doctor`, `/init`, `/model`, `/status` |
 
 **This help covers the 9 Project Hubs below.** For built-in commands, see [Claude Code documentation](https://docs.anthropic.com/claude-code).
@@ -32,7 +32,8 @@ When you type `/` in Claude Code, you'll see two types of commands:
 | ------------ | -------------------- | ------------------------------------------ |
 | `/dev`       | `/developer`         | Debugging, commits, PRs, code quality      |
 | `/testing`   | `/tests`, `/test-hub`| Run tests, coverage, benchmarks            |
-| `/workflow`  | `/wf`                | Planning, TDD, code review, refactoring    |
+| `/workflows` | `/wf`, `/workflow`   | Run automated AI workflows (security, perf)|
+| `/plan`      | `/approach`          | Planning, TDD, code review, refactoring    |
 | `/docs`      | `/documentation`     | Explain code, manage docs, feature overview|
 | `/agent`     | `/agents`            | Create and manage specialized agents       |
 | `/context`   | `/ctx`               | Save/restore state, memory, status         |
@@ -46,12 +47,14 @@ When you type `/` in Claude Code, you'll see two types of commands:
 # Run any hub for an interactive menu
 /dev
 /testing
-/workflow
+/workflows
+/plan
 
 # Or provide context directly
 /dev "debug login error"
 /testing "run unit tests"
-/workflow "plan new feature"
+/workflows run security-audit
+/plan "new feature"
 ```
 
 ## Finding the Right Hub
@@ -65,8 +68,11 @@ Code & Git:
 Testing:
   └─ Run tests, coverage, benchmarks → /testing
 
+Automated Analysis:
+  └─ Security audit, bug predict, perf audit → /workflows
+
 Development Process:
-  └─ Plan, TDD, review, refactor → /workflow
+  └─ Plan, TDD, review, refactor → /plan
 
 Documentation:
   └─ Explain code, write docs → /docs
@@ -89,18 +95,20 @@ Setup:
 
 ## Common Tasks Quick Reference
 
-| Task                     | Command                    |
-| ------------------------ | -------------------------- |
-| Debug an error           | `/dev "debug <error>"`     |
-| Create a commit          | `/dev "commit"`            |
-| Create a PR              | `/dev "create PR"`         |
-| Run tests                | `/testing "run tests"`     |
-| Check coverage           | `/testing "coverage"`      |
-| Plan a feature           | `/workflow "plan <feat>"`  |
-| Review code              | `/workflow "review"`       |
-| Explain code             | `/docs "explain <file>"`   |
-| Save session state       | `/context "save state"`    |
-| Prepare release          | `/release "prep 1.0.0"`    |
+| Task                     | Command                         |
+| ------------------------ | ------------------------------- |
+| Debug an error           | `/dev "debug <error>"`          |
+| Create a commit          | `/dev "commit"`                 |
+| Create a PR              | `/dev "create PR"`              |
+| Run tests                | `/testing "run tests"`          |
+| Check coverage           | `/testing "coverage"`           |
+| Security audit           | `/workflows run security-audit` |
+| Bug prediction           | `/workflows run bug-predict`    |
+| Plan a feature           | `/plan "new feature"`           |
+| Review code              | `/plan "review"`                |
+| Explain code             | `/docs "explain <file>"`        |
+| Save session state       | `/context "save state"`         |
+| Prepare release          | `/release "prep 1.0.0"`         |
 
 ## Hub Features
 

.claude/commands/learning.md

@@ -6,6 +6,19 @@ aliases: [learn-hub]
 tags: [learning, patterns, memory, hub]
 version: "2.1"
 inline: true
+question:
+  header: "Learning"
+  question: "What would you like to do?"
+  multiSelect: false
+  options:
+    - label: "📊 Evaluate session"
+      description: "Analyze current session and extract learnings"
+    - label: "🔍 View patterns"
+      description: "Browse learned debugging and refactoring patterns"
+    - label: "📚 Teach preferences"
+      description: "Add new preferences or update existing ones"
+    - label: "💡 Suggest improvements"
+      description: "Get recommendations based on session analysis"
 ---
 
 # Learning Management
@@ -138,4 +151,5 @@ Manually teach a preference or pattern.
 
 - `/context` - State and memory management
 - `/agent` - Agent pattern learning
-- `/workflow` - Development workflows
+- `/workflows` - Run automated workflows
+- `/plan` - Development approaches (TDD, planning, review)

.claude/commands/workflow.md .claude/commands/plan.md.claude/commands/workflow.md renamed to .claude/commands/plan.md

@@ -1,32 +1,45 @@
 ---
-name: workflow
-description: Development workflow hub - planning, TDD, review, refactoring
+name: plan
+description: Development planning hub - structured approaches for planning, TDD, review, refactoring
 category: hub
-aliases: [wf]
-tags: [workflow, development, planning, hub]
-version: "2.0"
+aliases: [approach]
+tags: [planning, development, tdd, review, refactor, hub]
+version: "3.0"
+question:
+  header: "Planning"
+  question: "What do you need to plan?"
+  multiSelect: false
+  options:
+    - label: "🎯 New feature"
+      description: "Plan implementation approach for a new feature"
+    - label: "🧪 TDD approach"
+      description: "Design tests before implementation"
+    - label: "🔧 Refactoring plan"
+      description: "Plan safe refactoring with verification steps"
+    - label: "🏗️ Architecture review"
+      description: "Review and plan architectural changes"
 ---
 
-# Development Workflows
+# Development Planning
 
-**Aliases:** `/wf`
+**Aliases:** `/approach`
 
-Structured approaches for common development tasks.
+Structured approaches for common development tasks with Socratic guidance.
 
 ## Quick Examples
 
 ```bash
-/workflow                      # Interactive menu
-/workflow "plan auth feature"  # Start planning
-/workflow "refactor utils"     # Start refactoring
+/plan                      # Interactive menu
+/plan "auth feature"       # Start planning a feature
+/plan "refactor utils"     # Plan a refactoring
 ```
 
 ## Discovery
 
 ```yaml
 Question:
-  header: "Workflow"
-  question: "What development workflow do you need?"
+  header: "Approach"
+  question: "What development approach do you need?"
   options:
     - label: "Plan implementation"
       description: "Create a plan with Socratic discovery before coding"
@@ -221,7 +234,7 @@ Restructure code without changing behavior.
 
 ---
 
-## Workflow Selection Guide
+## Selection Guide
 
 ```text
 Need to build something new?
@@ -254,15 +267,17 @@ For deeper analysis, invoke specialized agents via `/agent`:
 
 ## When NOT to Use This Hub
 
-| If you need...       | Use instead |
-| -------------------- | ----------- |
-| Run existing tests   | `/testing`  |
-| Create commit/PR     | `/dev`      |
-| Write documentation  | `/docs`     |
-| Deploy changes       | `/release`  |
+| If you need...              | Use instead  |
+| --------------------------- | ------------ |
+| Run automated workflows     | `/workflows` |
+| Run existing tests          | `/testing`   |
+| Create commit/PR            | `/dev`       |
+| Write documentation         | `/docs`      |
+| Deploy changes              | `/release`   |
 
 ## Related Hubs
 
+- `/workflows` - Run automated analysis workflows (security-audit, bug-predict, etc.)
 - `/dev` - Debugging, commits, PRs
 - `/testing` - Run tests, coverage
 - `/docs` - Documentation