OCPBUGS-74178: Direct AI agents to AGENTS.md documentation hub

.coderabbit.yaml

@@ -75,12 +75,11 @@ knowledge_base:
     enabled: true
     filePatterns:
       # Repository documentation
+      - "AGENTS.md"
       - "ARCHITECTURE.md"
       - "CONVENTIONS.md"
       - "TESTING.md"
       - "STYLEGUIDE.md"
       - "CONTRIBUTING.md"
       - "README.md"
-      # AI context with project architecture and conventions
-      - ".ai/context.md"
-      - ".ai/README.md"
+      - "INTERNATIONALIZATION.md"

.cursor/context.md

@@ -1,9 +1,20 @@
 # Cursor AI Configuration
 
-This file contains Cursor-specific configuration and includes the shared AI context.
+This file contains Cursor-specific configuration.
 
-## Shared AI Context
+## Primary AI Context
 
-The primary AI context for this project is maintained in [../.ai/context.md](../.ai/context.md). This ensures consistency across different AI assistants (Claude, Cursor, etc.).
+The primary AI entry point for this project is maintained in [AGENTS.md](AGENTS.md).
 
-See [../.ai/README.md](../.ai/README.md) for more information about the AI context structure.
+**AT SESSION STARTUP: Automatically read [AGENTS.md](AGENTS.md)** to understand project structure and workflows.
+
+**REQUIRED: Before generating or modifying any code, you MUST:**
+1. Ensure you have current context from [AGENTS.md](AGENTS.md)
+2. Consult all relevant linked documentation files based on your task:
+   - [ARCHITECTURE.md](ARCHITECTURE.md) - Dynamic plugin SDK, extension points, module federation, public API boundaries
+   - [CONVENTIONS.md](CONVENTIONS.md) - Coding patterns, TypeScript/React/Go conventions, state management, hooks usage
+   - [TESTING.md](TESTING.md) - Jest/RTL unit tests, Cypress E2E tests, mocking strategies, test best practices
+   - [README.md](README.md) - Project setup, local development environment, building, running the console
+   - [CONTRIBUTING.md](CONTRIBUTING.md) - Git workflow, commit message format, PR process, backporting fixes
+   - [STYLEGUIDE.md](STYLEGUIDE.md) - File naming conventions, Go/SCSS/TypeScript formatting rules
+   - [INTERNATIONALIZATION.md](INTERNATIONALIZATION.md) - i18next usage, translation workflow, pseudolocalization, language support

CLAUDE.md

@@ -1,9 +1,20 @@
 # Claude Code AI Configuration
 
-This file contains Claude-specific configuration and includes the shared AI context.
+This file contains Claude-specific configurations and hooks.
 
-## Shared AI Context
+## Primary AI Context
 
-The primary AI context for this project is maintained in [.ai/context.md](./.ai/context.md). This ensures consistency across different AI assistants (Claude, Cursor, etc.).
+The primary AI entry point for this project is maintained in [AGENTS.md](AGENTS.md).
 
-See [.ai/README.md](./.ai/README.md) for more information about the AI context structure.
+**AT SESSION STARTUP: Automatically read [AGENTS.md](AGENTS.md)** to understand project structure and workflows.
+
+**REQUIRED: Before generating or modifying any code, you MUST:**
+1. Ensure you have current context from [AGENTS.md](AGENTS.md)
+2. Consult all relevant linked documentation files based on your task:
+   - [ARCHITECTURE.md](ARCHITECTURE.md) - Dynamic plugin SDK, extension points, module federation, public API boundaries
+   - [CONVENTIONS.md](CONVENTIONS.md) - Coding patterns, TypeScript/React/Go conventions, state management, hooks usage
+   - [TESTING.md](TESTING.md) - Jest/RTL unit tests, Cypress E2E tests, mocking strategies, test best practices
+   - [README.md](README.md) - Project setup, local development environment, building, running the console
+   - [CONTRIBUTING.md](CONTRIBUTING.md) - Git workflow, commit message format, PR process, backporting fixes
+   - [STYLEGUIDE.md](STYLEGUIDE.md) - File naming conventions, Go/SCSS/TypeScript formatting rules
+   - [INTERNATIONALIZATION.md](INTERNATIONALIZATION.md) - i18next usage, translation workflow, pseudolocalization, language support