high-level-architecture

Translate product requirements and technical constraints into a system architecture registry.

Updated Feb 6, 2026
One-click install
npx skills add https://github.com/wtah/spec-master --skill high-level-architecture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: high-level-architecture
Source: https://github.com/wtah/spec-master/tree/main/.claude/skills/high-level-architecture
Command: npx skills add https://github.com/wtah/spec-master --skill high-level-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill defines how the high-level architect processes product requirements and technical constraints into a distributed set of responsibilities across containers. The architect maintains .arch-registry/ as the central source of truth and coordinates work across all downstream agents.

Core Features & Use Cases

  • Defines container boundaries
  • Assigns responsibilities to containers
  • Maps requirements to the architecture registry
  • Maintains central registry as truth source
  • Supports greenfield and brownfield architecture governance

Quick Start

  1. Review .product/ inputs (SUMMARY.md, REQUIREMENTS.md, USER_JOURNEYS.md, AI_CAPABILITIES.md) and the constraints directories.
  2. Initialize the .arch-registry structure and create a system.md document to capture the System Context.
  3. Define containers and interfaces, then populate the deployment placeholders and update the registry index.

Frequently Asked Questions about high-level-architecture

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

FAQPage Schema
How do I define container boundaries for a new software architecture?

Defining container boundaries involves translating product requirements and technical constraints into a coherent system architecture. This process assigns specific responsibilities to each container and maps them to concrete interfaces and deployment considerations within a central architecture registry.

What is an architecture registry and how does it maintain system context?

An architecture registry is a central source of truth that captures system context and container responsibilities. Maintained as a structured directory, it coordinates downstream agents by documenting assigned responsibilities, interfaces, and deployment mappings for both greenfield and brownfield projects.

How do I map product requirements to containers in a brownfield system?

Mapping product requirements to containers in a brownfield system uses the architecture registry to govern new feature requests. It assigns responsibilities from the updated requirements to existing containers, ensuring interfaces and deployment constraints remain coherent across the distributed system.

Can I use this architecture approach for both greenfield and brownfield projects?

Yes, this architectural approach supports both greenfield initialization and brownfield feature requests. For greenfield systems it establishes the initial registry and container boundaries, while for brownfield systems it governs new features by updating existing responsibilities and interfaces.

What inputs are needed to initialize a system context and container architecture?

Initializing a system context requires reviewing product inputs like summaries, requirements, user journeys, and AI capabilities alongside technical constraints. These inputs are translated into a system document and container definitions within the architecture registry to establish the foundational architecture.