python:architecture

Design Python applications with functional core and imperative shell architecture.

39|4|Updated Jan 11, 2026
One-click install
npx skills add https://github.com/martinffx/claude-code-atelier --skill python-architecture-martinffx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python:architecture
Source: https://github.com/martinffx/claude-code-atelier/tree/main/plugins/atelier-python/skills/atelier-python-architecture
Command: npx skills add https://github.com/martinffx/claude-code-atelier --skill python-architecture-martinffx

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Python architecture guidance focuses on cleanly separating pure business logic from IO using the functional core / imperative shell pattern, combined with Domain-Driven Design and typed data modeling to improve testability and maintainability.

Core Features & Use Cases

  • Functional core / imperative shell: isolates business logic from side effects, enabling deterministic testing.
  • Domain-Driven Design (DDD): defines bounded contexts and explicit domain models with transformations.
  • Layered architecture guidance: outlines Entities, Repositories, Services, and Adapters to connect to external systems.
  • Use Case: architect a new service with clear domain boundaries, a persistence strategy, and integration points for external systems.

Quick Start

Outline a Python project structure following the functional core / imperative shell pattern with domain models and adapters.

Frequently Asked Questions about python:architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I separate business logic from side effects in Python?

Use the functional core / imperative shell pattern to separate business logic from side effects in Python, isolating pure domain rules from IO operations to enable deterministic testing and maintainable architectures.

What is the functional core and imperative shell pattern in Python architecture?

The functional core and imperative shell pattern in Python architecture isolates pure business logic in a functional core, while the imperative shell handles side effects and IO, ensuring scalable and maintainable domain models.

How do I structure a Python service using Domain-Driven Design?

Structure a Python service using Domain-Driven Design by defining bounded contexts, explicit domain models, and modular layers including Entities, Repositories, Services, and Adapters for external system integration.

When should I use clean architecture in my Python applications?

Use clean architecture in Python applications when you need scalable and maintainable systems with clear domain boundaries, a defined persistence strategy, and explicit data transformations across bounded contexts.

Does this Python architecture approach require specific frameworks or dependencies?

This Python architecture approach requires no specific frameworks or dependencies, relying instead on typed data models and standard design patterns to structure layers and enforce explicit data transformations.