wntic/pyhouse

wntic/pyhouse · CLAUDE.md

wntic/pyhouse · plugins/pyhouse-flat/skills/flat-entrypoint/SKILL.md · Use when choosing how a flat-layered service is triggered and writing the process that triggers it — one run per…

wntic/pyhouse · plugins/pyhouse-flat/skills/flat-layered/SKILL.md · Use when structuring a worker, crawler, pipeline, ETL job or integration service whose family is already settled as…

wntic/pyhouse · plugins/pyhouse-flat/skills/flat-persistence/SKILL.md · Use when a flat-layered service reads or writes a datastore — its table definitions, its component-owned settings…

wntic/pyhouse · plugins/pyhouse-flat/skills/flat-project-setup/SKILL.md · Use when laying a flat-layered service down once — which runtime and development libraries each of its roles brings…

wntic/pyhouse · plugins/pyhouse-flat/skills/flat-test-entrypoint/SKILL.md · Use when testing what a flat-layered service's trigger actually runs — the function it calls end to end against the…

wntic/pyhouse · plugins/pyhouse-flat/skills/flat-test-integration-setup/SKILL.md · Use when laying the shared fixtures a flat-layered service's integration tests rest on — the suite-owned datastore…

wntic/pyhouse · plugins/pyhouse-flat/skills/flat-test-persistence/SKILL.md · Use when testing a flat-layered service's data-access package against the real datastore — its tables and the…

wntic/pyhouse · plugins/pyhouse-flat/skills/flat-test-service-client/SKILL.md · Use when testing one external-service HTTP client class with its transport stubbed — URL assembly, the outgoing…

wntic/pyhouse · plugins/pyhouse-git/skills/git-branching/SKILL.md · Use when starting a branch, deciding how a change reaches the mainline, cleaning a branch's history before it lands, or…

wntic/pyhouse · plugins/pyhouse-git/skills/git-commit-message/SKILL.md · Use when writing a commit message or a merge or pull request's title or description, or deciding what type, scope or…

wntic/pyhouse · plugins/pyhouse-hex/skills/hex-application/SKILL.md · Use when writing a use case — a CQRS command handler, a query handler, or its frozen input DTO — including a command…

wntic/pyhouse · plugins/pyhouse-hex/skills/hex-architecture/SKILL.md · Use when the family is already settled as hexagonal and the question is where a module belongs or whether an import may…

wntic/pyhouse · plugins/pyhouse-hex/skills/hex-capability-adapter/SKILL.md · Use when implementing an `ICan<Verb>` capability against a real external system — the adapter under…

wntic/pyhouse · plugins/pyhouse-hex/skills/hex-conventions/SKILL.md · Use when asking where does this file go or what is this class called — the registry deriving a path and class name from…

wntic/pyhouse · plugins/pyhouse-hex/skills/hex-domain-model/SKILL.md · Use when creating or changing a domain entity, value object, enum or filter record — stdlib dataclasses…

wntic/pyhouse · plugins/pyhouse-hex/skills/hex-domain-ports/SKILL.md · Use when defining a `typing.Protocol` port in the domain — the `I`-prefixed interface adapters satisfy structurally…

wntic/pyhouse · plugins/pyhouse-hex/skills/hex-domain-service/SKILL.md · Use when a domain rule needs state one entity cannot see — a cross-aggregate check, a uniqueness check, does the…

wntic/pyhouse · plugins/pyhouse-hex/skills/hex-persistence/SKILL.md · Use when one hexagonal service's own relational layer changes — the `Table` and its constraints, the repository adapter…

wntic/pyhouse · plugins/pyhouse-hex/skills/hex-project-setup/SKILL.md · Use when laying a hexagonal project down once — which libraries its core, its entrypoints, its stores and its features…

wntic/pyhouse · plugins/pyhouse-hex/skills/hex-restapi-app/SKILL.md · Use when bootstrapping a FastAPI shell once per project, or changing request handling shared by every route —…

wntic/pyhouse · plugins/pyhouse-hex/skills/hex-restapi-auth/SKILL.md · Use when an HTTP entrypoint must authenticate its caller or gate a route on a role. Owns the caller identity, the…

wntic/pyhouse · plugins/pyhouse-hex/skills/hex-restapi-endpoint/SKILL.md · Use when adding or changing one REST route, or creating a resource's router file `restapi/routers/<resource>.py` — thin…

wntic/pyhouse · plugins/pyhouse-hex/skills/hex-restapi-schema/SKILL.md · Use when a REST request or response body gains or changes a field — the pydantic models in…

wntic/pyhouse · plugins/pyhouse-hex/skills/hex-store-repository/SKILL.md · Use when an aggregate is persisted on a nonrelational store — key-value, document or wide-column (redis, mongo, dynamo)…

