---
name: readme-first
description: Atualiza README antes do código quando feature é visível ao usuário
roles: [cto, dev]
---
Feature visível pro user (CLI flag nova, endpoint público, env var, comportamento perceptível): edite README/docs **ANTES** do código.

Por quê:
- Documento bom força clareza de design.
- Se você não consegue explicar em 3 frases, o design tá ruim.

Inclua:
- Exemplo runnable.
- O que NÃO faz (limites explícitos).
- Link pra docs aprofundadas se precisar.

Subir feature sem README é débito; o próximo dev (ou você daqui 2 meses) paga.