reviewing-python-architecture

Assess ADRs against testing principles and flag violations with corrective guidance.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps reviewers assess ADRs against testing principles, surfacing violations and guiding corrective design before decisions are final.

Core Features & Use Cases

  • Automates ADR evaluation against the /testing principles to identify violations and reference the exact principle.
  • Provides recommended architectural corrections and concrete examples that align with testing guidance.
  • Ideal for architecture reviews, design sign-off, and governance where ADRs must reflect robust testing practices.

Quick Start

  1. Read the ADR document and compare it against the /testing methodology (Five Factors, Levels, Cardinal Rules).
  2. Identify violations of the established principles and reference the specific principle.
  3. Output a decision (APPROVED or REJECTED) with a concise list of violations and a corrected architectural approach, including code examples where applicable.

Frequently Asked Questions about reviewing-python-architecture

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

FAQPage Schema
How do I review ADRs against software testing principles?

Evaluate ADRs against the /testing methodology by identifying practices that diverge from the Five Factors, Levels, and Cardinal Rules, then output an APPROVED or REJECTED decision with cited principle violations and concrete remediation steps.

What are the Five Factors in software testing architecture?

The Five Factors are core principles within the /testing framework used to evaluate ADRs. They serve as the baseline to identify architectural violations and ensure your design aligns with robust testing practices before final sign-off.

How do I assess if an architecture decision violates testing rules?

Assess architecture decisions by comparing them against the established /testing framework. The process flags exact violations of Cardinal Rules and Five Factors, providing a corrected architectural approach with code examples.

Can I get code examples for correcting architecture testing violations?

Yes, when an ADR is rejected for testing principle violations, the evaluation outputs structured guidance including concrete remediation steps and example code that aligns the architecture with the corrective design.

When do I need to audit architecture decisions for testing compliance?

You need to audit architecture decisions during architecture reviews, design sign-off, and governance processes. This ensures ADRs reflect robust testing practices and catches divergences before the architecture decisions are final.