herald

Default Python development and review standard for this repo. Use whenever writing, changing, refactoring, debugging, testing, or reviewing Python code; when asked for modern Python, best practices, clean code, or Zen of Python guidance; and as the final self-review rubric before declaring Python work complete. Targets Python 3.12.

General Python development skill for designing, implementing, refactoring, debugging, testing, validating, and reviewing Python code. Use for Python 3.11+ projects, especially modern pyproject-based repos using uv, Ruff, pytest, mypy or pyright, Pydantic v2, Typer, or Loguru. Adapt to the target repository before applying defaults.

Code-quality rubric for this repo (miniCOIL v2): what 'good' Python looks like here, focused on the judgment-level and subtle/version-aware issues that the linter cannot catch. Use whenever reviewing, refactoring, or cleaning up Python; when asked to follow 'best practices', 'modern Python', the 'Zen of Python', or to make code less ugly; and as the standard that the code-quality review workflow loads. Targets Python 3.12.

GSM8K evaluation protocol: answer extraction (####, \boxed, CoT), accuracy scoring, prompt formatting, few-shot exemplars, dataset loading, pitfalls. Use when: GSM8K, grade school math, openai/gsm8k, #### delimiter, parse_gsm8k_answer, detect_answer_failure, load_gsm8k, format_chat, math benchmark scoring, gsm8k few-shot, chain-of-thought eval.

Use preemptively at the start of any session whose work decomposes into delegable units and whose main-thread context is worth protecting. A report, a large feature, a migration are examples, not the full set; the trigger is the shape (many token-heavy steps, compact results), not the task type. Also use whenever the user asks to delegate work to subagents. Invoke before context fills, not after.

Pydantic v2 best practices and correct syntax. Use when code imports pydantic, uses BaseModel, Field, field_validator, model_validator, ConfigDict, TypeAdapter. Triggers on: Pydantic, data validation, model serialization, API schemas. Corrects common v1 patterns LLMs generate.