forze 0.1.14

Domain-Driven Design and Hexagonal Architecture for backend services

Forze

Forze is a lightweight infrastructure toolkit for building backend services with Domain-Driven Design and Hexagonal Architecture.

It provides a set of reusable primitives, contracts, and structural patterns that help organize backend applications into clear, maintainable layers.

Design Goals

Forze aims to support backend systems that are:

• Layered — clear separation between domain, application, and infrastructure
• Explicit — well-defined ports, adapters, and boundaries
• Testable — components can be tested in isolation
• Composable — infrastructure pieces can be replaced or extended
• Framework-agnostic — the core does not depend on a specific framework

The library focuses on providing structure and contracts, not a full-stack framework.

Quick Start

Install the core package:

uv add forze

Install with optional integrations:

uv add 'forze[fastapi,postgres,socketio]'

Documentation

Full documentation is available at https://morzecrew.github.io/forze/.

Agent Skills

Forze ships with AI agent skills that help assistants understand the framework's architecture, patterns, and conventions. Install them to improve code generation and refactoring when working with Forze.

Skills follow the Agent Skills format.

Installation

# Install all skills
npx skills add morzecrew/forze

# Install a specific skill
npx skills add morzecrew/forze@forze-wiring

Usage

Skills are automatically available once installed. The agent will use them when relevant tasks are detected.

Available Skills

Name	Description
forze-framework-usage	Write code that uses the framework correctly according to the core concepts.
forze-domain-aggregates	Define domain models, document aggregates, and specifications.
forze-wiring	Wire runtime, dependencies, lifecycle, usecase composition, and interface layer.

Versioning

Forze follows Semantic Versioning (SemVer). Pre-release builds may include experimental APIs and are not guaranteed to be stable.

Contributing

Contributions, issues, and feature requests are welcome. See CONTRIBUTING.md for details.

Security

Please report security vulnerabilities privately as described in SECURITY.md.

License

Forze is licensed under the MIT License - see LICENSE for details.