[AGENTS] Reduce CLAUDE.md size to avoid Claude Code performance warning

[PragalvaXFREZ]

Description

Claude Code shows a startup warning in this repository because CLAUDE.md is larger than its recommended memory-file size threshold:

Large CLAUDE.md will impact performance (44.1k chars > 40.0k). /memory to edit

CLAUDE.md is a symlink to AGENTS.md, and the target file is currently about 44,352 bytes. The warning appears every time Claude Code loads the repository context.

Impact

• Adds noise during startup for contributors using Claude Code.
• May slow context loading or reduce responsiveness for agents reading the repo instructions.
• Makes it harder to distinguish actionable warnings from routine startup output.

Suggested Fix

Trim the top-level agent memory file below the 40k character threshold while preserving the important guidance. Possible approaches:

• Keep CLAUDE.md / AGENTS.md as a concise routing and policy overview.
• Move detailed sections, long checklists, and examples into focused docs under docs/.
• Link to those detailed docs from the top-level instructions instead of embedding everything inline.
• Keep the most critical schema-specific rules, especially the dual-schema pattern and generated-artifact warnings, directly in the top-level file.

Acceptance Criteria

• CLAUDE.md / AGENTS.md is reduced below the Claude Code warning threshold.
• Essential repo-specific instructions remain easy for agents to find.
• Detailed guidance remains available through linked documents.
• Claude Code no longer displays the large CLAUDE.md warning on startup.

[Pranav-d33]

Hi, if this issue is still open and unassigned, I’d be interested in working on it.