python-architecture
Creating new Python modules or packages under src/apm_cli/; Refactoring class hierarchies or introducing base classes; Changes that touch 3+ files with shared logic patterns
Works with
Agent Skills format with YAML frontmatter. Claude Code reads it as-is.
--- name: "python-architecture" description: "Creating new Python modules or packages under src/apm_cli/; Refactoring class hierarchies or introducing base classes; Changes that touch 3+ files with shared logic patterns" license: "MIT" --- # Python Architecture Skill [Python architect persona](../../../.apm/agents/python-architect.agent.md) ## When to activate - Creating new Python modules or packages under `src/apm_cli/` - Refactoring class hierarchies or introducing base classes - Changes that touch 3+ files with shared logic patterns - Introducing new design patterns (Strategy, Observer, etc.) - Cross-cutting concerns (logging, auth, error handling) - Performance-sensitive paths (parallel downloads, large manifests) ## Key rules - Follow existing patterns (BaseIntegrator, CommandLogger, AuthResolver) before inventing new ones - Prefer composition over deep inheritance - Push shared logic into base classes, not duplicated across siblings - One canonical owner per decision: route through the existing authority (target_catalog, AuthResolver/host_providers, runtime registry, CommandLogger, CompiledOutputWriter, deployment_ledger, install-outcome, neutral hook IR, BaseIntegrator); extend it, never fork it. Full rule: `.apm/instructions/architecture.instructions.md` - Lock every centralization with a dual guardrail: a regression test plus a static check in `scripts/lint-architecture-boundaries.sh`
More General & Other skills
find-skills
vercel-labs/skills
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
grill-me
mattpocock/skills
A relentless interview to sharpen a plan or design.
grill-with-docs
mattpocock/skills
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
