empathy-framework 5.1.1__tar.gz → 5.2.1__tar.gz

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/CHANGELOG.md

@@ -7,6 +7,133 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [5.2.1] - 2026-01-30
+
+### Fixed
+
+- **100% Unit Test Pass Rate**: Resolved 108 failing unit tests (93.9% → 100% pass rate)
+  - Fixed security audit Phase 3 missing `import re` statement
+  - Fixed code review workflow undefined `security_score` variable
+  - Fixed verification script dataclass field checking (use `__dataclass_fields__`)
+  - Removed deprecated `TTLStrategy.COORDINATION` enum (removed in v5.0) from 8 files
+  - Updated `ModelProvider.to_unified()` for v5.0 Claude-native architecture
+  - Fixed telemetry Redis mocking in 65+ tests (agent coordination, tracking, approval gates, events, feedback)
+  - Updated test generator API (`wizard_id` → `workflow_id`) in 10 tests
+  - Fixed memory search API (`_get_all_patterns` → `_iter_all_patterns`)
+  - Fixed token estimator test to match actual tiktoken behavior
+  - Added missing `heapq` import to tier1 analytics
+  - Improved security scanner documentation detection (added markdown lists)
+  - Fixed AST scanner to only check docstring-capable nodes
+  - Fixed memory atomic operations cache invalidation
+  - Fixed SQL parameterization test for safe placeholder patterns
+
+### Changed
+
+- **Code Cleanup**: Removed 6 duplicate files improving codebase maintainability
+  - Removed 5 duplicate telemetry test files (`test_agent_coordination 2.py`, etc.)
+  - Removed 1 duplicate source file (`types 2.py`)
+
+### Testing
+
+- **Test Suite Health**: Now at 5,814 passing tests with 0 failures
+  - 100% pass rate on active unit tests
+  - 90 tests appropriately skipped (integration tests requiring API/Redis)
+  - 3 tests marked as expected failures (xfailed)
+  - Comprehensive test coverage across all framework modules
+
+## [5.2.0] - 2026-01-30
+
+### Added
+
+- **3-Phase Autonomous Test Generation**: Major enhancement to test generation workflow
+  - **Phase 1**: Extended thinking mode with 20K token budget for thorough test planning
+  - **Phase 2**: Multi-turn refinement with pytest validation loop (generate → validate → fix → repeat)
+  - **Phase 3**: Coverage-guided generation iteratively targeting 80% coverage
+  - Prompt caching reduces test generation costs by 90%
+  - Workflow detection with specialized test patterns for LLM mocking
+  - Few-shot learning examples for consistent test quality
+  - Configuration options: `--no-refinement`, `--coverage-guided`
+
+### Fixed
+
+- Test import errors after refactoring (dashboard commands moved to separate module)
+- API configuration for extended thinking (max_tokens 40K, budget_tokens 20K)
+- Missing pytest-mock dependency for comprehensive test mocking
+
+### Changed
+
+- **Code Refactoring**: Modularized large files for better maintainability
+  - Reduced telemetry/cli.py complexity (36% reduction)
+  - Extracted dashboard commands to separate module
+  - Improved file organization for automated test generation
+
+### Dependencies
+
+- Added pytest-mock>=3.14.0 for enhanced test mocking capabilities
+
+## [5.1.4] - 2026-01-29
+
+### Added
+
+- **Model Context Protocol (MCP) Integration**: Complete MCP server implementation for Claude Code
+  - Created `src/empathy_os/mcp/server.py` (502 lines) - Production MCP server exposing all workflows
+  - Exposes 10 tools: security_audit, bug_predict, code_review, test_generation, performance_audit, release_prep, auth_status, auth_recommend, telemetry_stats, dashboard_status
+  - Exposes 3 resources: empathy://workflows, empathy://auth/config, empathy://telemetry
+  - JSON-RPC stdio transport for seamless Claude Code integration
+  - Automatic server discovery via `.claude/mcp.json` configuration
+  - Comprehensive testing documented in `.claude/MCP_TEST_RESULTS.md` (all tests passing)
+
+- **Claude Code Best Practices**: Enhanced project configuration for optimal Claude Code experience
+  - Updated `.claude/CLAUDE.md` to v5.1.1 with comprehensive structure
+  - Added quick start examples, natural language commands, key capabilities
+  - Documented all 10 command hubs with usage examples
+  - Added verification hooks for automatic validation:
+    - Python syntax validation on file writes
+    - JSON format validation on file writes
+    - Workflow output verification
+    - Session end reminders
+
+- **Documentation Quality**: Process improvements for better documentation
+  - Added `.claude/rules/empathy/markdown-formatting.md` - Comprehensive formatting guide
+  - 5 critical rules to prevent recurring linting warnings (MD031, MD040, MD032, MD029, MD060)
+  - Saves tokens and time by getting formatting right first time
+
+### Documentation
+
+- **MCP Integration Guide**: Complete rewrite of `docs/getting-started/mcp-integration.md` (295 lines)
+  - Two setup options: Claude Code (automatic) and Claude Desktop (manual)
+  - Comprehensive tool documentation with examples
+  - Troubleshooting guide for common issues
+  - Testing instructions and verification steps
+
+## [5.1.3] - 2026-01-29
+
+### Changed
+
+- **Project Status**: Updated from Beta to Production/Stable
+  - Framework has proven stability and reliability in production environments
+  - Comprehensive test coverage (80%+) and extensive real-world usage
+  - Mature API with semantic versioning commitment
+  - PyPI classifier updated to "Development Status :: 5 - Production/Stable"
+
+## [5.1.2] - 2026-01-29
+
+### Added
+
+- **Community Attribution**: Comprehensive acknowledgements for open source software dependencies
+  - Added `ACKNOWLEDGEMENTS.md` with attribution for 50+ open source projects organized by category
+  - Added `CONTRIBUTORS.md` with contributor recognition system using all-contributors specification
+  - Each dependency includes project link, description, and how it's used in Empathy Framework
+  - Categories include: Core Framework, AI/LLM Integration, Memory & Storage, Web Framework & API, Security & Authentication, Observability & Telemetry, Developer Tools, Documentation, Editor Integration, Platform Compatibility, and Document Processing
+  - Updated `README.md` with links to acknowledgements and contributors documentation
+  - Demonstrates respect for open source community and proper attribution practices
+
+### Documentation
+
+- Proper recognition of all open source contributors whose work makes Empathy Framework possible
+- Clear attribution following best practices for open source software
+- Guidelines for contributors to add new dependencies with proper acknowledgements
+
 ## [5.1.1] - 2026-01-29
 
 ### Added

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: empathy-framework
-Version: 5.1.1
-Summary: AI collaboration framework with real LLM agent execution, AskUserQuestion tool integration, Socratic agent generation, progressive tier escalation (70-85% cost savings), meta-orchestration, dynamic agent composition (6 patterns), intelligent caching (85% hit rate), semantic workflow discovery, visual workflow editor, MCP integration for Claude Code, and multi-agent orchestration.
+Version: 5.2.1
+Summary: AI collaboration framework with real LLM agent execution, AskUserQuestion tool integration, Socratic agent generation, progressive tier escalation (70-85% cost savings), meta-orchestration, dynamic agent composition (10 patterns including Anthropic-inspired), intelligent caching (85% hit rate), semantic workflow discovery, visual workflow editor, MCP integration for Claude Code, and multi-agent orchestration.
 Author-email: Patrick Roebuck <admin@smartaimemory.com>
 Maintainer-email: Smart-AI-Memory <admin@smartaimemory.com>
 License:                                  Apache License
