refactor: restructure CLAUDE.md for effective context usage

[KRRT7]

Summary

• Remove commands block from CLAUDE.md (standard tool usage Claude already knows)
• Remove dead @AGENTS.md reference
• Add optimization pipeline overview and domain glossary to CLAUDE.md
• Move tool workflows (mypy, prek) to on-demand skills
• Add path-scoped rules for optimization pipeline and language support patterns
• Remove redundancy across rules files
• Add key entry points table to architecture.md

[claude]

PR Review Summary

Prek Checks

✅ Passed — No Python files changed; prek skipped Ruff checks (no files to check).

Code Review

✅ No issues found — This is a documentation-only PR (9 markdown files). No code changes, no security concerns, no breaking API changes.

Changes verified:

• All file paths referenced in architecture.md entry points table exist and are accurate
• All patterns documented in language-patterns.md and optimization-patterns.md match actual codebase behavior (set_current_language, get_language_support, @register_language, __getattr__ lazy imports, is_javascript(), Result type, CandidateEvaluationContext, codeflash_capture)
• conftest.py does use reset_current_language() autouse fixture as documented in testing.md
• @AGENTS.md was a dead reference (file does not exist) — correctly removed
• Skills (fix-mypy.md, fix-prek.md) accurately describe existing workflows

Test Coverage

⏭️ Not applicable — No Python source files were changed in this PR. All changes are to .md documentation files.

---

Last updated: 2026-02-14