git:20260301.2e7e6b3 to git:20260322.75aadc6

---

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:

allowed-tools: Read, Grep, Glob, Edit, Write, Bash, WebSearch, WebFetch

argument-hint: [feature-name]

---

# Python Implementation

**Target**: $ARGUMENTS

Creates **focused, streamlined** Python implementations following architect

specifications exactly. No over-engineering.

## Python Standards

See `references/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:

```bash

make validate

```

All type checks, linting, and tests must pass.