- Remove commands block from CLAUDE.md (standard tool usage Claude knows) - Remove dead @AGENTS.md reference - Add optimization pipeline overview with module pointers - Add domain glossary (optimization candidate, addressable time, candidate forest, replay test, tracer, worktree mode) - Extract mypy workflow to .claude/skills/fix-mypy.md (on-demand) - Create .claude/skills/fix-prek.md for prek workflow (on-demand) - Add key entry points table to architecture.md - Create path-scoped rules: optimization-patterns.md, language-patterns.md - Remove redundancy from source-code.md and across rules files - Move "never use pip" convention to code-style.md
527 B
527 B
Code Style
- Line length: 120 characters
- Python: 3.9+ syntax
- Package management: Always use
uv, neverpip - Tooling: Ruff for linting/formatting, mypy strict mode, prek for pre-commit checks
- Comments: Minimal - only explain "why", not "what"
- Docstrings: Do not add unless explicitly requested
- Naming: NEVER use leading underscores (
_function_name) - Python has no true private functions, use public names - Paths: Always use absolute paths, handle encoding explicitly (UTF-8)