O Ecossistema de Arquitetura e Qualidade

Este repositório contém um conjunto de Skills e Workflows projetados para automatizar a criação e a refatoração de projetos de software, garantindo alto padrão arquitetural (Clean Architecture ou Hexagonal) e aderência estrita aos princípios S.O.L.I.D.

O ecossistema atua como uma Fábrica de Software orientada a LLMs, onde cada "Skill" atua como um especialista focado em uma etapa do ciclo de vida do desenvolvimento.

As ferramentas estão divididas em duas grandes frentes:

---

🏗️ Pasta CRIAÇÃO (Para Novos Projetos)

Utilizada quando você vai criar um projeto do zero absoluto. A premissa aqui é: "Idealizar -> Estruturar -> Construir com SOLID".

Como usar:

Abra um repositório vazio e acione um dos workflows de orquestração:

• create-hexagonal-app (Para criar no padrão Portas e Adaptadores).
• create-clean-app (Para criar no padrão de Camadas do Uncle Bob).

As Skills da Fábrica de Criação:

1. project-blueprint-generator (O Analista): Conversa com você para extrair requisitos. Gera o arquivo BLUEPRINT.md catalogando as Entidades, Casos de Uso e Integrações do seu futuro sistema. Não escreve código, apenas planeja o negócio.
2. hexagonal-architecture-builder (O Arquiteto Hex.): Lê o BLUEPRINT.md e gera as pastas e interfaces vazias nos lugares certos da Arquitetura Hexagonal (core, adapters, ports).
3. clean-architecture-builder (O Arquiteto Clean): Lê o BLUEPRINT.md e gera as pastas garantindo a Regra de Dependência em 4 camadas (entities, use-cases, interface-adapters, frameworks).
4. solid-driven-coder (O Engenheiro): Invocado pelo workflow para preencher as interfaces vazias e os stubs gerados pelo Arquiteto. Ele escreve o código real focando em não violar o S.O.L.I.D. (Injeção de dependência via construtor, SRP, etc).

---

🛠️ Pasta REFATORAÇÃO (Para Projetos Existentes)

Utilizada quando você herda um projeto, ou quer melhorar a estrutura de um app legado (como o Zapsuite, por exemplo). A premissa aqui é: "Analisar Reversa -> Planejar Migração -> Executar com SOLID".

Como usar:

Abra o projeto que precisa de melhorias e acione um dos workflows:

• refactor-to-hexagonal
• refactor-to-clean

As Skills da Fábrica de Refatoração:

1. project-taxonomy-generator (O Patologista): Vasculha o código atual (bom ou ruim) e gera o arquivo ENTITY.md, catalogando onde estão as coisas hoje.
2. hexagonal-architecture-architect / clean-architecture-architect (Os Arquitetos): Lêem o ENTITY.md gerado pela Taxonomia e desenham o roteiro de fuga: O MIGRATION_PLAN.md. Eles ditam "mova o arquivo X para a pasta Y e crie a interface Z".
3. solid-principles (O Auditor de Qualidade): Aplicado pelo workflow na hora de mover o código antigo para a nova pasta de "Core/Domínio". Ele paralisa a migração caso encontre funções "faz-tudo" (God Classes) ou acoplamento forte (ex: queries SQL no meio da regra de negócio), forçando a refatoração do código para que não sujem a nova arquitetura limpa.

---

Por que essa separação é poderosa?

Porque ela impede que a IA faça confusão. Quando você pede "crie um app", um prompt único da IA tenta desenhar o banco, a arquitetura, o frontend e as regras de negócio ao mesmo tempo, gerando código acoplado e de baixa qualidade.

Aqui, quebramos o problema. O Analista documenta. O Arquiteto estrutura as pastas. E o Coder foca apenas em colocar lógica limpa dentro de pequenas caixinhas (arquivos) pré-definidas.