fixkitty

Criando perfil de ambiente Linux/desktop (EnvironmentProfile) para nova distro ou DE. Use para adicionar suporte a Ubuntu 24, Fedora, Mint, KDE etc. Não use para criar ações de recovery (use create-recovery-action) nem para orquestrar execução (use create-use-case).

Criando ação de recuperação de subsistema Linux (audio, network, bluetooth, GNOME). Use para adicionar nova ação de fix, definir seus passos e registrá-la no profile de ambiente. Não use para criar o Use Case que orquestra a ação (use create-use-case) nem para criar um novo profile de distro (use create-environment-profile).

Criando componente de UI (Controller JavaFX ou componente TUI). Use para adicionar tela, botão, painel ou view de log na GUI ou TUI. Não use para criar lógica de negócio (use create-use-case) nem para definir ação de recovery (use create-recovery-action).

Criando Use Case na camada application para orquestrar ações de recovery. Use para criar novo orquestrador de execução, coordenar RecoveryActions e portas de infraestrutura. Não use para criar a ação em si (use create-recovery-action) nem para componente de UI (use create-ui-component).

Constraint-skill: valida fronteiras de Clean Architecture no fixkitty. Use SEMPRE como último passo ao criar ou alterar qualquer artefato, por camada ou por feature. Detecta importações proibidas, responsabilidades vazadas e acoplamentos indevidos. Não gera código — apenas valida.

Meta-skill para implementar uma feature ponta a ponta sem acoplar camadas. Use quando a tarefa exigir atravessar domain, application, infrastructure e interfaces em sequência controlada. Não use para mudanças isoladas a uma única camada — use a skill de camada correspondente diretamente.

Orquestrando a camada application. Use quando criar ou alterar use cases, fluxos de execução, políticas de orquestração e coordenação entre domain e ports. Não use para modelagem pura de domínio (use layer-domain), adapters concretos (use layer-infrastructure) ou telas (use layer-interface).

Modelando a camada domain/core. Use quando criar ou alterar entidades, value objects, enums, resultados de execução ou ports centrais do problema. Não use para orquestração de use cases (use layer-application), adapters concretos (use layer-infrastructure) ou componentes de UI (use layer-interface).

Implementando a camada infrastructure. Use para implementar ports, integrar com Linux real, definir profiles por distro, command runners, privilege strategies e logging. Não use para regra de negócio (use layer-application) nem para controllers (use layer-interface).

Construindo a camada interfaces. Use para criar ou alterar GUI JavaFX, TUI textual ou bootstrap de entrada. Não use para regra de negócio (use layer-application), adapters (use layer-infrastructure) ou modelagem de domínio (use layer-domain).

Escrevendo testes para o ciclo de desenvolvimento. Use para cobrir domain, application e adapters com JUnit 5 e Mockito, definindo estratégia por camada. Não use para testar GUI/TUI diretamente (prefira write-unit-test para application/domain) nem para empurrar shell real para a suíte.

Escrevendo testes unitários para Use Cases e Domain. Use para testar orquestração de recovery, comportamento de RecoveryResult e mocks de PrivilegeManager e CommandRunner. Não use para testar GUI/TUI (headless JavaFX) nem para testes de integração com shell real.