@@ -216,7 +216,7 @@ Project-URL: Issues, https://github.com/Smart-AI-Memory/empathy-framework/issues
 Project-URL: Discussions, https://github.com/Smart-AI-Memory/empathy-framework/discussions
 Project-URL: Changelog, https://github.com/Smart-AI-Memory/empathy-framework/blob/main/CHANGELOG.md
 Keywords: ai,collaboration,empathy,anticipatory-ai,systems-thinking,llm,claude,memdocs,level-5-ai,code-inspection,static-analysis,code-quality,sarif,github-actions,developer-tools
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
@@ -317,6 +317,7 @@ Provides-Extra: dev
 Requires-Dist: pytest<10.0,>=7.0; extra == "dev"
 Requires-Dist: pytest-asyncio<2.0,>=0.21; extra == "dev"
 Requires-Dist: pytest-cov<8.0,>=4.0; extra == "dev"
+Requires-Dist: pytest-mock<4.0,>=3.14.0; extra == "dev"
 Requires-Dist: pytest-xdist<4.0,>=3.5.0; extra == "dev"
 Requires-Dist: pytest-testmon<3.0,>=2.1.0; extra == "dev"
 Requires-Dist: pytest-picked<1.0,>=0.5.0; extra == "dev"
@@ -632,8 +633,37 @@ python -m empathy_os.models.cli provider --set anthropic
 # Natural language support:
 /workflows "find security issues"
 /plan "review my code"
