Prompts para código e documentação

Gerar código — template

Stack: PHP 8.2, strict_types, sem framework

Tarefa: função que valida CPF brasileiro (apenas dígitos, 11 chars)

Requisitos:
- Retornar bool
- Rejeitar sequências iguais (111.111.111-11)
- Validar dígitos verificadores
- PHPDoc completo
- Incluir 3 casos de teste com assert (sem PHPUnit)

Não use bibliotecas externas.
Mostre só o código, depois os testes em bloco separado.

Revisar código — template

Revise o código abaixo como revisor sênior PHP.

Critérios (marque OK ou PROBLEMA):
1. Segurança (injection, XSS, secrets)
2. Tipagem e strict_types
3. Nomenclatura e SRP
4. Tratamento de erros
5. Performance óbvia

Formato de saída:
## Resumo (2 frases)
## Achados
| # | Severidade | Linha | Problema | Sugestão |
## Patch sugerido (somente trechos alterados)

[código aqui]

Documentação — README e ADR

• README: instalação, pré-requisitos, comandos, estrutura de pastas, licença.
• PHPDoc: @param, @return, @throws — peça alinhado ao código real.
• ADR (Architecture Decision Record): contexto, decisão, consequências.

Gere um README.md para um módulo PHP "abjinfo_gen" (portal educacional).

Seções obrigatórias:
- Título e descrição em 1 parágrafo
- Pré-requisitos (PHP 8.2+)
- Como rodar localmente (php -S + router.php)
- Estrutura de pastas (data/areas.php, data/topicos/)
- Como adicionar um novo tópico (3 passos)

Tom: técnico, direto, em português BR.
Não invente URLs de produção — use placeholders.

Boas práticas com Copilot / Cursor

• Abra o arquivo certo e selecione só o trecho relevante como contexto.
• Comente a intenção em uma linha acima do cursor (“// TODO: validar slug”).
• Peça diff mínimo, não reescrita total do arquivo.
• Rode linter e testes após aceitar sugestão — IA não substitui CI.