chore: llm instructions, ruff config

Author: pythoninthegrass

{{cookiecutter.project_slug}}/CLAUDE.md

@@ -5,27 +5,37 @@
 - Minimize inline comments
 - Retain tabs, spaces, and encoding
 - Fix linting errors before saving files.
-  - Respect `.markdownlint.jsonc` rules for all markdown files
+  - `markdownlint -c .markdownlint.jsonc --fix <MARKDOWN_FILE>`
 - If under 50 lines of code (LOC), print the full function or class
 - If the token limit is close or it's over 50 LOC, print the line numbers and avoid comments altogether
 - Explain as much as possible in the chat unless asked to annotate (i.e., docstrings, newline comments, etc.)
 
 ## Build, Lint, and Test Commands
 
-- Full test suite: `uv run pytest` or `task test`
-- Single test: `uv run pytest tests/test_filename.py::test_function_name`
-- Linting: `uv run ruff check --fix --respect-gitignore` or `task lint`
-- Formatting: `uv run ruff format --respect-gitignore` or `task format`
-- Check dependencies: `uv run deptry .` or `task deptry`
-- Pre-commit hooks: `pre-commit run --all-files` or `task pre-commit`
+| Operation           | Direct Command                                             | Task Shortcut     |
+|:--------------------|:-----------------------------------------------------------|:------------------|
+| Full test suite     | `uv run pytest`                                            | `task test`       |
+| Single test         | `uv run pytest tests/test_filename.py::test_function_name`  |  -                |
+| Linting             | `uv run ruff --check --diff --respect-gitignore`           | `task lint`       |
+| Formatting          | `uv run ruff format --respect-gitignore`                   | `task format`     |
+| Check dependencies  | `uv run deptry .`                                          |  -                |
+| Pre-commit hooks    | `pre-commit run --all-files`                                | `task pre-commit` |
 
 ## Code Style Guidelines
 
-- **Formatting**: 4 spaces, 130-char line limit, LF line endings
-- **Imports**: Ordered by type, combined imports when possible
-- **Naming**: snake_case functions/vars, PascalCase classes, UPPERCASE constants
-- **Type Hints**: Use Optional for nullable params, pipe syntax for Union
-- **Error Handling**: Specific exception types, descriptive error messages
-- **File Structure**: Core logic in app/core/, utilities in app/utils/
-- **Docstrings**: Use double quotes for docstrings
-- **Tests**: Files in tests/, follow test_* naming convention
+- **Formatting**
+  - 4 spaces, 130-char line limit, LF line endings
+- **Imports**
+  - Ordered by type, combined imports when possible
+- **Naming**
+  - snake_case functions/vars, PascalCase classes, UPPERCASE constants
+- **Type Hint**
+  - Use Optional for nullable params, pipe syntax for Union
+- **Error Handling**
+  - Specific exception types, descriptive error messages
+- **File Structure**
+  - Core logic in app/core/, utilities in app/utils/
+- **Docstrings**
+  - Use double quotes for docstrings
+- **Tests**
+  - Files in tests/, follow test_* naming convention

{{cookiecutter.project_slug}}/ruff.toml

@@ -0,0 +1,87 @@
+# Fix without reporting on leftover violations
+fix-only = true
+
+# Enumerate all fixed violations
+show-fixes = true
+
+# Indent width (default: 4)
+indent-width = 4
+
+# Black (default: 88)
+line-length = 130
+
+# Exclude a variety of commonly ignored directories.
+exclude = [
+    ".bzr",
+    ".direnv",
+    "dist",
+    ".eggs",
+    ".git",
+    ".git-rewrite",
+    ".hg",
+    ".mypy_cache",
+    ".nox",
+    ".pants.d",
+    "__pycache__",
+    ".pytype",
+    ".ruff_cache",
+    ".svn",
+    ".tox",
+    ".venv",
+    "__pypackages__",
+    "_build",
+    "buck-out",
+    "build",
+    "dist",
+    "node_modules",
+    "venv",
+]
+
+# Assume Python 3.13
+target-version = "py313"
+
+[format]
+# Use spaces instead of tabs
+indent-style = "space"
+
+# Use `\n` line endings for all files
+line-ending = "lf"
+
+# Set quote style for strings
+quote-style = "preserve"
+
+[lint]
+select = [
+    # pycodestyle
+    "E",
+    # Pyflakes
+    "F",
+    # pyupgrade
+    "UP",
+    # flake8-bugbear
+    "B",
+    # flake8-simplify
+    "SIM",
+    # isort
+    "I",
+]
+ignore = ["D203", "E203", "E251", "E266", "E401", "E402", "E501", "F401", "F403", "F841"]
+
+# Allow unused variables when underscore-prefixed.
+dummy-variable-rgx = "^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$"
+
+# Allow autofix for all enabled rules (when `--fix`) is provided.
+fixable = ["A", "B", "C", "D", "E", "F", "G", "I", "N", "Q", "S", "T", "W", "ANN", "ARG", "BLE", "COM", "DJ", "DTZ", "EM", "ERA", "EXE", "FBT", "ICN", "INP", "ISC", "NPY", "PD", "PGH", "PIE", "PL", "PT", "PTH", "PYI", "RET", "RSE", "RUF", "SIM", "SLF", "TID", "TRY", "UP", "YTT"]
+
+[lint.isort]
+combine-as-imports = true
+from-first = false
+no-sections = true
+order-by-type = true
+
+[lint.flake8-quotes]
+docstring-quotes = "double"
+
+[lint.mccabe]
+# Unlike Flake8, default to a complexity level of 10.
+max-complexity = 10