What is an ADR and how does this skill handle them?

An Architecture Decision Record (ADR) captures a significant design choice and its context. This skill automates ADR creation, ensuring they are sequentially numbered and stored in a standardized format within your project directory.

Why is the Discovery Protocol mandatory?

The Discovery Protocol ensures 100% clarity on project context, requirements, and environment before any architectural decisions are made, preventing costly design errors later.

Does it support analyzing existing codebases?

Yes, it includes 'Brownfield' protocols designed specifically for mapping, analyzing, and proposing refactors for existing software systems.

Can I use this for day-to-day task management?

No, this skill is specifically optimized for high-level system design and architectural analysis. For project planning and task execution management, the 'managing-plans' skill is recommended.

What quality criteria are evaluated?

The skill utilizes a comprehensive quality checklist to evaluate system architecture against industry standards, covering aspects like scalability, maintainability, and security.

System Architecture Designer

Name: System Architecture Designer
Author: Git-Fg

byGit-Fg

•

Herramientas para Desarrolladores

Architects robust software systems using structured discovery protocols, design frameworks, and formal decision records.

The System Architecture Designer skill transforms Claude into a senior architect capable of navigating complex software design challenges for both new and existing systems. It provides a rigorous framework for discovery, system design workflows, and the maintenance of Architecture Decision Records (ADRs) to ensure every technical choice is documented and justified. By applying standardized patterns and quality evaluation checklists, this skill helps developers select the right technology stacks, infrastructure components, and communication protocols while ensuring 100% clarity through a mandatory 'Discovery & Analysis' phase before any implementation begins.

Características Principales

011 GitHub stars

02Comprehensive greenfield system design workflows and technology selection

03Brownfield analysis tools for refactoring and mapping existing codebases

04Automated Architecture Decision Record (ADR) management and versioning

05Deep discovery protocols for mapping requirements and system environments

06Standardized quality evaluation checklists for architectural robustness

Casos de Uso

01Managing a centralized record of infrastructure and technology stack decisions

02Designing a scalable microservices architecture with documented technical trade-offs

03Conducting a deep analysis of an existing codebase to identify architectural debt

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add git-fg/thecattoolkit designing-architecture

For use in Claude.ai and ChatGPT

Download Skill