forze-skills
Forze
Forze is a Python framework for Domain-Driven Design and Hexagonal Architecture in backend
services. This skill is a routing index: the reference files under references/ hold the actual
material, and you read the ones a task needs.
The mental model, in four sentences
Your application declares logical specs — a DocumentSpec, a QueueSpec, a StorageSpec —
that name a resource without naming any physical thing. Deps modules map those names to real
backends (a Postgres table, an SQS queue, an S3 bucket) at wiring time. Handlers receive an
ExecutionContext and reach infrastructure only through ports resolved from it. The runtime
composes the registries, freezes them, and runs operations through the pipeline.
Everything else is a consequence of that split. If a handler mentions a table name, a bucket, or an adapter import, something has gone wrong — and most anti-patterns in these references are a version of that one mistake.