architecting-python

Generate Architecture Decision Records for Python architecture decisions.

1|Updated Jan 6, 2026
One-click install
npx skills add https://github.com/simonheimlicher/spx-claude --skill architecting-python
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecting-python
Source: https://github.com/simonheimlicher/spx-claude/tree/main/plugins/python/skills/architecting-python
Command: npx skills add https://github.com/simonheimlicher/spx-claude --skill architecting-python

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This ADR skill helps teams capture Python architecture decisions as Architecture Decision Records, ensuring consistent documentation and traceability across projects.

Core Features & Use Cases

  • Create ADRs that constrain architecture choices and testing strategies.
  • Reference architecture patterns, design guidelines, and type-safety principles.
  • Use during major architecture decisions to align teams on boundaries and testing expectations.

Quick Start

To begin, invoke the architecting-python skill to generate an ADR outline for a proposed Python architecture decision, then fill in the specifics in the ADR document.

Frequently Asked Questions about architecting-python

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

FAQPage Schema
How do I document Python architecture decisions for my project?

This skill generates Architecture Decision Records that constrain Python architecture choices, ensuring consistent documentation with sections for Context, Decision, Consequences, and Testing Strategy.

What is an ADR and when do I need one for Python architecture?

An Architecture Decision Record captures key architectural choices and context. You need one when making major Python architecture decisions involving testing strategies, dependency injection, or design patterns to ensure traceability and team alignment.

How do I create an ADR for a Python dependency injection pattern?

Invoke the architecting-python skill to generate an ADR outline for your proposed dependency injection pattern, then fill in the specifics within the generated document to constrain your architecture choices and testing expectations.

Can I use this to define testing strategies within Python architecture decisions?

Yes, this skill enforces a dedicated Testing Strategy section within every Architecture Decision Record, allowing you to align teams on testing expectations and constrain testing approaches alongside pattern choices and type-safety principles.

Does this skill work with existing project ADR templates?

Yes, it enforces adherence to your project's existing ADR templates and architecture principles while structuring records with Title, Status, Context, Decision, Consequences, Compliance, and Testing Strategy sections.

What are the limitations of automating ADR creation for Python projects?

This skill generates ADR outlines and enforces structural consistency, but you must manually fill in the specific architectural context, technical decision details, and compliance requirements relevant to your actual Python project.