diff --git a/CLAUDE.md b/CLAUDE.md
index 26e3ca2..56f93f5 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -33,7 +33,7 @@ container, docker/E2E compose) that research and SDK consumers should use.
 ## Development Guidelines
 
 ### Code Style & Standards
-- Files must be smaller than 400 lines excluding comments. Refactor when exceeded.
+- Code files (TypeScript, JavaScript, shell, SQL, Python) must be smaller than 400 lines excluding comments. Refactor when exceeded. **Markdown and other prose/config files (`.md`, `.mdx`, `.yaml`, `.json`, `.toml`) are exempt.**
 - Functions must be smaller than 40 lines excluding comments and catch/finally blocks.
 - Test files must be smaller than 400 lines. Tests must be smaller than 40 lines.
 - Use TypeScript with proper types for all variables, parameters, and return values.