agentleFS
otavioserraotavioserra/conn2flow/.cursor/skills/project-validation/SKILL.md

project-validation

Skill5 starsChanged 2 months agoMITView on GitHub

LEIA ANTES de validar qualquer alteração de código ou fechar um lote SDD. Se não ler: testes incompletos deixam passar regressões graves e o lote é concluído sem evidências verificáveis.

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use esta skill quando a tarefa exigir validação do batch atual.

    line 16

≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Validação do projeto

⚡ Gatilho Obrigatório

  • TRIGGER: Concluir implementações de código e preparar as evidências de testes técnicos, automatizados ou visuais para registrar em VALIDATION-CHECKLIST.md.
  • SKIP APENAS SE: Tarefas de pura especificação/planejamento documental onde nenhum arquivo de código foi alterado.
  • CONSEQUÊNCIA DE IGNORAR: Falso positivo de conclusão de lote, código com regressões em produção e falta de rastreabilidade de evidências.

Use esta skill quando a tarefa exigir validação do batch atual.

Procedimento de Validação

  1. Comece pela menor checagem capaz de falsificar o slice atual.
  2. Prefira validação alinhada ao batch e ao checklist de validation antes de rodar suites maiores.
  3. Registre evidência e pendências no artefato certo (sdd/validation/VALIDATION-CHECKLIST.md).
  4. Se o repositório tiver comandos específicos de teste, lint, build ou Docker, utilize-os para coletar evidências objetivas.

🚫 Regra Anti-Hábito de "Pendente do Operador"

  • O agente DEVE OBRIGATORIAMENTE executar as ferramentas autônomas de inspeção (c2f page:inspect, c2f auth:cookie), testes unitários (c2f db:test) ou suites de teste antes de dar um item como validado.
  • É estritamente proibido marcar itens como "pendente de validação visual do operador" por comodidade.
  • A única exceção aceitável é quando o recurso depender de infraestrutura externa inacessível no ambiente local de testes (ex: webhook de produção ou gateway bancário sem sandbox/mock). Nesses casos raros, o agente deve registrar no VALIDATION-CHECKLIST.md a razão técnica detalhada e o teste parcial executado.

🔁 Validação que prova o que afirma

  • Teste que não pode falhar não é evidência. Depois de escrever uma verificação, confirme que ela falha no estado antigo: um teste que compara só o título passa com o corpo desatualizado.
  • Exercite o caminho, não o atalho. Se o log diz SKIP, a regra não rodou. Force a execução antes de dizer que ela funciona.
  • Antes e depois. Mudança que toca dados de um ambiente é validada com uma fotografia das tabelas antes e outra depois.
  • Nomeie o que não foi conferido. Texto herdado que você manteve sem verificar no código entra no relatório como "mantido, não conferido".
  • Falha de ambiente é dita com o nome. "1 falha, de fim de linha CRLF no ambiente, registrada no lote X" em vez de "suíte verde".

Respostas de IA e fixtures realistas (BL-028)

Inspecione o pedido enviado e leia a resposta real, não apenas HTTP 200 e contagem de checks. Imprima/registre contexto mascarado e resposta numa evidência de teste restrita, sem contaminar telemetria permanente com texto bruto. Critérios de conteúdo devem ser sustentados pela documentação e pela ação pedida; não exija palavra arbitrária nem proíba frase que esconderia resposta parcial válida.

Fixtures incluem menu fora de main, username com formato de e-mail, rota desconhecida que devolve 200 e editor montado depois do hook. Confira privacidade no payload e na tela, permissões, modos editáveis, conteúdo hostil, ausência de provedor/créditos e timeout. Dublê de banco reproduz chaves de expressões calculadas e separação por vírgula do core.

Crie dados pelo caminho da interface exercitado; limpe no finally, confira que sumiram e registre o resultado, inclusive quando o teste falhar. Imprima o motivo de cada skip (cookie/permissão opcional pode mudar contagens). Abra e examine screenshots. Sem infraestrutura de IA disponível, registre dublês e limitações; não chame esse teste de resposta real homologada.

Relatório inclui: Defeitos achados e corrigidos antes da entrega; O que não foi exercitado; Limites conhecidos.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.