AjaneeI/agent-skills

Traduza uma solicitação em um plano de execução autorizado e de complexidade mínima, com requisitos explícitos, exclusões, regras de parada e critérios de aceitação. Use antes de implementar uma tarefa de múltiplas etapas ou propor nova infraestrutura de agente.

O que é agent-skills?

Esta skill, chamada 'Constraints-First Execution', fornece uma abordagem disciplinada para planejar e executar tarefas multi-etapas com agentes de IA, como Claude Code, Cursor ou Codex. Ela é útil porque evita que o agente extrapole permissões, construa soluções excessivamente complexas ou assuma autorizações não declaradas. A skill funciona exigindo que, antes de qualquer implementação, o usuário defina um contrato claro com objetivos, entregáveis, ações proibidas e critérios de sucesso. Em seguida, ela questiona a necessidade de cada requisito, remove trabalho opcional, simplifica a arquitetura e ordena as tarefas por dependência e evidências. O resultado é uma tabela de requisitos para ações, com marcadores como 'deve', 'pode' e 'não deve', garantindo que cada tarefa tenha uma razão nomeada e uma condição de evidência, evitando abstrações desnecessárias e mantendo o foco no que é realmente necessário para o objetivo do usuário.

Funciona com~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/AjaneeI/agent-skills/tree/HEAD/skills/constraints-first-execution

Documentação

Execução com Restrições Primeiro

Quando usar

Use no início de uma nova implementação, automação ou fluxo de pesquisa, especialmente quando um agente puder construir demais ou assumir permissões não declaradas.

Entradas necessárias

Objetivo, ações autorizadas pelo proprietário, ações proibidas, capacidades existentes do sistema, evidências de sucesso, orçamento de recursos e quaisquer limites de aprovação externa. Autoridade desconhecida não é permissão implícita.

Procedimento

Escreva um contrato curto: objetivo, entregável no escopo, não-objetivos, ações reversíveis, restrições imutáveis e evidências de conclusão verificadas.
Questione se cada requisito é realmente necessário para o objetivo do usuário. Não exclua silenciosamente requisitos explícitos do usuário.
Remova trabalho opcional que não melhora os critérios de aceitação nomeados. Mantenha os controles de segurança e qualidade necessários.
Simplifique a arquitetura proposta antes de otimizá-la. Prefira ferramentas existentes e fluxos de trabalho diretos em vez de novos frameworks.
Ordene as tarefas restantes por dependência e portões de evidência. Identifique a próxima menor unidade reversível que comprove progresso.
Somente após esta sequência considere aceleração, paralelização ou automação. Estime o custo e a complexidade de cada adição.
Torne as questões de aprovação explícitas e delimitadas. Se a autorização não estiver clara para uma mudança material, preserve uma proposta em vez de executá-la.

Pare ou escale

Pare antes de escalonamento de acesso, compromissos pagos fora do orçamento, efeitos irreversíveis, mudanças congeladas de metodologia ou ações fora da permissão explícita. Nunca trate metas de velocidade como substituindo salvaguardas.

Entregável

Uma tabela breve de requisitos para ações com deve, pode, não deve, proprietários, dependências e evidências necessárias para considerar cada unidade concluída. Use o template de contrato quando a rastreabilidade for importante.

Aceitação

Cada tarefa proposta tem uma razão nomeada e uma condição de evidência; nenhuma nova dependência ou abstração é justificada unicamente por possíveis necessidades futuras.