Prompt file imported from traefikturkey/onramp (.github/prompts/lint.prompt.md). Copyright stays with the author.

Lint Code

Name: lint
Author: traefikturkey

Objective

Run linting checks and systematically fix issues until code is clean.

Execution

Step 1: Run Linter

Python (Ruff - Recommended):

uv run ruff check .

Python (flake8):

uv run flake8 src/ tests/

JavaScript/TypeScript:

npm run lint
# or
npx eslint .

Go:

golangci-lint run

Step 2: Auto-fix Safe Issues

Ruff:

uv run ruff check --fix .

ESLint:

npm run lint -- --fix

Step 3: Manually Fix Remaining Issues

Review remaining issues and fix them one by one.

Step 4: Re-run Linter

Verify all issues are resolved:

uv run ruff check .
# Should show: All checks passed!

Common Linting Issues

Unused Imports

Error: F401 [*] 'sys' imported but unused

Fix: Remove the unused import

# Before
import sys
import os

# After
import os

Line Too Long

Error: E501 Line too long (95 > 88 characters)

Fix: Break into multiple lines

# Before
result = some_function(arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8)

# After
result = some_function(
    arg1, arg2, arg3, arg4,
    arg5, arg6, arg7, arg8
)

Missing Docstrings

Error: D100 Missing docstring in public module

Fix: Add docstring

# Before
def calculate_total(items):
    return sum(item.price for item in items)

# After
def calculate_total(items):
    """Calculate total price of all items."""
    return sum(item.price for item in items)

Undefined Names

Error: F821 Undefined name 'User'

Fix: Add missing import

# Before
def get_user():
    return User()

# After
from app.models import User

def get_user():
    return User()

Formatting Issues

Error: Multiple formatting violations

Fix: Run formatter

uv run ruff format .
# or
uv run black .

Linter Configuration

Ruff (pyproject.toml)

[tool.ruff]
line-length = 88
target-version = "py312"

[tool.ruff.lint]
select = [
    "E",   # pycodestyle errors
    "W",   # pycodestyle warnings
    "F",   # pyflakes
    "I",   # isort
    "N",   # pep8-naming
    "UP",  # pyupgrade
]
ignore = [
    "E501",  # line too long (handled by formatter)
]

[tool.ruff.lint.per-file-ignores]
"tests/**/*.py" = [
    "D100",  # Missing docstring in public module
    "D103",  # Missing docstring in public function
]

ESLint (.eslintrc.json)

{
  "extends": ["eslint:recommended"],
  "rules": {
    "indent": ["error", 2],
    "quotes": ["error", "single"],
    "semi": ["error", "always"]
  }
}

Selective Linting

Lint Specific File

uv run ruff check src/main.py

Lint Specific Directory

uv run ruff check src/

Ignore Specific Rules

# Ignore specific rule for one line
result = long_function_call()  # noqa: E501

# Ignore all rules for one line
result = complex_code()  # noqa

# Ignore specific rule for whole file (at top)
# ruff: noqa: E501

Fixing Strategy

1. Auto-fix First

# Let the linter fix what it can
uv run ruff check --fix .

# Check what's left
uv run ruff check .

2. Group Similar Issues

# See all issues grouped
uv run ruff check . | grep "F401"  # All unused imports

3. Fix Systematically

Fix all unused imports
Fix all line length issues
Add missing docstrings
Fix naming issues

4. Verify Clean

uv run ruff check .
# All checks passed!

Integration with Formatter

Run Formatter First

# Format code
uv run ruff format .

# Then check for remaining issues
uv run ruff check .

Combined Workflow

# Format and fix in one go
uv run ruff format . && uv run ruff check --fix .

Constraints

From Repository Instructions

✅ Use uv run ruff for uv projects
✅ Make minimal, targeted fixes
✅ Auto-fix safe issues
❌ Never suppress all warnings without review
❌ Never commit with linting errors (unless explicitly ignored)

Example Sessions

Example 1: Auto-fix cleans everything

# Run linter
uv run ruff check .
# ❌ Found 12 errors (5 auto-fixable)

# Auto-fix
uv run ruff check --fix .
# Fixed 5 errors

# Re-check
uv run ruff check .
# ✅ All checks passed!

Example 2: Manual fixes needed

# Run linter
uv run ruff check .
# ❌ Found 8 errors:
#   - F401: 'sys' imported but unused (x3)
#   - E501: Line too long (x5)

# Auto-fix imports
uv run ruff check --fix .
# Fixed 3 errors (removed unused imports)

# Manually fix line length
# [Edit files to break long lines]

# Re-check
uv run ruff check .
# ✅ All checks passed!

