fix: review add

Author: cdcabrera

README.md

@@ -94,6 +94,10 @@ main();
 
 For comprehensive usage, development, and project state [read the docs](./docs/README.md).
 
+- **Architecture**: Learn about our [hybrid documentation model and data sources](./docs/architecture.md#data-sources-and-integrations).
+- **Usage**: Detailed guide on [built-in tools and resources](./docs/usage.md).
+- **Development**: Reference for [CLI options and tool plugins](./docs/development.md).
+
 ## Contributing
 
 Contributing? Guidelines can be found here [CONTRIBUTING.md](./CONTRIBUTING.md).

docs/architecture.md

@@ -28,6 +28,18 @@ We'll be introducing our hybrid documentation model in upcoming releases. This c
 - **Baseline data**: Core guidelines and standards integrated directly into the server for standalone purposes, quick starts, and immediate access.
 - **Dynamic content**: Content synced from the latest available PatternFly implementation while you work, ensuring the LLM always has access to the latest documentation and patterns.
 
+### Data sources and integrations
+
+The PatternFly MCP server aggregates content from multiple official sources to provide a comprehensive development resource.
+
+#### PatternFly ai-helpers
+The server integrates the [patternfly/ai-helpers](https://github.com/patternfly/ai-helpers) repository to provide specialized, LLM-optimized guidance. This integration powers several key resource categories:
+- **AI Guidance**: Specialized patterns for React Charts, Chatbot, and general React development.
+- **Styling Standards**: CSS and styling requirements tailored for AI code generation.
+- **Prompt Engineering**: Includes `ai-prompt-guidance.md` to help users write more effective prompts for PatternFly.
+
+These helpers are a core part of our [Hybrid documentation model](#hybrid-documentation-model-in-progress), acting as the bridge between stable design patterns and dynamic implementation details.
+
 ### Tools, resources, and prompts as customizable plugins
 
 Tools, resources, and prompts as customizable plugins are the result of predictable MCP SDK patterns. In the case of the PatternFly MCP server,

docs/usage.md

@@ -66,6 +66,8 @@ Fetch full documentation and component JSON schemas for specific PatternFly URLs
 
 The server exposes a resource-centric architecture via the `patternfly://` URI scheme. MCP clients can use these resources directly. [Review the roadmap for future resource updates](./architecture.md#roadmap).
 
+> **Note on AI Content**: Specialized resources such as `patternfly://docs/react-guidelines` and `patternfly://docs/ai-prompt-guidance` are sourced from the [patternfly/ai-helpers](https://github.com/patternfly/ai-helpers) integration. These are specifically optimized to help LLMs generate more accurate PatternFly code. [See Data sources and integrations in architecture](./architecture.md#data-sources-and-integrations).
+
 ### Discovery resources
 
 Use these indexes to discover what is available in the library: