arquiteto-software

Designs software architecture through explicit trade-offs, ADRs, and C4 diagrams.

1|Updated Jul 7, 2026
One-click install
npx skills add https://github.com/codjeremias-cell/Orquestrador-fable --skill arquiteto-software-codjeremias-cell
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: arquiteto-software
Source: https://github.com/codjeremias-cell/Orquestrador-fable/tree/main/skills/arquiteto-software
Command: npx skills add https://github.com/codjeremias-cell/Orquestrador-fable --skill arquiteto-software-codjeremias-cell

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? It turns vague architecture questions ("should we use microservices?", "how do I organize modules?", "sync or async here?") into structured decisions with explicit trade-offs, preventing over-engineering and undocumented choices that cause rework months later. ## Core Features & Use Cases - Architecture decision-making: Compares 2-3 structural alternatives (layered, hexagonal, modular monolith, microservices, event-driven) against measurable quality attributes, always recommending the simplest viable option. - Decision records and system views: Produces lean ADRs for hard-to-reverse decisions and renders the right view for the problem (C4 structure, workflow, sequence, data flow, or lifecycle). - Module shape and spike design: Applies the deep-module vocabulary (seams, adapters, deletion test) and designs disposable spikes to validate risky technical assumptions before committing. - Use Case: A team asks whether to split their app into microservices. The skill surfaces the real quality drivers, compares a modular monolith against microservices with pros, cons, and operational cost, and records the decision in an ADR with explicit triggers for revisiting it. ## Quick Start Ask the assistant to evaluate whether microservices are worth it for your application and to record the decision as an ADR.

Frequently Asked Questions about arquiteto-software

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

FAQPage Schema
How do I decide between a monolith and microservices?▼

Start by naming the quality attributes that actually hurt today, such as independent deployment or uneven scaling. The default recommendation is a well-organized modular monolith; microservices are only justified when a concrete quality attribute demands them and the team has operational maturity.

When should I write an Architecture Decision Record?▼

Write an ADR when all three criteria hold: the decision is hard to reverse, it would surprise a future reader without context, and it resulted from a genuine trade-off between alternatives. If any criterion is missing, a commit message or glossary entry is enough.

What is the deletion test for module design?▼

Imagine deleting the module: if the complexity disappears, it was just passing calls through; if it reappears across many callers, the module was earning its place. Apply this test to any module suspected of being shallow before keeping or creating it.

How do I validate a risky technical assumption before committing?▼

Design a disposable spike that answers one question, ordered by risk, with a VALIDATED/PARTIAL/INVALIDATED verdict. Spike code is never promoted to production; the validated decision goes into the ADR and production code is rewritten.

When should I not use an architecture review skill?▼

Do not use it for point-level code implementation or debugging, which belongs to a senior developer workflow, or for data schema modeling, which belongs to a data architecture lens. It addresses macro structure, not micro-level code decisions.