Example 3: Add missing docstrings

# Run linter
uv run ruff check .
# ❌ Found 10 errors:
#   - D100: Missing docstring in public module (x10)

# Add docstrings to files
# [Edit files to add module docstrings]

# Re-check
uv run ruff check .
# ✅ All checks passed!

When to Use /lint vs /check

Use `/lint` when:

You just want to check code style
You're fixing formatting issues
You're iterating on code cleanup

Use `/check` when:

You want tests + lint + types
You're preparing to commit
You need full validation

Recommendation: Use /lint during cleanup, /check before committing.

Output Format

Success Report

✅ Linting passed!

Files checked: 25
Issues found: 0
Auto-fixed: 0

Failure Report

❌ Linting failed

Issues found: 8
  - Unused imports: 3
  - Line too long: 5

Applying auto-fixes...

After Fix

✅ Linting passed!

Fixes applied:
  - Removed 3 unused imports
  - Reformatted 5 long lines

Troubleshooting

Too many errors

# Focus on specific error types
uv run ruff check . | grep "F401"

# Fix one type at a time
uv run ruff check --select F401 .

Conflicting rules

# Run formatter to standardize
uv run ruff format .

# Then lint
uv run ruff check .

Performance issues

# Lint only changed files
git diff --name-only | xargs uv run ruff check

Pre-commit Integration

Setup pre-commit hook

# .pre-commit-config.yaml
repos:
  - repo: https://github.com/astral-sh/ruff-pre-commit
    rev: v0.1.0
    hooks:
      - id: ruff
        args: [--fix]
      - id: ruff-format

Install hooks

pre-commit install

Customization Notes

CUSTOMIZE THIS PROMPT for your project:

Linter: ruff, flake8, eslint, golangci-lint, etc.
Rules: Configure which rules to enforce
Ignores: Set project-specific ignores
Auto-fix: Define what can be auto-fixed
Integration: Add to CI/CD pipeline

Source: Consolidated from agent-spike, onboard, attempt-one

