android-clean-architecture

Visão geral da skill android-clean-architecture

A skill android-clean-architecture ajuda você a estruturar apps Android e Kotlin Multiplatform com limites claros entre camadas, em vez de deixar tudo virar código de feature improvisado. Ela é mais indicada para quem precisa de um ponto de partida prático de arquitetura para módulos, regras de dependência, UseCases, Repositories e desenho da camada de dados — não de uma explicação teórica genérica.

Para que esta skill serve

Use android-clean-architecture quando você precisa decidir onde cada lógica deve ficar, como os módulos devem depender uns dos outros e como evitar que responsabilidades de UI, domínio e dados acabem misturadas em uma única camada. Ela é especialmente útil ao padronizar uma codebase nova ou refatorar um app em crescimento.

Quem aproveita mais

Esta skill de android-clean-architecture é ideal para times que constroem apps Android, código compartilhado em KMP ou produtos com Compose que já começaram a dar sinais de acoplamento excessivo. Também ajuda bastante quando você está escolhendo entre módulos por feature, módulos em camadas ou uma estrutura mais simples de módulo único com fronteiras bem definidas.

Principais diferenciais

Ao contrário de um prompt vago sobre arquitetura, android-clean-architecture foca em estrutura concreta: organização de módulos, dependências permitidas, posicionamento de repositories e onde encaixar integrações com Room, SQLDelight, Ktor, Koin ou Hilt. Isso a torna mais útil para tomada de decisão quando o objetivo é evitar overengineering ou vazamentos acidentais entre camadas.

Como usar a skill android-clean-architecture

Instale e ative a skill

Use o fluxo de instalação de android-clean-architecture no seu gerenciador de skills, depois abra o arquivo da skill e mantenha-o no contexto enquanto estiver planejando ou ajustando a arquitetura. Se o seu ambiente permitir carregamento por caminho, aponte para skills/android-clean-architecture/SKILL.md para que o modelo siga as regras de arquitetura durante a tarefa.

Dê a ela uma tarefa de arquitetura concreta

O uso de android-clean-architecture funciona melhor quando você pede um resultado específico, como decomposição de módulos, mapeamento de dependências ou definição de qual camada deve receber cada parte. Um bom input informa a plataforma, a stack atual e o conjunto de restrições.

Exemplos de prompt:

• “Design an android-clean-architecture module layout for a Compose + Hilt app with offline sync.”
• “Refactor this KMP feature into android-clean-architecture layers using Room on Android and SQLDelight in shared code.”
• “Review these modules and point out dependency rule violations.”

Leia primeiro as partes certas

Comece por SKILL.md e depois foque nas seções que definem quando ativar a skill, o layout recomendado e as regras de dependência. São essas partes que realmente impactam as decisões de implementação. Se o seu repositório tiver apenas esse arquivo, trate essas seções como fonte de verdade e adapte o conteúdo aos seus próprios nomes de pacote e à sua configuração de build.

Forneça entradas que melhorem a qualidade da saída

Passe para a skill um inventário curto do que já existe: módulos, ferramentas de persistência, framework de DI, stack de rede e se o app é só Android ou KMP. Também diga o que precisa ser preservado, como fronteiras de features já existentes ou APIs públicas. Quanto mais específico for o estado atual do projeto, menor a chance de o guia de android-clean-architecture inventar camadas desnecessárias.

FAQ da skill android-clean-architecture

android-clean-architecture serve só para projetos novos?

Não. A skill android-clean-architecture é útil tanto para projetos greenfield quanto para refatoração. Ela se destaca quando você precisa impor limites a um app existente que ficou confuso com o tempo, porque ajuda a decidir o que mover sem reescrever tudo de uma vez.

Em que isso difere de um prompt normal?

Um prompt comum pode pedir uma arquitetura em camadas, mas android-clean-architecture oferece uma estrutura focada para decisões de Android e KMP. Na prática, isso gera orientações melhores sobre direção das dependências, nomenclatura de módulos e onde colocar código de data source e repository.

É amigável para iniciantes?

Sim, desde que você esteja disposto a trabalhar a partir de um mapa de módulos concreto. Ela é menos adequada se o que você quer é uma explicação de alto nível sobre Clean Architecture sem detalhes de implementação. Iniciantes extraem mais valor quando usam a skill para validar uma estrutura simples e explícita, em vez de algo grande e espalhado.

Quando eu não devo usar?

Não use android-clean-architecture se o seu app for muito pequeno, se o time estiver evitando intencionalmente arquitetura em camadas ou se você só precisar entregar uma feature rapidamente sem trabalho de design modular. Nesses cenários, a skill pode adicionar uma estrutura de que você não precisa.

Como melhorar a skill android-clean-architecture

Diga exatamente qual decisão de arquitetura você precisa tomar

A forma mais rápida de melhorar a saída de android-clean-architecture é pedir uma decisão por vez: limites entre módulos, grafo de dependências, fluxo de dados ou configuração de DI. Se você pedir “best architecture”, o resultado tende a ser menos útil do que algo como “where should caching live in this KMP repository setup?”

Passe para a skill as restrições reais do seu projeto

Mencione a stack e os limites que realmente importam: Android only ou KMP, Compose ou XML, Room ou SQLDelight, Ktor ou Retrofit, Hilt ou Koin, e se offline-first é obrigatório. Esses detalhes mudam a estrutura recomendada e evitam que um guia genérico de android-clean-architecture se ajuste à força ao backend ou ao modelo de armazenamento errado.

Fique atento aos modos de falha mais comuns

O erro mais comum é deixar cada feature criar sua própria miniarquitetura sem regras compartilhadas. Outro é colocar lógica de negócio no código de apresentação só porque isso parece mais rápido naquele momento. Use a skill para checar esses limites cedo e depois revise o resultado com a árvore real de pacotes e os arquivos de build do seu projeto.

Faça uma segunda rodada com um pedido baseado no seu repositório

Depois da primeira saída, peça uma auditoria de dependências ou um plano de posicionamento arquivo por arquivo com base na árvore atual do projeto. Por exemplo: “Map these existing packages to the android-clean-architecture layout and flag anything that should move to domain or data.” Esse tipo de continuação transforma a skill de um guia conceitual em uma ferramenta de migração.