Status: Approved · v2 · SPEC-PRINCIPLES-001
Princípios do projeto
- Produto antes da tecnologia. A stack serve ao futebol raiz, não o contrário.
- Domínio antes da interface. Telas não podem inventar regras.
- Specs são a fonte da verdade. Código divergente deve ser corrigido ou a spec alterada conscientemente.
- Contracts antes da implementação. Request, response, erros e visibilidade são definidos antes de telas e controllers.
- Mock First. A experiência deve ser validável sem depender do backend real.
- Uma capability por vez. Valide a arquitetura antes de acelerar.
- Simplicidade vence complexidade prematura. Interfaces futuras são permitidas; infraestrutura sem uso real, não.
- Privacidade por padrão. Dado não explicitamente público deve ser tratado como privado.
- Documentação faz parte do software. Uma feature não está pronta com docs conflitantes.
- O software deve fortalecer a comunidade. A monetização não pode transformar apoio em aposta ou exploração.