# Lint Code ## Objective Run linting checks and systematically fix issues until code is clean. --- ## Execution ### Step 1: Run Linter **Python (Ruff - Recommended):** ```bash uv run ruff check . ``` **Python (flake8):** ```bash uv run flake8 src/ tests/ ``` **JavaScript/TypeScript:** ```bash npm run lint # or npx eslint . ``` **Go:** ```bash golangci-lint run ``` ### Step 2: Auto-fix Safe Issues **Ruff:** ```bash uv run ruff check --fix . ``` **ESLint:** ```bash npm run lint -- --fix ``` ### Step 3: Manually Fix Remaining Issues Review remaining issues and fix them one by one. ### Step 4: Re-run Linter Verify all issues are resolved: ```bash uv run ruff check . # Should show: All checks passed! ``` --- ## Common Linting Issues ### Unused Imports **Error:** `F401 [*] 'sys' imported but unused` **Fix:** Remove the unused import ```python # Before import sys import os # After import os ``` ### Line Too Long **Error:** `E501 Line too long (95 > 88 characters)` **Fix:** Break into multiple lines ```python # Before result = some_function(arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8) # After result = some_function( arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8 ) ``` ### Missing Docstrings **Error:** `D100 Missing docstring in public module` **Fix:** Add docstring ```python # Before def calculate_total(items): return sum(item.price for item in items) # After def calculate_total(items): """Calculate total price of all items.""" return sum(item.price for item in items) ``` ### Undefined Names **Error:** `F821 Undefined name 'User'` **Fix:** Add missing import ```python # Before def get_user(): return User() # After from app.models import User def get_user(): return User() ``` ### Formatting Issues **Error:** Multiple formatting violations **Fix:** Run formatter ```bash uv run ruff format . # or uv run black . ``` --- ## Linter Configuration ### Ruff (pyproject.toml) ```toml [tool.ruff] line-length = 88 target-version = "py312" [tool.ruff.lint] select = [ "E", # pycodestyle errors "W", # pycodestyle warnings "F", # pyflakes "I", # isort "N", # pep8-naming "UP", # pyupgrade ] ignore = [ "E501", # line too long (handled by formatter) ] [tool.ruff.lint.per-file-ignores] "tests/**/*.py" = [ "D100", # Missing docstring in public module "D103", # Missing docstring in public function ] ``` ### ESLint (.eslintrc.json) ```json { "extends": ["eslint:recommended"], "rules": { "indent": ["error", 2], "quotes": ["error", "single"], "semi": ["error", "always"] } } ``` --- ## Selective Linting ### Lint Specific File ```bash uv run ruff check src/main.py ``` ### Lint Specific Directory ```bash uv run ruff check src/ ``` ### Ignore Specific Rules ```python # Ignore specific rule for one line result = long_function_call() # noqa: E501 # Ignore all rules for one line result = complex_code() # noqa # Ignore specific rule for whole file (at top) # ruff: noqa: E501 ``` --- ## Fixing Strategy ### 1. Auto-fix First ```bash # Let the linter fix what it can uv run ruff check --fix . # Check what's left uv run ruff check . ``` ### 2. Group Similar Issues ```bash # See all issues grouped uv run ruff check . | grep "F401" # All unused imports ``` ### 3. Fix Systematically - Fix all unused imports - Fix all line length issues - Add missing docstrings - Fix naming issues ### 4. Verify Clean ```bash uv run ruff check . # All checks passed! ``` --- ## Integration with Formatter ### Run Formatter First ```bash # Format code uv run ruff format . # Then check for remaining issues uv run ruff check . ``` ### Combined Workflow ```bash # Format and fix in one go uv run ruff format . && uv run ruff check --fix . ``` --- ## Constraints ### From Repository Instructions - ✅ Use `uv run ruff` for uv projects - ✅ Make minimal, targeted fixes - ✅ Auto-fix safe issues - ❌ Never suppress all warnings without review - ❌ Never commit with linting errors (unless explicitly ignored) --- ## Example Sessions ### Example 1: Auto-fix cleans everything ```bash # Run linter uv run ruff check . # ❌ Found 12 errors (5 auto-fixable) # Auto-fix uv run ruff check --fix . # Fixed 5 errors # Re-check uv run ruff check . # ✅ All checks passed! ``` ### Example 2: Manual fixes needed ```bash # Run linter uv run ruff check . # ❌ Found 8 errors: # - F401: 'sys' imported but unused (x3) # - E501: Line too long (x5) # Auto-fix imports uv run ruff check --fix . # Fixed 3 errors (removed unused imports) # Manually fix line length # [Edit files to break long lines] # Re-check uv run ruff check . # ✅ All checks passed! ``` ### Example 3: Add missing docstrings ```bash # Run linter uv run ruff check . # ❌ Found 10 errors: # - D100: Missing docstring in public module (x10) # Add docstrings to files # [Edit files to add module docstrings] # Re-check uv run ruff check . # ✅ All checks passed! ``` --- ## When to Use /lint vs /check ### Use `/lint` when: - You just want to check code style - You're fixing formatting issues - You're iterating on code cleanup ### Use `/check` when: - You want tests + lint + types - You're preparing to commit - You need full validation **Recommendation:** Use `/lint` during cleanup, `/check` before committing. --- ## Output Format ### Success Report ``` ✅ Linting passed! Files checked: 25 Issues found: 0 Auto-fixed: 0 ``` ### Failure Report ``` ❌ Linting failed Issues found: 8 - Unused imports: 3 - Line too long: 5 Applying auto-fixes... ``` ### After Fix ``` ✅ Linting passed! Fixes applied: - Removed 3 unused imports - Reformatted 5 long lines ``` --- ## Troubleshooting ### Too many errors ```bash # Focus on specific error types uv run ruff check . | grep "F401" # Fix one type at a time uv run ruff check --select F401 . ``` ### Conflicting rules ```bash # Run formatter to standardize uv run ruff format . # Then lint uv run ruff check . ``` ### Performance issues ```bash # Lint only changed files git diff --name-only | xargs uv run ruff check ``` --- ## Pre-commit Integration ### Setup pre-commit hook ```yaml # .pre-commit-config.yaml repos: - repo: https://github.com/astral-sh/ruff-pre-commit rev: v0.1.0 hooks: - id: ruff args: [--fix] - id: ruff-format ``` ### Install hooks ```bash pre-commit install ``` --- ## Customization Notes **CUSTOMIZE THIS PROMPT** for your project: 1. **Linter:** ruff, flake8, eslint, golangci-lint, etc. 2. **Rules:** Configure which rules to enforce 3. **Ignores:** Set project-specific ignores 4. **Auto-fix:** Define what can be auto-fixed 5. **Integration:** Add to CI/CD pipeline **Source:** Consolidated from agent-spike, onboard, attempt-one

