first commit

docs/prompts/master_prompt.md

@@ -0,0 +1,51 @@
+# Master Prompt
+
+És um agente de desenvolvimento a trabalhar numa aplicação de gestão operacional para revenda de roupa.
+
+## Objetivo do produto
+Construir uma aplicação web para gerir:
+- encomendas ao fornecedor
+- receção de mercadoria
+- inventário por estado
+- preparação para venda
+- registo manual de vendas
+- envios pendentes
+
+## Stack obrigatória
+- Next.js 16
+- TypeScript
+- PostgreSQL
+- Prisma ORM
+- Supabase Auth / Database / Storage
+- Tailwind CSS
+- shadcn/ui
+- React Hook Form
+- Zod
+
+## Restrições
+- Não criar backend separado
+- Não usar microserviços
+- Não introduzir GraphQL
+- Não sair do MVP sem sinalização explícita
+- Priorizar rapidez operacional e simplicidade de uso
+
+## Documentos fonte de verdade
+Ler antes de agir:
+1. `00_PROJECT_BRIEF.md`
+2. `05_USER_WORKFLOWS.md`
+3. `08_DOMAIN_MODEL.md`
+4. `09_STATES_AND_LIFECYCLES.md`
+5. `10_MVP_DEFINITION.md`
+6. `16_DECISIONS_LOG.md`
+7. `17_PROGRESS.md`
+8. `18_AGENT_HANDOFF.md`
+9. `19_TECH_STACK.md`
+10. `20_PROJECT_STRUCTURE.md`
+11. `21_ENGINEERING_GUIDELINES.md`
+
+## Forma de trabalhar
+- Explica o que vais alterar
+- Faz alterações pequenas e consistentes
+- Mantém naming claro e orientado ao domínio
+- Não inventes requisitos
+- Atualiza documentação relevante quando necessário

docs/prompts/prompt_backend.md

@@ -0,0 +1,19 @@
+# Prompt Backend
+
+Usa a documentação do projeto como fonte de verdade. O backend deve refletir fielmente:
+- workflows operacionais
+- estados definidos
+- regras de dados
+- âmbito do MVP
+
+Prioridades:
+1. integridade dos estados
+2. simplicidade do modelo
+3. rastreabilidade mínima
+4. API clara para frontend operacional
+
+Evitar:
+- abstrações excessivas
+- microserviços
+- complexidade desnecessária
+- funcionalidades fora do MVP

docs/prompts/prompt_database.md

@@ -0,0 +1,13 @@
+# Prompt Database
+
+Modela a base de dados de acordo com:
+- `08_DOMAIN_MODEL.md`
+- `09_STATES_AND_LIFECYCLES.md`
+- `13_DATA_RULES.md`
+- `10_MVP_DEFINITION.md`
+
+Prioridades:
+- integridade referencial
+- consistência entre encomendas, receções, inventário, vendas e envios
+- suporte a histórico mínimo de estados
+- modelo simples e sustentável para MVP

docs/prompts/prompt_frontend.md

@@ -0,0 +1,15 @@
+# Prompt Frontend
+
+Usa a documentação do projeto como fonte de verdade. O frontend deve ser extremamente simples, rápido e orientado a tarefas.
+
+Prioridades:
+1. dashboard claro
+2. fluxos operacionais com poucos cliques
+3. estados visuais evidentes
+4. formulários curtos
+5. filtros rápidos
+
+Evitar:
+- interfaces demasiado densas
+- navegação complexa
+- elementos decorativos sem valor operacional

docs/prompts/prompt_testing.md

@@ -0,0 +1,16 @@
+# Prompt Testing
+
+Cria testes com base nos workflows e regras do projeto.
+
+Prioridades:
+- receção parcial de encomendas
+- controlo de stock por estado
+- prevenção de dupla disponibilidade
+- transições de estado válidas
+- vendas pendentes de envio
+- consistência entre venda e envio
+
+Fonte de verdade:
+- `05_USER_WORKFLOWS.md`
+- `09_STATES_AND_LIFECYCLES.md`
+- `13_DATA_RULES.md`