How does this skill prevent over-engineering?

It enforces a 'Simplicity First' principle, requiring trade-off analysis and proof of necessity before adding complex patterns or infrastructure.

What tools are used for the architecture analysis?

The skill utilizes Read, Glob, and Grep tools to scan project contexts and existing files to inform its architectural recommendations.

What is an ADR in this framework?

An Architecture Decision Record (ADR) is a short text file that captures a specific design decision, the context in which it was made, and the consequences it has for the project.

Is this framework specific to any programming language?

No, it is language-agnostic and focuses on high-level architectural principles applicable to any software development environment.

Can I use this for legacy system refactoring?

Yes, it is highly effective for analyzing existing systems, identifying architectural debt, and documenting the rationale for modernization steps.

System Architecture Framework

Name: System Architecture Framework
Author: claudiodearaujo

byclaudiodearaujo

•

開発者ツール

Facilitates structured architectural decision-making through requirements analysis, trade-off evaluation, and formal ADR documentation.

The System Architecture Framework skill provides a comprehensive methodology for designing robust software systems using Claude Code. It guides users through the entire architectural lifecycle, from initial context discovery and requirement gathering to selecting design patterns and documenting decisions via Architecture Decision Records (ADRs). By emphasizing simplicity and identifying constraints early, this skill helps developers evaluate trade-offs objectively, avoid common anti-patterns, and ensure that system complexity only grows when strictly necessary for project success.

主な機能

01Reference implementations for MVP, SaaS, and Enterprise architectures

02Standardized Architecture Decision Record (ADR) documentation templates

031 GitHub stars

04Requirements analysis and project classification framework

05Structured trade-off evaluation and decision-making tools

06Decision trees for pattern selection and anti-pattern identification

ユースケース

01Performing a validation audit on existing system designs to identify potential bottlenecks

02Designing the initial infrastructure and component layout for a new software project

03Evaluating and documenting the rationale for switching technical stacks or databases

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add claudiodearaujo/sistema-de-narra-o-de-livro architecture

For use in Claude.ai and ChatGPT

Download Skill