wntic/pyhouse · plugins/pyhouse-hex/skills/hex-test-app-invariants/SKILL.md · Use when testing a property of the assembled HTTP app itself rather than one route's own behaviour — a check that needs…

wntic/pyhouse · plugins/pyhouse-hex/skills/hex-test-application-handler/SKILL.md · Use when unit-testing a CQRS command or query handler against in-memory fakes, or when writing one of those fakes —…

wntic/pyhouse · plugins/pyhouse-hex/skills/hex-test-capability-adapter/SKILL.md · Use when testing the infrastructure adapter behind an `ICan<Verb>` capability port in one of its three flavours — a…

wntic/pyhouse · plugins/pyhouse-hex/skills/hex-test-domain/SKILL.md · Use when testing a domain entity, value object, enum or domain service with stdlib, `pytest` and `myapp.domain` — no…

wntic/pyhouse · plugins/pyhouse-hex/skills/hex-test-integration-setup/SKILL.md · Use when laying or changing the `tests/integration/conftest.py` hierarchy one hexagonal package's suite rests on —…

wntic/pyhouse · plugins/pyhouse-hex/skills/hex-test-repository-contract/SKILL.md · Use when testing an aggregate's repository adapter — an `IFooRepository` implementation — against the real backend…

wntic/pyhouse · plugins/pyhouse-hex/skills/hex-test-restapi-auth/SKILL.md · Use when testing a token verifier, or any other part of a REST service that authenticates its callers — the…

wntic/pyhouse · plugins/pyhouse-hex/skills/hex-test-restapi-endpoint/SKILL.md · Use when testing one REST endpoint through the real ASGI app — one file per endpoint under…

wntic/pyhouse · plugins/pyhouse-hex/skills/hex-wiring/SKILL.md · Use when adding a binding in `containers.py` — provider classes, binding lifetimes, the `create_container` composition…

wntic/pyhouse · plugins/pyhouse-universal/skills/architecture-choice/SKILL.md · Use when deciding whether a service should be hexagonal or flat-layered — a greenfield service whose family is…

wntic/pyhouse · plugins/pyhouse-universal/skills/at-least-once-delivery/SKILL.md · Use when a program receives units of work another party delivers, and delivers again until they are acknowledged — a…

wntic/pyhouse · plugins/pyhouse-universal/skills/coupling/SKILL.md · Use when asking whether something should be one module or two — splitting a package, extracting a service, merging two…

wntic/pyhouse · plugins/pyhouse-universal/skills/exception-catalog/SKILL.md · Use when adding an error class or reusing one, or translating an SDK or library exception at a boundary. Owns the…

wntic/pyhouse · plugins/pyhouse-universal/skills/meta-skill-author/SKILL.md · Use when creating a skill or reviewing its format. Defines the catalogue frontmatter and its real length limits, the…

wntic/pyhouse · plugins/pyhouse-universal/skills/naming/SKILL.md · Use when deciding what something is called — what should I call this module or class, this name is vague, rename this…

wntic/pyhouse · plugins/pyhouse-universal/skills/persistence/SKILL.md · Use when code reads or writes a datastore, written or reviewed, in any project whatever its architecture — beside the…

wntic/pyhouse · plugins/pyhouse-universal/skills/python-cli/SKILL.md · Use when writing or changing a Python command-line interface — a CLI tool, or a command added to a service of either…

wntic/pyhouse · plugins/pyhouse-universal/skills/python-container-image/SKILL.md · Use when a Python program that ships as a container image gets its image build or changes it — a Dockerfile and its…

wntic/pyhouse · plugins/pyhouse-universal/skills/python-logging/SKILL.md · Use when writing code that reports what it did or what went wrong — a log call, a `print` for progress or errors, an…

wntic/pyhouse · plugins/pyhouse-universal/skills/python-packaging/SKILL.md · Use when the question is the mechanics around a module rather than what it is called — `__init__.py`, `__all__`, a…

wntic/pyhouse · plugins/pyhouse-universal/skills/python-settings/SKILL.md · Use when a program reads configuration from its environment — writing or extending a settings class, deciding whether a…

wntic/pyhouse · plugins/pyhouse-universal/skills/python-style/SKILL.md · Use when choosing a type annotation, deciding what shape a record takes as it crosses a boundary, or asking whether a…

wntic/pyhouse · plugins/pyhouse-universal/skills/python-toolchain/SKILL.md · Use when laying down or changing the configuration every Python distribution carries once in `pyproject.toml` — the src…

wntic/pyhouse · plugins/pyhouse-universal/skills/python-versioning/SKILL.md · Use when deciding what version a Python distribution declares and what changes it — a first release, a breaking change…

wntic/pyhouse · plugins/pyhouse-universal/skills/python-workspace/SKILL.md · Use when several Python distributions live in one repository — creating the workspace root, or admitting a member to…