Merge pull request #1453 from codeflash-ai/claude-md-mypy-instructions

docs: add mypy type checking instructions to CLAUDE.md

Author: KRRT7

CLAUDE.md

@@ -27,12 +27,29 @@ uv run ruff format codeflash/    # Format
 # Linting (run before committing)
 uv run prek run --from-ref origin/main
 
+# Mypy type checking (run on changed files before committing)
+uv run mypy --non-interactive --config-file pyproject.toml <changed_files>
+
 # Running the CLI
 uv run codeflash --help
 uv run codeflash init            # Initialize in a project
 uv run codeflash --all           # Optimize entire codebase
 ```
 
+## Mypy Type Checking
+
+When modifying code, fix any mypy type errors in the files you changed. Run mypy on changed files:
+
+```bash
+uv run mypy --non-interactive --config-file pyproject.toml <changed_files>
+```
+
+Rules:
+- Fix type annotation issues: missing return types, incorrect types, Optional/None unions, import errors for type hints
+- Do NOT add `# type: ignore` comments — always fix the root cause
+- Do NOT fix type errors that require logic changes, complex generic type rework, or anything that could change runtime behavior
+- Files in `mypy_allowlist.txt` are checked in CI — ensure they remain error-free
+
 <!-- Section below is auto-generated by `tessl install` - do not edit manually -->
 
 # Agent Rules <!-- tessl-managed -->