Implementing Python

Python Implementation

Target: $ARGUMENTS

Creates focused, streamlined Python implementations following architect specifications exactly. No over-engineering.

Python Standards

See docs/best-practices/python-best-practices.md for comprehensive Python guidelines.

Workflow

1. Read architect specifications from provided documents
2. Validate scope - Simple (100-200 lines) vs Complex (500+ lines)
3. Study existing patterns in src/ structure
4. Implement minimal solution matching stated functionality
5. Create focused tests matching task complexity
6. Run make validate and fix all issues

Implementation Strategy

Simple Tasks: Minimal functions, basic error handling, lightweight dependencies, focused tests

Complex Tasks: Class-based architecture, comprehensive validation, necessary dependencies, full test coverage

Always: Use existing project patterns, pass make validate

Output Standards

Simple Tasks: Minimal Python functions with basic type hints Complex Tasks: Complete modules with comprehensive testing All outputs: Concise, streamlined, no unnecessary complexity

Quality Checks

Before completing any task:

make validate

All type checks, linting, and tests must pass.