python-architect

Enforce Python 3.14 standards for typing, DI, async, pytest 9, and SQL resources.

3|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/ralvarezdev/ralvaskills --skill python-architect-ralvarezdev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python-architect
Source: https://github.com/ralvarezdev/ralvaskills/tree/main/skills/languages/python-architect
Command: npx skills add https://github.com/ralvarezdev/ralvaskills --skill python-architect-ralvarezdev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

Python projects often drift from consistent typing, immutability, DI, async discipline, and SQL resource handling. This skill defines enterprise-grade Python standards to keep code maintainable, scalable, and auditable across teams.

Core Features & Use Cases

  • Modern typing: use PEP 649 style annotations, immutable dataclasses, and Protocol-based DI.
  • Async discipline & testing: embrace asyncio patterns and pytest 9 for reliable async tests.
  • SQL resource pattern: use importlib.resources to embed and access .sql files with psycopg for database access.

Quick Start

Apply the python-architect standards to your Python project by aligning typing, dataclass patterns, DI via Protocols, asyncio discipline, pytest 9 testing, and importlib.resources for SQL assets.

Frequently Asked Questions about python-architect

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

FAQPage Schema
How do I enforce enterprise Python standards for typing and immutability across my codebase?

Enterprise Python standards are enforced by applying PEP 649 typing annotations, frozen dataclasses with slots, and Protocol-based dependency injection to keep code maintainable, scalable, and auditable across teams.

What is the best way to load SQL files with psycopg without using an ORM?

Load SQL files without an ORM by using importlib.resources to embed and access .sql assets directly, pairing it with psycopg for database access to maintain strict control over SQL execution.

How do I structure asyncio workflows and pytest 9 for reliable asynchronous testing?

Structure reliable asynchronous testing by embracing asyncio discipline patterns alongside pytest 9, ensuring async workflows are properly validated and executed without race conditions or blocking calls.

Does this Python 3.14 approach support Protocol-based dependency injection?

Yes, this Python 3.14 approach fully supports Protocol-based dependency injection, allowing teams to define interfaces structurally and inject dependencies without requiring concrete class inheritance or external frameworks.

Why use frozen dataclasses and modern typing in a scalable Python project?

Frozen dataclasses and modern typing enforce immutability and strict type safety, preventing accidental state mutation and ensuring data structures remain predictable and auditable across large enterprise teams.