Imported from zwldarren/CodeSnap (.ruler/AGENTS.md). Install upstream with npx skills add zwldarren/CodeSnap --skill .ruler. Copyright stays with the author.

CodeSnap Agent Guidelines

Build/Lint/Test Commands

• Install: uv sync
• Run tests: uv run pytest -v
• Run single test: uv run pytest -v -k "test_name"
• Type checking: uv run mypy src/
• Linting: uv run ruff check src/
• Formatting: uv run ruff format src/

Code Style Guidelines

• Imports: Group stdlib, third-party, local imports with blank lines
• Types: Use Pydantic models for data structures, type hints everywhere
• Naming: snake_case for variables/functions, PascalCase for classes
• Error handling: Use custom exceptions, rich error messages
• CLI: Click framework with rich output formatting
• Formatting: Follow ruff defaults, max line length 88
• Documentation: Google-style docstrings, type hints in function signatures