pmos-architecture-designer

Translate undefined boundary and integration tradeoffs into architecture-ready designs.

Updated May 9, 2026
One-click install
npx skills add https://github.com/RhyTsui/PMOS --skill pmos-architecture-designer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pmos-architecture-designer
Source: https://github.com/RhyTsui/PMOS/tree/main/skills/pmos-architecture-designer
Command: npx skills add https://github.com/RhyTsui/PMOS --skill pmos-architecture-designer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents expensive, unclear, or implicit architecture choices by forcing architecture prerequisites and boundary decisions to be made before implementation begins.

Core Features & Use Cases

  • Architecture decision scoping: Clarifies what is being decided, what is costly to change later, and which dependencies are external or cross-module.
  • Boundary and ownership design: Makes responsibility ownership, data ownership, and API/event/contract seams explicit, including platform vs subproject placement.
  • ADR-ready tradeoff and readiness: Compares alternatives, records tradeoffs (complexity, operational cost, migration cost, testability, rollback difficulty), and produces an architecture-ready conclusion before builder execution.

Quick Start

Use this skill when you are about to start coding and need to define boundaries, integration seams, and the irreversible technical choices in a way that an implementation handoff can proceed.

Frequently Asked Questions about pmos-architecture-designer

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

FAQPage Schema
How do I define system boundaries and integration seams before implementation?

Defining system boundaries and integration seams requires explicit architecture decisions scoping costly-to-change choices, responsibility ownership, and API/event contracts before builder execution. This ensures implementation handoffs proceed with clear technical prerequisites.

What is architecture decision scoping for module and service splitting?

Architecture decision scoping clarifies what is being decided, identifies costly-to-change dependencies, and makes data ownership and platform versus subproject placement explicit. It translates undefined tradeoffs into architecture-ready designs before coding begins.

How do I create an ADR-ready tradeoff analysis for integration contracts?

ADR-ready tradeoff analysis compares alternatives by recording complexity, operational cost, migration cost, testability, and rollback difficulty. It produces explicit decision statements with chosen and rejected options plus known risks for review points.

When do I need architecture boundary design for platform versus subproject placement?

You need architecture boundary design before coding when facing undefined boundary and integration tradeoffs that are expensive to change later. It forces explicit decisions on platform versus subproject placement, responsibility ownership, and contract seams.

What's the best way to govern pre-implementation architecture decisions and handoffs?

Governing pre-implementation architecture decisions requires satisfying prerequisites for explicit decision statements, context constraints, integration contracts, and follow-up review points. This prevents expensive implicit choices by forcing boundary decisions before implementation begins.

Can I use this approach for service splitting without external dependencies?

Yes, architecture decision scoping applies to module and service splitting by clarifying which dependencies are external or cross-module. It makes responsibility ownership and data ownership explicit regardless of external dependency presence.