🏗️ Core Philosophy: Architectural integrity enables evolutionary change.
When to use
Use this skill when designing components, establishing boundaries between system layers, selecting structural design patterns, or defining dependency graphs for Web and iOS systems.
When not to use
Do not use this skill for raw code optimization, writing inline tests, or styling UI elements.
Trigger cues
- Key terms: clean architecture, MVVM, modularity, layers, Swift Package Manager, monorepo, ports and adapters, hexagonal architecture, domain-driven design, dependencies.
- Requesting structural patterns, directory setups, or module boundaries.
Routing boundary
- Primary for design patterns, high-level code layout, structural boundaries, and decoupling.
- Secondary to
developer-development-rules for low-level clean code rules.
Inputs required
- Target platform constraints (iOS vs Web)
- High-level business context and scalability requirements
- Source of truth:
references/source.md
Instructions
- Detect Stack: Inspect the workspace files to identify the project's existing technology stack (e.g., Next.js, React, Express, Swift).
- Do Not Migrate: Never propose or force a technology stack change. Apply the principles in this skill using the project's current tooling.
- Read references/source.md to align on first-principles system design.
- Draft an architecture diagram or dependency topology matching the target constraints using the existing stack.
- Formulate the boundary interfaces and data transfer protocols before implementation.
- Record major architectural tradeoffs in an Architecture Decision Record (ADR) format.
Output format
- Primary decision/output: System component diagram, dependency flow, and boundary definitions.
- Summary: One-paragraph architectural summary.
- Actions: Verification checklist for design constraints.
1---2name: system-architecture-rules3description: Trigger: clean architecture, hexagonal architecture, domain model, state machine, boundary decoupling. Scope: Software modular design, dependency boundaries, architectural layering. Boundary: Excludes frontend aesthetic styling.4---56# 🏗️ Core Philosophy: Architectural integrity enables evolutionary change.78## When to use910Use this skill when designing components, establishing boundaries between system layers, selecting structural design patterns, or defining dependency graphs for Web and iOS systems.1112## When not to use1314Do not use this skill for raw code optimization, writing inline tests, or styling UI elements.1516## Trigger cues1718- Key terms: clean architecture, MVVM, modularity, layers, Swift Package Manager, monorepo, ports and adapters, hexagonal architecture, domain-driven design, dependencies.19- Requesting structural patterns, directory setups, or module boundaries.2021## Routing boundary2223- Primary for design patterns, high-level code layout, structural boundaries, and decoupling.24- Secondary to `developer-development-rules` for low-level clean code rules.2526## Inputs required2728- Target platform constraints (iOS vs Web)29- High-level business context and scalability requirements30- Source of truth: `references/source.md`3132## Instructions33341. **Detect Stack**: Inspect the workspace files to identify the project's existing technology stack (e.g., Next.js, React, Express, Swift).352. **Do Not Migrate**: Never propose or force a technology stack change. Apply the principles in this skill using the project's current tooling.363. Read [references/source.md](references/source.md) to align on first-principles system design.374. Draft an architecture diagram or dependency topology matching the target constraints using the existing stack.385. Formulate the boundary interfaces and data transfer protocols before implementation.396. Record major architectural tradeoffs in an Architecture Decision Record (ADR) format.4041## Output format4243- Primary decision/output: System component diagram, dependency flow, and boundary definitions.44- Summary: One-paragraph architectural summary.45- Actions: Verification checklist for design constraints.
coreyone