Skip to content
cccskills
Official · MicrosoftFreePublished on GitHub

python-architecture

Guide Python module additions and refactoring in APM CLI. Uses existing architecture patterns to organize shared logic and decision ownership, with regression tests and static checks to protect changes that centralize behavior.

OriginalShow the original description

Activate when creating new modules, refactoring class hierarchies, introducing design patterns, or making changes spanning 3+ files in the APM CLI codebase.

microsoft/apm
See how to install

Good for

  • Designing new Python modules
  • Refactoring class hierarchies
  • Consolidating logic shared across files
  • Reviewing logging and authentication responsibilities

Files included (1)

  • SKILL.md1.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Python Architecture Skill

Python architect persona

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

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

apm-spec-guardian

Official · MicrosoftFreeSummary

Review OpenAPM specification changes through four specialist perspectives covering schemas, registries, dependency resolution, and web architecture. The skill combines findings and mechanical checks into one advisory comment, separating immediate fixes from work deferred to later versions.

  • Reviewing OpenAPM specification changes
  • Checking JSON Schemas and conformance fixtures
  • Separating immediate fixes from future version work
microsoft/apm4.1KUpdated Oct 21, 2026

apm-strategy

Official · MicrosoftFreeSummary

Review APM positioning, public documentation, release communication, and breaking-change decisions using GitHub evidence. Check that incompatible changes include changelog entries and migration notes, and resolve disagreements among the project's specialist reviewers.

  • Reviewing project positioning in public documents
  • Checking changelogs and release communication
  • Confirming migration guidance for breaking changes
microsoft/apm4.1KUpdated Oct 21, 2026

apm-usage

Official · MicrosoftFreeSummary

Get guidance on using APM, a package manager for AI agents, to install and share reusable instructions, skills, and server configurations. Covers dependencies, package creation, authentication, policy checks, CLI commands, and troubleshooting.

  • Install and restore AI-agent packages
  • Configure MCP and LSP servers
  • Create and share APM packages
microsoft/apm4.1KUpdated Oct 21, 2026

auth

Official · MicrosoftFreeSummary

Guide authentication changes in APM CLI for GitHub and Azure DevOps. Centralizes credential lookup through AuthResolver and explains token precedence, Azure CLI fallback, Git credential helper retries, and error messages for failed authentication.

  • Updating token lookup and precedence
  • Fixing authentication during Git operations
  • Reviewing Azure DevOps fallback behavior
microsoft/apm4.1KUpdated Oct 21, 2026

autopilot-comment

Official · MicrosoftFreeSummary

Post or update one GitHub comment for an APM autopilot run. The skill assembles public or debug content, adds an AI-generated disclaimer, and supports previewing the assembled comment before posting.

  • Post an autopilot result to an Issue
  • Update an existing pull request comment
  • Preview a comment before posting
microsoft/apm4.1KUpdated Oct 21, 2026

autopilot-issue-delivery-scheduler

Official · MicrosoftFreeSummary

Build an implementation queue from accepted GitHub issues and distribute them to dedicated workers. Record selection reasons, check for existing pull requests, and process the full queue with a configurable concurrency limit, defaulting to two workers.

  • Queue accepted issues for implementation
  • Limit concurrent issue delivery workers
  • Record why issues were included or skipped
microsoft/apm4.1KUpdated Oct 21, 2026

See all skills by microsoft

Report a problem with this skill