python-project-template

Step 2 — Architecture and domain design, one feature at a time

Step 1 — discover requirements through stakeholder interviews and write Gherkin acceptance criteria

Generate and update architecture diagrams, living glossary, and system overview from existing project docs

Enforce code quality using ruff, pytest coverage, and static type checking

Create pull requests with conventional commits, proper formatting, and branch workflow

Flow protocol — design and operate state machine workflows with FLOW.md + WORK.md

Create releases with hybrid major.minor.calver versioning and optional custom release naming

Step 3 — TDD Loop, one @id at a time

Session start and end protocol — read FLOW.md, auto-detect state, resume from checkpoint, update and commit

Score and select the next backlog feature by value, effort, and dependencies

Step 4 — run all verification commands, review code quality, and produce a written report

Create new OpenCode skills following the skill definition standard

GoF design pattern catalogue — smell triggers and before/after structural descriptions

Create new OpenCode agents with research-backed design patterns and industry standards

Safe refactoring protocol for TDD — green bar rule, two-hats discipline, preparatory refactoring, and smell catalogue

Git branching, merge safety, and commit hygiene for feature development

Author and update SVG visual assets using project branding identity

Select and validate a project color palette with WCAG contrast compliance