omaromar9091/skill-arquitetura-limpa

O que skill-arquitetura-limpa faz?

Uma skill calibrada do Claude para Arquitetura Limpa, SOLID e desacoplamento de componentes — dimensionada para o tamanho da tarefa, com exemplos reais de código em várias linguagens e honesta sobre os compromissos que frameworks reais impõem.

Visão Geral

Esta skill ajuda você a projetar e revisar arquiteturas de software seguindo os princípios da Arquitetura Limpa (Clean Architecture), SOLID e desacoplamento de componentes. Ela se adapta automaticamente ao contexto da tarefa, desde uma pequena refatoração de método até a definição de módulos e camadas de um sistema completo.

Princípios Suportados

• Arquitetura Limpa: Separação de camadas (entidades, casos de uso, adaptadores de interface, frameworks e drivers).
• SOLID: Responsabilidade única, aberto/fechado, substituição de Liskov, segregação de interfaces e inversão de dependência.
• Desacoplamento de Componentes: Uso de injeção de dependência, interfaces e padrões de repositório para isolar domínios.
• Honestidade Técnica: Reconhecimento explícito de que frameworks impõem compromissos (como acoplamento em tempo de execução, configurações complexas e vazamento de abstrações).

Plataformas

• Claude Code
• Cursor
• Codex
• Outros assistentes de IA que suportam skills no formato SKILL.md

Como Usar

1. Adicione esta skill ao seu projeto criando um arquivo SKILL.md na raiz ou no diretório .claude/.
2. Ao solicitar ajuda, descreva o tamanho da tarefa (pequena, média, grande) e o contexto do framework (se houver).
3. A skill responderá com:
   • Análise de conformidade com Clean Architecture e SOLID.
   • Sugestões de refatoração com exemplos de código (Java, C#, Python, TypeScript).
   • Discussão honesta sobre trade-offs e compromissos.

Exemplo de Uso

Usuário: "Tenho uma classe UserService muito grande. Como aplicar Clean Architecture para separar responsabilidades?"
Claude: "Vamos analisar. Com Clean Architecture, você pode separar em camadas:
- Entidade: User
- Caso de Uso: CreateUserUseCase
- Adaptador: UserRepository (interface)
- Framework: UserJpaRepository (implementação com JPA/Hibernate)
Aqui está um exemplo em TypeScript..."

Contribuições

Sinta-se à vontade para abrir issues ou pull requests no repositório original: omaromar9091/clean-architecture-skill.

Licença

Este projeto está licenciado sob a licença MIT. Consulte o arquivo LICENSE para obter detalhes.