Coding Agent Context

This project uses uv for dependency management and enforces strict linting, formatting, and type-checking standards. All Coding Agents MUST follow these instructions after generating or modifying code to ensure compatibility with the project's CI/CD pipelines.

Post-Generation Checklist

From the repository root (where this AGENTS.md file lives), run the following commands inside the v3/ directory:

1. Code Formatting: Format the code using ruff.

   uv run ruff format .
   

2. Linting: Run ruff check to identify and fix potential issues.

   uv run ruff check --fix .
   

3. Type Checking: Verify type safety with mypy.

   uv run mypy --ignore-missing-imports .
   

Development Standards

• Language: All code, documentation, and comments MUST be written in English.
• Dependencies: Use uv for all dependency management tasks (e.g., uv sync, uv run).
• CI Alignment: These steps align with the .github/workflows/linting.yml and .github/workflows/type-tests.yml configurations.

Ensure all checks pass before considering a task complete.