+
+# Direct tool access via MCP (v5.1.1+):
+# Claude Code automatically discovers Empathy tools through the MCP server
+# Just describe what you need in natural language:
+"Run a security audit on src/"          → Invokes security_audit tool
+"Generate tests for config.py"          → Invokes test_generation tool
+"Check my auth configuration"           → Invokes auth_status tool
+"Analyze performance bottlenecks"       → Invokes performance_audit tool
+```
+
+**MCP Server Integration (v5.1.1+):**
+
+Empathy Framework now includes a Model Context Protocol (MCP) server that exposes all workflows as native Claude Code tools:
+
+- **10 Tools Available:** security_audit, bug_predict, code_review, test_generation, performance_audit, release_prep, auth_status, auth_recommend, telemetry_stats, dashboard_status
+- **Automatic Discovery:** No manual configuration needed - Claude Code finds tools via `.claude/mcp.json`
+- **Natural Language Access:** Describe your need and Claude invokes the appropriate tool
+- **Verification Hooks:** Automatic validation of Python/JSON files and workflow outputs
+
+To verify MCP integration:
+
+```bash
+# Check server is running
+echo '{"method":"tools/list","params":{}}' | PYTHONPATH=./src python -m empathy_os.mcp.server
+
+# Restart Claude Code to load the MCP server
+# Tools will appear in Claude's tool list automatically
 ```
 
+See [.claude/MCP_TEST_RESULTS.md](.claude/MCP_TEST_RESULTS.md) for full integration details.
+
 **CLI:**
 
 ```bash
@@ -950,4 +980,23 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
 ---
 
