Doc Update

Author: Shashikant86

README.md

@@ -4,9 +4,9 @@
 
 # CodeOptiX
 
-**Agentic Code Optimization. Elevated Agent Experience.**
+**Agentic Code Optimization & Deep Evaluation for Superior Coding Agent Experience**
 
-*Code Optimization Engine for every coding agent. Powered by Agent Optimizers like GEPA (Genetic-Pareto) and Bloom-style scenario generation for behavior testing.*
+*CodeOptiX is the universal code optimization engine that improves coding agent experience with deep evaluations and optimization. When AI coding agents dazzle with impressive code but leave you wondering about quality, maintainability, security, and reliability, CodeOptiX ensures proper behavior through evaluations, reflection, and self-improvement. Powered by GEPA optimization and Bloom scenario generation.*
 
 [![PyPI version](https://badge.fury.io/py/codeoptix.svg)](https://pypi.org/project/codeoptix/)
 [![CI](https://github.com/SuperagenticAI/codeoptix/actions/workflows/ci.yml/badge.svg)](https://github.com/SuperagenticAI/codeoptix/actions/workflows/ci.yml)
@@ -15,6 +15,11 @@
 [![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 [![Code style: ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
 
+<p align="center">
+  <em>Built with ❤️ by <a href="https://super-agentic.ai" target="_blank"><strong>Superagentic AI</strong></a></em><br>
+  <em>Advancing AI agent optimization and autonomous systems</em>
+</p>
+
 [Documentation](https://superagenticai.github.io/codeoptix) |
 [Get Started](#-quick-start) |
 [Examples](https://github.com/SuperagenticAI/codeoptix/tree/main/examples) |
@@ -26,16 +31,20 @@
 
 ## What is CodeOptiX?
 
-CodeOptiX is an **open-source agentic code optimization platform** for evaluating, testing, and improving AI coding agents. Built by [Superagentic AI](https://super-agentic.ai).
+**CodeOptiX is the universal code optimization engine that improves coding agent experience with deep evaluations and optimization.**
+
+When AI coding agents dazzle with impressive code but leave you wondering about quality, maintainability, security, and reliability, CodeOptiX ensures proper behavior through evaluations, reflection, and self-improvement. Powered by GEPA optimization and Bloom scenario generation.
 
-### Key Features
+Built by [**Superagentic AI**](https://super-agentic.ai) - *Advancing the future of AI agent optimization and autonomous systems.*
 
-- **GEPA Optimization** - Automatically improve agent behavior using Genetic-Pareto Evolution
-- **Bloom Evaluations** - Deep behavioral evaluation with Bloom-style scenario generation
-- **Behavior Testing** - Test coding agents against configurable behavior specifications
-- **Agent-Agnostic** - Works with Claude Code, Codex, Gemini CLI, and any ACP-compatible agent
-- **Multi-Provider** - Supports OpenAI, Anthropic, Google, and Ollama (local, no API key!)
-- **CI/CD Ready** - GitHub Actions integration for automated quality gates
+### 🚀 Key Capabilities
+
+- **🔍 Deep Behavioral Evaluation** - Comprehensive testing against security, reliability, and quality behaviors
+- **🧬 GEPA Optimization Engine** - [Genetic-Pareto Evolution](https://github.com/gepa-ai/gepa) for automatic agent improvement
+- **🌸 Bloom-Style Scenario Generation** - [Intelligent test case creation](https://github.com/safety-research/bloom) for thorough evaluation
+- **🎯 Multi-Agent Support** - Works with Claude Code, Codex, Gemini CLI, and custom agents
+- **🔧 Multi-Provider LLM Support** - OpenAI, Anthropic, Google, and Ollama (local models included!)
+- **⚡ CI/CD Integration** - Automated quality gates and GitHub Actions support
 
 ---
 
@@ -207,6 +216,17 @@ This project is licensed under the Apache License 2.0 - see the [LICENSE](https:
 
 <div align="center">
 
-**Brought to you by [Superagentic AI](https://super-agentic.ai)**
+## 🤖 About Superagentic AI
+
+**CodeOptiX is proudly built by [Superagentic AI](https://super-agentic.ai)**
+
+*Advancing AI agent optimization and autonomous systems for the future of software development.*
+
+### 🌟 Our Mission
+We're building the next generation of AI tools that enhance developer productivity and code quality through intelligent agent optimization.
+
+### 🚀 Explore More
+- **[Superagentic AI Website](https://super-agentic.ai)** - Learn about our mission
+- **[Our Projects](https://github.com/SuperagenticAI)** - Discover other AI agent tools
 
 </div>

docs/advanced/bloom.md

@@ -8,6 +8,8 @@ CodeOptiX integrates the Bloom framework for advanced scenario generation in beh
 
 Bloom is an open-source framework originally developed by Anthropic for automated behavior evaluation of large language models. It provides sophisticated patterns for ideation, scenario generation, and behavioral testing.
 
+**Learn more:** [Bloom Repository](https://github.com/safety-research/bloom)
+
 ### Why Bloom?
 
 Bloom excels at:

docs/advanced/error-handling.md

@@ -205,5 +205,5 @@ config = {
 
 - [Python API Guide](../guides/python-api.md) - Error handling in Python
 - [CLI Usage Guide](../guides/cli-usage.md) - CLI error handling
-- [Package Distribution](distribution.md) - Distribution setup
+- [Configuration Guide](../guides/configuration.md) - Error handling configuration
 

docs/advanced/gepa.md

@@ -8,6 +8,8 @@ CodeOptiX uses GEPA (Genetic-Pareto) to automatically improve agent prompts thro
 
 **GEPA (Genetic-Pareto)** is a framework for optimizing textual system components (like AI prompts, code, or instructions) using LLM-based reflection and evolutionary search. GEPA employs iterative mutation, reflection, and Pareto-aware candidate selection to evolve robust, high-performing variants.
 
+**Learn more:** [GEPA Repository](https://github.com/gepa-ai/gepa)
+
 **Note**: CodeOptiX uses GEPA's `InstructionProposalSignature` component for prompt evolution. This is a minimal integration that uses GEPA's proven instruction proposal mechanism, rather than the full GEPA optimization framework.
 
 ---

docs/api-reference.md

@@ -339,5 +339,5 @@ Generate code using registered adapters.
 
 ---
 
-For more details, see the [full API documentation](API.md).
+For usage examples, see the [Python API Guide](../guides/python-api.md).
 

docs/concepts/overview.md

@@ -2,17 +2,20 @@
 
 Understanding the fundamental concepts behind CodeOptiX.
 
-> **Agentic Code Optimization. Elevated Agent Experience.** Code Optimization Engine for every coding agent. Powered by Agent Optimizers like GEPA (Genetic-Pareto) and Bloom-style scenario generation for behavior testing.
+> **Agentic Code Optimization & Deep Evaluation for Superior Coding Agent Experience.** CodeOptiX is the universal code optimization engine that improves coding agent experience with deep evaluations and optimization. When AI coding agents dazzle with impressive code but leave you wondering about quality, maintainability, security, and reliability, CodeOptiX ensures proper behavior through evaluations, reflection, and self-improvement.
 
 ---
 
 ## What is CodeOptiX?
 
-CodeOptiX is an **agentic code optimization platform** for AI coding agents. It helps you:
+CodeOptiX is an **advanced evaluation and optimization platform** for AI coding agents. It provides comprehensive testing, analysis, and improvement capabilities to ensure your coding agents produce high-quality, reliable code.
 
-- ✅ **Evaluate** agent behavior
-- ✅ **Reflect** on results
-- ✅ **Evolve** agent prompts
+### Key Capabilities
+
+- 🔍 **Deep Evaluation** - Comprehensive behavioral testing of coding agents
+- 📊 **Detailed Analysis** - In-depth performance metrics and issue identification
+- 🧠 **Smart Optimization** - [GEPA](https://github.com/gepa-ai/gepa)-powered prompt evolution and improvement
+- 🎯 **Quality Assurance** - Automated testing against security, reliability, and correctness behaviors
 
 ---
 

docs/getting-started/installation.md

@@ -76,7 +76,7 @@ CodeOptiX supports multiple LLM providers. Choose the one that works best for yo
 **No API key required!** Use local Ollama models:
 
 ```bash
-# 1. Install Ollama: https://ollama.ai
+# 1. Install Ollama: https://ollama.com
 # 2. Start Ollama service
 ollama serve
 
@@ -161,7 +161,7 @@ Includes:
 CodeOptiX supports local Ollama models - no API key required!
 
 **Prerequisites:**
-1. Install Ollama: https://ollama.ai
+1. Install Ollama: https://ollama.com
 2. Start Ollama service: `ollama serve`
 3. Pull a model: `ollama pull llama3.1:8b` (or `gpt-oss:120b`, `qwen3:8b`, etc.)