Add i18n caching documentation and update CLAUDE.md

Document the root cause of random locale switching on Vercel:
- next-intl's localeDetection reads Accept-Language header
- This triggers dynamic rendering in Next.js
- Vercel can't cache dynamic pages properly

Includes:
- Detailed technical analysis with request flow
- Three solution options with pros/cons
- Step-by-step implementation guide
- Testing plan and debug commands
- Links to relevant Next.js/next-intl issues

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: NebraskaCoder

CLAUDE.md

@@ -1,6 +1,6 @@
-# Rocky Linux Website - AI Assistant Instructions
+# CLAUDE.md
 
-This document provides instructions for AI assistants working with the Rocky Linux website codebase.
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
 
 ## Project Overview
 
@@ -21,17 +21,6 @@ npm run dev
 - `npm run test` - Run unit tests
 - `npm run e2e` - Run Playwright E2E tests
 
-## Documentation Structure
-
-Detailed documentation is organized in the `/docs` folder:
-
-- **[Architecture Overview](./docs/architecture/overview.md)** - System design and structure
-- **[Tech Stack](./docs/architecture/tech-stack.md)** - Technologies and dependencies
-- **[Project Structure](./docs/architecture/project-structure.md)** - File organization
-- **[Development Guide](./docs/development/getting-started.md)** - Setup and development workflow
-- **[Component Guide](./docs/components/overview.md)** - UI component documentation
-- **[Deployment Guide](./docs/deployment/overview.md)** - Build and deployment processes
-
 ## Important Conventions
 
 1. **TypeScript First** - All new code should be written in TypeScript
@@ -76,6 +65,9 @@ Detailed documentation is organized in the `/docs` folder:
 - Keep components small and focused
 - Document complex logic
 
-## Need More Details?
+## Technical Documentation
+
+Detailed technical documentation is available in the `/docs` folder:
 
-Refer to the specific documentation files in the `/docs` folder for in-depth information about any aspect of the project.
+- [Documentation Index](./docs/README.md)
+- [i18n Caching and Locale Detection](./docs/i18n/caching-and-locale-detection.md) - Critical information about Vercel caching behavior with next-intl

docs/README.md

@@ -0,0 +1,25 @@
+# Rocky Linux Website Documentation
+
+Technical documentation for the Rocky Linux website codebase.
+
+## Documentation Index
+
+### Internationalization (i18n)
+
+- [Caching and Locale Detection](./i18n/caching-and-locale-detection.md) - Deep dive into i18n caching issues with Vercel and next-intl, including root cause analysis and recommended solutions.
+
+## Quick Links
+
+- [Project README](../README.md)
+- [Contributing Guidelines](../CONTRIBUTING.md)
+- [AI Assistant Instructions](../CLAUDE.md)
+
+## Documentation Standards
+
+When adding new documentation:
+
+1. Use clear, descriptive headings
+2. Include code examples where applicable
+3. Link to external sources and references
+4. Add entries to this index file
+5. Include a "Last updated" date at the bottom of documents