+## Acknowledgements
+
+This project stands on the shoulders of giants. We are deeply grateful to the open source community and all the amazing projects that make this framework possible.
+
+**[View Full Acknowledgements →](ACKNOWLEDGEMENTS.md)**
+
+Special thanks to:
+
+- **[Anthropic](https://www.anthropic.com/)** - For Claude AI and the Model Context Protocol
+- **[LangChain](https://github.com/langchain-ai/langchain)** - Agent framework powering our meta-orchestration
+- **[FastAPI](https://github.com/tiangolo/fastapi)** - Modern Python web framework
+- **[pytest](https://github.com/pytest-dev/pytest)** - Testing framework making quality assurance effortless
+
+And to all 50+ open source projects we depend on. [See the complete list →](ACKNOWLEDGEMENTS.md)
+
+Want to contribute? See [CONTRIBUTORS.md](CONTRIBUTORS.md)
+
+---
+
 **Built by [Smart AI Memory](https://smartaimemory.com)** · [Docs](https://smartaimemory.com/framework-docs/) · [Examples](examples/) · [Issues](https://github.com/Smart-AI-Memory/empathy-framework/issues)

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/README.md

@@ -210,8 +210,37 @@ python -m empathy_os.models.cli provider --set anthropic
 # Natural language support:
 /workflows "find security issues"
 /plan "review my code"
+
+# Direct tool access via MCP (v5.1.1+):
+# Claude Code automatically discovers Empathy tools through the MCP server
+# Just describe what you need in natural language:
+"Run a security audit on src/"          → Invokes security_audit tool
+"Generate tests for config.py"          → Invokes test_generation tool
+"Check my auth configuration"           → Invokes auth_status tool
+"Analyze performance bottlenecks"       → Invokes performance_audit tool
+```
+
+**MCP Server Integration (v5.1.1+):**
+
+Empathy Framework now includes a Model Context Protocol (MCP) server that exposes all workflows as native Claude Code tools:
+
+- **10 Tools Available:** security_audit, bug_predict, code_review, test_generation, performance_audit, release_prep, auth_status, auth_recommend, telemetry_stats, dashboard_status
+- **Automatic Discovery:** No manual configuration needed - Claude Code finds tools via `.claude/mcp.json`
+- **Natural Language Access:** Describe your need and Claude invokes the appropriate tool
+- **Verification Hooks:** Automatic validation of Python/JSON files and workflow outputs
+
+To verify MCP integration:
+
+```bash
+# Check server is running
+echo '{"method":"tools/list","params":{}}' | PYTHONPATH=./src python -m empathy_os.mcp.server
+
+# Restart Claude Code to load the MCP server
+# Tools will appear in Claude's tool list automatically
 ```
 
+See [.claude/MCP_TEST_RESULTS.md](.claude/MCP_TEST_RESULTS.md) for full integration details.
+
 **CLI:**
 
 ```bash
@@ -528,4 +557,23 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
 ---
 
+## Acknowledgements
+
+This project stands on the shoulders of giants. We are deeply grateful to the open source community and all the amazing projects that make this framework possible.
+
+**[View Full Acknowledgements →](ACKNOWLEDGEMENTS.md)**
+
+Special thanks to:
+
+- **[Anthropic](https://www.anthropic.com/)** - For Claude AI and the Model Context Protocol
+- **[LangChain](https://github.com/langchain-ai/langchain)** - Agent framework powering our meta-orchestration
+- **[FastAPI](https://github.com/tiangolo/fastapi)** - Modern Python web framework
+- **[pytest](https://github.com/pytest-dev/pytest)** - Testing framework making quality assurance effortless
+
+And to all 50+ open source projects we depend on. [See the complete list →](ACKNOWLEDGEMENTS.md)
+
+Want to contribute? See [CONTRIBUTORS.md](CONTRIBUTORS.md)
+
+---
+
 **Built by [Smart AI Memory](https://smartaimemory.com)** · [Docs](https://smartaimemory.com/framework-docs/) · [Examples](examples/) · [Issues](https://github.com/Smart-AI-Memory/empathy-framework/issues)

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/docs/api-reference/README.md

@@ -1,3 +1,7 @@
+---
+description: Empathy Framework - API Reference API reference: **Version:** 4.0.0 **Last Updated:** January 16, 2026 **Status:** Living Documentation --- ## Overvi
+---
+
 # Empathy Framework - API Reference
 
 **Version:** 4.0.0

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/docs/api-reference/config.md

@@ -1,3 +1,7 @@
+---
+description: Configure Empathy Framework with Python, YAML, JSON, or environment variables. Flexible configuration with validation and defaults.
+---
+
 # Configuration
 
 Configuration management for the Empathy Framework. Configure via direct instantiation, YAML/JSON files, or environment variables.

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/docs/api-reference/core.md

@@ -1,3 +1,7 @@
+---
+description: Core API reference: Core data structures and state management for the Empathy Framework. ## Overview The core module pro
+---
+
 # Core
 
 Core data structures and state management for the Empathy Framework.

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/docs/api-reference/empathy-os.md

@@ -1,3 +1,7 @@
+---
+description: EmpathyOS API reference: The main entry point for the Empathy Framework. `EmpathyOS` orchestrates empathy level progression, 
+---
+
 # EmpathyOS
 
 The main entry point for the Empathy Framework. `EmpathyOS` orchestrates empathy level progression, trust management, and interaction handling.

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/docs/api-reference/index.md

@@ -1,3 +1,7 @@
+---
+description: API Reference API reference: Complete API documentation for the Empathy Framework. ## Overview The Empathy Framework provides a c
+---
+
 # API Reference
 
 Complete API documentation for the Empathy Framework.

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/docs/api-reference/llm-toolkit.md

@@ -1,3 +1,7 @@
+---
+description: LLM Toolkit API reference: Enterprise-grade LLM integration with security controls and compliance features. ## Overview The LLM
+---
+
 # LLM Toolkit
 
 Enterprise-grade LLM integration with security controls and compliance features.

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/docs/api-reference/memory 2.md

@@ -1,3 +1,7 @@
+---
+description: Memory API API reference: Unified two-tier memory system for AI agent collaboration. --- ## Overview The memory system provide
+---
+
 # Memory API
 
 Unified two-tier memory system for AI agent collaboration.

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/docs/api-reference/memory.md

@@ -1,3 +1,7 @@
+---
+description: Memory API API reference: Unified two-tier memory system for AI agent collaboration. --- ## Overview The memory system provide
+---
+
 # Memory API
 
 Unified two-tier memory system for AI agent collaboration.

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/docs/api-reference/meta-orchestration.md

@@ -1,3 +1,7 @@
+---
+description: Meta-Orchestration API API reference: **Version:** 4.0.0 (New in v4.0) **Module:** `empathy_os.orchestration` **Stability:** 🟢 Stable (Pub
+---
+
 # Meta-Orchestration API
 
 **Version:** 4.0.0 (New in v4.0)

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/docs/api-reference/multi-agent.md

@@ -1,3 +1,7 @@
+---
+description: Multi-agent coordination API with conflict resolution, team monitoring, and shared memory. Enable distributed AI agents to collaborate.
+---
+
 # Multi-Agent Coordination
 
 Conflict resolution and monitoring for distributed agent teams.

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/docs/api-reference/pattern-library.md

@@ -1,3 +1,7 @@
+---
+description: Pattern Library API for learning and sharing patterns. Pattern matching, confidence scoring, and cross-agent pattern sharing.
+---
+
 # Pattern Library
 
 Pattern discovery, learning, and sharing system for multi-agent coordination.

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/docs/api-reference/persistence.md

@@ -1,3 +1,7 @@
+---
+description: Persistence API for pattern storage. Redis, file-based, or in-memory backends. Enable pattern learning across sessions.
+---
+
 # Persistence
 
 Data persistence for patterns, metrics, and collaboration state.

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/docs/api-reference/security-scanner 2.md

@@ -1,3 +1,7 @@
+---
+description: Security Scanner API Reference API reference: **Version:** 1.0 **Module:** `empathy_os.workflows.security_audit` and `empathy_os.workflows.securit
+---
+
 # Security Scanner API Reference
 
 **Version:** 1.0

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/docs/api-reference/security-scanner.md

@@ -1,3 +1,7 @@
+---
+description: Security Scanner API Reference API reference: **Version:** 1.0 **Module:** `empathy_os.workflows.security_audit` and `empathy_os.workflows.securit
+---
+
 # Security Scanner API Reference
 
 **Version:** 1.0

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/docs/api-reference/software-wizards.md

@@ -1,3 +1,7 @@
+---
+description: Software Development Wizards API reference: **16 specialized wizards** for software engineering tasks with Level 4 Anticipatory Intelligence. ##
+---
+
 # Software Development Wizards
 
 **16 specialized wizards** for software engineering tasks with Level 4 Anticipatory Intelligence.

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/docs/api-reference/wizards.md

@@ -1,3 +1,7 @@
+---
+description: Industry Wizards API reference: Domain-specific AI assistants with built-in security, compliance, and industry best practices. ## Ov
+---
+
 # Industry Wizards
 
 Domain-specific AI assistants with built-in security, compliance, and industry best practices.

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/docs/api-reference/workflows 2.md

@@ -1,3 +1,7 @@
+---
+description: Workflows API API reference. Cost-optimized AI workflows with 3-tier model routing, parameters, examples, and usage patterns.
+---
+
 # Workflows API
 
 Cost-optimized workflow patterns that leverage 3-tier model routing.

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/docs/api-reference/workflows.md

@@ -1,3 +1,7 @@
+---
+description: Workflows API API reference. Cost-optimized AI workflows with 3-tier model routing, parameters, examples, and usage patterns.
+---
+
 # Workflows API
 
 Cost-optimized workflow patterns that leverage 3-tier model routing.

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/docs/examples/adaptive-learning-system.md

@@ -1,3 +1,7 @@
+---
+description: Example: Adaptive Learning System: **Difficulty**: Advanced **Time**: 25 minutes **Empathy Level**: 3-4 (Self-improving) **Features**: Dynamic thresholds, patte
+---
+
 # Example: Adaptive Learning System
 
 **Difficulty**: Advanced

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/docs/examples/generated-plan-release-prep.md

@@ -1,3 +1,7 @@
+---
+description: Execution Plan: Release Preparation: > Generated by Empathy Framework v4.5.1 > Template: release-prep > Generated: 2026-01-20T13:30:00Z ## Configuration Based o
+---
+
 # Execution Plan: Release Preparation
 
 > Generated by Empathy Framework v4.5.1

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/docs/examples/multi-agent-team-coordination.md

@@ -1,3 +1,7 @@
+---
+description: Example: Multi-Agent Team Coordination: **Difficulty**: Advanced **Time**: 30 minutes **Empathy Level**: 4 (Anticipatory) **Domain**: Software Development --- #
+---
+
 # Example: Multi-Agent Team Coordination
 
 **Difficulty**: Advanced

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/docs/examples/sbar-clinical-handoff.md

@@ -1,3 +1,7 @@
+---
+description: Example: SBAR Clinical Handoff Report (Healthcare): **Difficulty**: Intermediate **Time**: 20 minutes **Empathy Level**: 4 (Anticipatory) **Domain**: Healthcare
+---
+
 # Example: SBAR Clinical Handoff Report (Healthcare)
 
 **Difficulty**: Intermediate

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/docs/examples/simple-chatbot.md

@@ -1,3 +1,7 @@
+---
+description: Example: Code Review Assistant with Memory: **Difficulty**: Beginner → Intermediate **Time**: 15 minutes **Core Features**: Short-Term Memory (Redis), Long-Term
+---
+
 # Example: Code Review Assistant with Memory
 
 **Difficulty**: Beginner → Intermediate

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/docs/examples/webhook-event-integration.md

@@ -1,3 +1,7 @@
+---
+description: Example: Webhook & Event Integration integration guide. Connect external tools and services with Empathy Framework for enhanced AI capabilities.
+---
+
 # Example: Webhook & Event Integration
 
 **Difficulty**: Intermediate

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/docs/getting-started/choose-your-path.md

@@ -1,3 +1,7 @@
+---
+description: Choose your learning path for Empathy Framework. Quick Start, Tutorial, or Deep Dive approaches based on your experience level.
+---
+
 # Choose Your Path
 
 You've installed the framework and run your first workflow. Now choose the approach that fits your needs.

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/docs/getting-started/first-steps.md

@@ -1,3 +1,7 @@
+---
+description: Run your first Empathy Framework AI workflow in 5 minutes. Security audit, bug prediction, and code review with CLI or Python. See immediate results.
+---
+
 # First Steps
 
 Run your first AI workflow and see results in under 5 minutes.
@@ -129,6 +133,16 @@ Now that you've run a workflow, it's time to [Choose Your Path](choose-your-path
 
 ---
 
+## See Also
+
+- [Choose Your Path](choose-your-path.md) - Decide between Quick Start, Tutorial, or Deep Dive
+- [Installation Guide](installation.md) - Package options and configuration
+- [MCP Integration](mcp-integration.md) - Connect to Claude Code for IDE integration
+- [Multi-Agent Coordination](../reference/multi-agent.md) - Build agent teams
+- [Configuration Reference](../reference/config.md) - Customize framework behavior
+
+---
+
 ## Quick Reference
 
 ```bash

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/docs/getting-started/index.md

@@ -1,3 +1,7 @@
+---
+description: Choose your learning path for Empathy Framework. Quick Start, Tutorial, or Deep Dive approaches based on your experience level.
+---
+
 # Getting Started
 
 Welcome to Empathy Framework! This guide will take you from zero to running your first AI workflow in about 10 minutes.

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/docs/getting-started/installation 2.md

@@ -1,3 +1,7 @@
+---
+description: Install Empathy Framework with pip in 2 minutes. Choose from developer, minimal, or full packages. CLI tools, VSCode extension included.
+---
+
 # Installation
 
 Get Empathy Framework installed and configured in about 2 minutes.

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/docs/getting-started/installation.md

@@ -1,3 +1,7 @@
+---
+description: Install Empathy Framework with pip in 2 minutes. Choose from developer, minimal, or full packages. Includes CLI tools, VSCode extension, and workflow support.
+---
+
 # Installation
 
 Get Empathy Framework installed and configured in about 2 minutes.
@@ -166,6 +170,15 @@ pyenv local 3.11
 
 ---
 
+## See Also
+
+- [Redis Setup](redis-setup.md) - Configure Redis for production use
+- [MCP Integration](mcp-integration.md) - Connect to Claude Code
+- [Configuration Reference](../reference/config.md) - Customize settings
+- [First Steps](first-steps.md) - Run your first workflow
+
+---
+
 ## Next Step
 
 You're installed! Continue to [First Steps](first-steps.md) to run your first workflow.

{empathy_framework-5.1.1 → empathy_framework-5.2.1}/docs/getting-started/mcp-integration 2.md

@@ -1,3 +1,7 @@
+---
+description: Connect Empathy Framework to Claude Code via MCP. Enable AI workflows, agent coordination, and pattern learning in your IDE.
+---
+
 # MCP Integration
 
 Connect Empathy Framework to Claude Desktop or any MCP-compatible client using the Socratic workflow builder.