{ "prompt": "# Lint Code\n\n## Objective\n\nRun linting checks and systematically fix issues until code is clean.\n\n---\n\n## Execution\n\n### Step 1: Run Linter\n\n**Python (Ruff - Recommended):**\n```bash\nuv run ruff check .\n```\n\n**Python (flake8):**\n```bash\nuv run flake8 src/ tests/\n```\n\n**JavaScript/TypeScript:**\n```bash\nnpm run lint\n# or\nnpx eslint .\n```\n\n**Go:**\n```bash\ngolangci-lint run\n```\n\n### Step 2: Auto-fix Safe Issues\n\n**Ruff:**\n```bash\nuv run ruff check --fix .\n```\n\n**ESLint:**\n```bash\nnpm run lint -- --fix\n```\n\n### Step 3: Manually Fix Remaining Issues\n\nReview remaining issues and fix them one by one.\n\n### Step 4: Re-run Linter\n\nVerify all issues are resolved:\n```bash\nuv run ruff check .\n# Should show: All checks passed!\n```\n\n---\n\n## Common Linting Issues\n\n### Unused Imports\n\n**Error:** `F401 [*] 'sys' imported but unused`\n\n**Fix:** Remove the unused import\n```python\n# Before\nimport sys\nimport os\n\n# After\nimport os\n```\n\n### Line Too Long\n\n**Error:** `E501 Line too long (95 > 88 characters)`\n\n**Fix:** Break into multiple lines\n```python\n# Before\nresult = some_function(arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8)\n\n# After\nresult = some_function(\n arg1, arg2, arg3, arg4,\n arg5, arg6, arg7, arg8\n)\n```\n\n### Missing Docstrings\n\n**Error:** `D100 Missing docstring in public module`\n\n**Fix:** Add docstring\n```python\n# Before\ndef calculate_total(items):\n return sum(item.price for item in items)\n\n# After\ndef calculate_total(items):\n \"\"\"Calculate total price of all items.\"\"\"\n return sum(item.price for item in items)\n```\n\n### Undefined Names\n\n**Error:** `F821 Undefined name 'User'`\n\n**Fix:** Add missing import\n```python\n# Before\ndef get_user():\n return User()\n\n# After\nfrom app.models import User\n\ndef get_user():\n return User()\n```\n\n### Formatting Issues\n\n**Error:** Multiple formatting violations\n\n**Fix:** Run formatter\n```bash\nuv run ruff format .\n# or\nuv run black .\n```\n\n---\n\n## Linter Configuration\n\n### Ruff (pyproject.toml)\n\n```toml\n[tool.ruff]\nline-length = 88\ntarget-version = \"py312\"\n\n[tool.ruff.lint]\nselect = [\n \"E\", # pycodestyle errors\n \"W\", # pycodestyle warnings\n \"F\", # pyflakes\n \"I\", # isort\n \"N\", # pep8-naming\n \"UP\", # pyupgrade\n]\nignore = [\n \"E501\", # line too long (handled by formatter)\n]\n\n[tool.ruff.lint.per-file-ignores]\n\"tests/**/*.py\" = [\n \"D100\", # Missing docstring in public module\n \"D103\", # Missing docstring in public function\n]\n```\n\n### ESLint (.eslintrc.json)\n\n```json\n{\n \"extends\": [\"eslint:recommended\"],\n \"rules\": {\n \"indent\": [\"error\", 2],\n \"quotes\": [\"error\", \"single\"],\n \"semi\": [\"error\", \"always\"]\n }\n}\n```\n\n---\n\n## Selective Linting\n\n### Lint Specific File\n```bash\nuv run ruff check src/main.py\n```\n\n### Lint Specific Directory\n```bash\nuv run ruff check src/\n```\n\n### Ignore Specific Rules\n```python\n# Ignore specific rule for one line\nresult = long_function_call() # noqa: E501\n\n# Ignore all rules for one line\nresult = complex_code() # noqa\n\n# Ignore specific rule for whole file (at top)\n# ruff: noqa: E501\n```\n\n---\n\n## Fixing Strategy\n\n### 1. Auto-fix First\n```bash\n# Let the linter fix what it can\nuv run ruff check --fix .\n\n# Check what's left\nuv run ruff check .\n```\n\n### 2. Group Similar Issues\n```bash\n# See all issues grouped\nuv run ruff check . | grep \"F401\" # All unused imports\n```\n\n### 3. Fix Systematically\n- Fix all unused imports\n- Fix all line length issues\n- Add missing docstrings\n- Fix naming issues\n\n### 4. Verify Clean\n```bash\nuv run ruff check .\n# All checks passed!\n```\n\n---\n\n## Integration with Formatter\n\n### Run Formatter First\n```bash\n# Format code\nuv run ruff format .\n\n# Then check for remaining issues\nuv run ruff check .\n```\n\n### Combined Workflow\n```bash\n# Format and fix in one go\nuv run ruff format . && uv run ruff check --fix .\n```\n\n---\n\n## Constraints\n\n### From Repository Instructions\n\n- ✅ Use `uv run ruff` for uv projects\n- ✅ Make minimal, targeted fixes\n- ✅ Auto-fix safe issues\n- ❌ Never suppress all warnings without review\n- ❌ Never commit with linting errors (unless explicitly ignored)\n\n---\n\n## Example Sessions\n\n### Example 1: Auto-fix cleans everything\n\n```bash\n# Run linter\nuv run ruff check .\n# ❌ Found 12 errors (5 auto-fixable)\n\n# Auto-fix\nuv run ruff check --fix .\n# Fixed 5 errors\n\n# Re-check\nuv run ruff check .\n# ✅ All checks passed!\n```\n\n### Example 2: Manual fixes needed\n\n```bash\n# Run linter\nuv run ruff check .\n# ❌ Found 8 errors:\n# - F401: 'sys' imported but unused (x3)\n# - E501: Line too long (x5)\n\n# Auto-fix imports\nuv run ruff check --fix .\n# Fixed 3 errors (removed unused imports)\n\n# Manually fix line length\n# [Edit files to break long lines]\n\n# Re-check\nuv run ruff check .\n# ✅ All checks passed!\n```\n\n### Example 3: Add missing docstrings\n\n```bash\n# Run linter\nuv run ruff check .\n# ❌ Found 10 errors:\n# - D100: Missing docstring in public module (x10)\n\n# Add docstrings to files\n# [Edit files to add module docstrings]\n\n# Re-check\nuv run ruff check .\n# ✅ All checks passed!\n```\n\n---\n\n## When to Use /lint vs /check\n\n### Use `/lint` when:\n- You just want to check code style\n- You're fixing formatting issues\n- You're iterating on code cleanup\n\n### Use `/check` when:\n- You want tests + lint + types\n- You're preparing to commit\n- You need full validation\n\n**Recommendation:** Use `/lint` during cleanup, `/check` before committing.\n\n---\n\n## Output Format\n\n### Success Report\n```\n✅ Linting passed!\n\nFiles checked: 25\nIssues found: 0\nAuto-fixed: 0\n```\n\n### Failure Report\n```\n❌ Linting failed\n\nIssues found: 8\n - Unused imports: 3\n - Line too long: 5\n\nApplying auto-fixes...\n```\n\n### After Fix\n```\n✅ Linting passed!\n\nFixes applied:\n - Removed 3 unused imports\n - Reformatted 5 long lines\n```\n\n---\n\n## Troubleshooting\n\n### Too many errors\n\n```bash\n# Focus on specific error types\nuv run ruff check . | grep \"F401\"\n\n# Fix one type at a time\nuv run ruff check --select F401 .\n```\n\n### Conflicting rules\n\n```bash\n# Run formatter to standardize\nuv run ruff format .\n\n# Then lint\nuv run ruff check .\n```\n\n### Performance issues\n\n```bash\n# Lint only changed files\ngit diff --name-only | xargs uv run ruff check\n```\n\n---\n\n## Pre-commit Integration\n\n### Setup pre-commit hook\n\n```yaml\n# .pre-commit-config.yaml\nrepos:\n - repo: https://github.com/astral-sh/ruff-pre-commit\n rev: v0.1.0\n hooks:\n - id: ruff\n args: [--fix]\n - id: ruff-format\n```\n\n### Install hooks\n```bash\npre-commit install\n```\n\n---\n\n## Customization Notes\n\n**CUSTOMIZE THIS PROMPT** for your project:\n\n1. **Linter:** ruff, flake8, eslint, golangci-lint, etc.\n2. **Rules:** Configure which rules to enforce\n3. **Ignores:** Set project-specific ignores\n4. **Auto-fix:** Define what can be auto-fixed\n5. **Integration:** Add to CI/CD pipeline\n\n**Source:** Consolidated from agent-spike, onboard, attempt-one", "variables": [], "notes": "Run linting checks and fix issues. Use /check for comprehensive quality checks including tests. Mode: agent.", "metadata": { "source": { "provider": "github-prompts", "repository": "https://github.com/traefikturkey/onramp", "path": ".github/prompts/lint.prompt.md", "ref": "4f5c540d2d4cc89ddc031270ca3e07d8af014424", "url": "https://github.com/traefikturkey/onramp/blob/4f5c540d2d4cc89ddc031270ca3e07d8af014424/.github/prompts/lint.prompt.md", "key": "traefikturkey/onramp/.github/prompts/lint.prompt.md" } }, "model_hints": [ "gpt-5-mini" ] }

About