architecture

Guide architectural decisions by evaluating trade-offs and documenting rationale.

8|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/gabriellpequeno/Reserva-Aqui---Projeto-de-fim-de-ciclo --skill architecture-gabriellpequeno
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/gabriellpequeno/Reserva-Aqui---Projeto-de-fim-de-ciclo/tree/main/.cursor/skills/architecture
Command: npx skills add https://github.com/gabriellpequeno/Reserva-Aqui---Projeto-de-fim-de-ciclo --skill architecture-gabriellpequeno

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Framework for making architectural decisions that emphasizes simplicity, evaluating trade-offs, and recording the rationale to guide structural changes.

Core Features & Use Cases

  • Lightweight decision flow: understand requirements, list options, compare trade-offs, choose the simplest viable solution, and document the decision.
  • Reusable across projects: applies to backend, frontend, and infrastructure decisions to maintain consistency.
  • Use Case: when redesigning a module or migrating to a new tech, apply the framework to produce a documented decision with rationale.

Quick Start

Apply this framework to guide architectural decisions in your project and document the resulting trade-offs.

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I document architectural decisions and evaluate trade-offs for a system design?

Use a lightweight decision flow to understand requirements, list options, compare trade-offs, choose the simplest viable solution, and document the resulting decision with rationale for traceable system design.

What is the best way to choose the simplest architecture for a platform migration?

Evaluate trade-offs among available options and select the simplest viable solution that meets your context, then document the decision to maintain consistency across backend, frontend, and infrastructure layers.

When do I need a formal framework for making structural changes to software modules?

You need a formal framework when software architecture projects span modules, services, or platform migrations, requiring documented decisions, evaluated trade-offs, and traceable rationale to guide low-risk structural changes.

Can I use this architectural decision-making framework for both frontend and infrastructure projects?

Yes, the framework is reusable across projects and applies to backend, frontend, and infrastructure decisions to maintain consistency by evaluating trade-offs and selecting the simplest viable option that meets the context.

How do I ensure my architectural decisions are auditable and low-risk?

Follow a lightweight decision flow that documents the rationale, evaluates trade-offs, and selects the simplest option that meets the context, providing clear traceability and low-risk guidance for structural changes.

What are the limitations of using a simplicity-focused framework for system design decisions?

A simplicity-focused framework prioritizes the simplest viable option, which may limit advanced or complex architectural patterns. It is designed for low-risk structural changes where traceability and documented rationale matter most.