Communitygithub.com

perhapsspy/design-adequado-ao-proposito

Skill de agente para verificar se um direcionamento inicial de design se adequa ao propósito do usuário/domínio antes da implementação.

O que é design-adequado-ao-proposito?

Esta skill capacita o agente a realizar uma verificação estruturada de adequação ao propósito (Purpose-Fit Check) antes de qualquer planejamento ou codificação. Ela é útil para evitar que a implementação existente, comportamento copiado ou lógica de fallback sejam tratados como autoridade de design padrão, garantindo que o design atenda diretamente ao resultado desejado pelo usuário e ao sucesso observável. A skill suporta qualquer plataforma de agente que use um formato Markdown estruturado, como Claude Code ou Cursor, e fornece um roteiro claro: começa definindo propósito e sucesso, restrições e evidências; em seguida, avalia riscos de adequação, direciona ou encaminha para um workflow especialista; e termina com uma verificação mínima que pode falsificar o direcionamento. Ela também inclui regras para lidar com restrições explícitas do usuário, fallback de camadas inferiores e urgência, além de roteamento para workflows especializados (descoberta de proprietário de fonte, design de fronteira semântica, planejamento de mudança estrutural ou análise de fluxo interativo). O resultado é uma decisão de design mais focada, evitando retrabalho e garantindo que cada mudança sirva ao propósito definido.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add perhapsspy/purpose-fit-design

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Design Adequado ao Propósito

Função

Verificar se um direcionamento inicial de design se adequa ao propósito do usuário/domínio antes do planejamento ou codificação começar. Trate a implementação existente, comportamento copiado e lógica de fallback/padrão como evidência a ser avaliada, não como autoridade de design padrão.

Termine seguindo de forma restrita, perguntando ou investigando um fato bloqueador, ou encaminhando para um workflow especialista.

Não prove propriedade de fonte, atribua proprietários semânticos ou molde código aqui quando um gatilho especialista já estiver claro.

Verificação de Adequação

Responda apenas o que afeta a decisão. Para tarefas pequenas, um parágrafo compacto é suficiente.

  1. Propósito e sucesso: declare o resultado do usuário/domínio e a menor condição de sucesso observável.
  2. Restrições: nomeie correções explícitas do usuário, conceitos rejeitados ou regras "não adicione X".
  3. Evidência: classifique a implementação atual ou precedente como proprietário da fonte, chamador derivado, legado/compatibilidade, candidato a evidência ou desconhecido.
  4. Risco de adequação: nomeie o caminho de reúso, fallback, esquema, adaptador, atalho ou "copiar agora, limpar depois" que pode desviar o design do propósito.
  5. Direcionamento ou encaminhamento: declare o direcionamento restrito de adequação ao propósito, ou nomeie um workflow especialista.
  6. Verificação: nomeie a menor verificação que poderia falsificar o direcionamento escolhido.

Se propósito, restrições, status de evidência ou condição de sucesso forem desconhecidos e afetarem o design, investigue ou faça uma pergunta focada. Não preencha a lacuna com a forma da implementação atual.

Trate correções explícitas do usuário como restrições rígidas. Não reintroduza um campo, status, padrão de UI, esquema, timeout, política ou fallback rejeitado sob outro nome de camada, a menos que o usuário peça para revisitar.

Trate o fallback de camada inferior como uma decisão potencial de design quando puder afetar significado do comando, estado visível, repetições, auditoria, persistência, testes, política ou outro chamador. Se recriar uma restrição rejeitada ou não tiver um proprietário para comportamento que afeta significado, pare e encaminhe para um workflow de fronteira semântica.

Para cadeias de fallback que calculam identidade de domínio/status em rota, UI, adaptador, tempo real ou código de apresentação, não trate o problema apenas como controle de escopo. Se nenhum proprietário atual for nomeado, encaminhe para descoberta de proprietário da fonte ou fronteira semântica antes de planejar edições.

Um watchdog de transporte ou guarda de infraestrutura pode prosseguir sem trabalho de fronteira semântica quando for de propriedade da camada de transporte/infra, limitado a vitalidade ou proteção de recursos, não introduzir campo/status/política/padrão de domínio, não alterar estado visível aceito pelo usuário e não puder se tornar significado de negócio para chamadores.

Urgência não é evidência de adequação. Quando o usuário pedir um atalho, ofereça a menor fatia que preserve propósito, restrições e limites de proprietário agora. Não apresente "copiar agora, limpar depois" como estratégia de design. Uma implementação temporária ainda precisa de um adaptador, wrapper ou limite de reversão explícito antes do código começar.

Roteamento Especialista

Pule esta skill e use um workflow especialista diretamente quando seu gatilho já estiver claro. Caso contrário, após esta verificação:

  • Use descoberta de proprietário da fonte quando a fonte da verdade não estiver comprovada.
  • Use design de fronteira semântica quando um significado pode derivar entre camadas.
  • Use planejamento de limite de mudança focado em estrutura quando opções, campos, abstrações ou acompanhamentos podem se expandir, ou após o proprietário/direcionamento de design estar definido e a forma do código ser o próximo problema.
  • Use análise de fluxo de estado interativo quando intenção do usuário, apresentação, trabalho assíncrono ou atualização podem se misturar.

Bandeiras Vermelhas

  • "Este componente já existe, então reutilize-o" sem verificar a adequação ao propósito atual.
  • "Segurança/consistência sugere adicionar um esquema/catálogo/timeout" sem meta do usuário ou evidência de proprietário.
  • Reintroduzir um campo, status, padrão de UI, esquema, timeout, política ou fallback rejeitado como detalhe de implementação de nível inferior.
  • Aceitar "copiar agora, limpar depois" quando a superfície copiada possui estado, layout, política ou ciclo de vida de outro domínio.
  • Código de UI, rota, adaptador ou tempo real decidindo significado de domínio através de cadeias de fallback x || y || z.
  • Testes provando internos de auxiliares enquanto o comportamento de limite do chamador permanece desprotegido.
  • Uma explicação de design que descreve principalmente por que a implementação atual é aceitável.
  • Avançar diretamente para edições após o usuário pedir para repensar design, propriedade, propósito ou adequação.

Verificação Final

Antes da implementação ou recomendação final, confirme:

  • O propósito não é meramente "fazer a implementação atual funcionar."
  • O direcionamento selecionado se adequa ao propósito do usuário/domínio e à condição de sucesso observável.
  • Correções explícitas do usuário ou conceitos rejeitados não foram reintroduzidos.
  • A urgência não sobrepujou restrições, limites de proprietário, limite de reversão ou verificação.
  • O código existente foi classificado por status de evidência, não por conveniência.
  • Qualquer decisão semântica tem um proprietário ou um desconhecido nomeado.
  • O peso do processo corresponde ao tamanho da tarefa.

Habilidades Relacionadas