implementing-python

name	implementing-python
description	Implements concise, streamlined Python code matching exact architect specifications. Use when writing Python code, creating modules, or when the user asks to implement features in Python.
compatibility	Designed for Claude Code
metadata	{"argument-hint":["feature-name"],"allowed-tools":"Read, Grep, Glob, Edit, Write, Bash, WebSearch, WebFetch"}

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.