Reserva-Aqui---Projeto-de-fim-de-ciclo

Skill for updating, adding, or removing entries in ./Documantation/dot-agents-manual.md based on new or modified agents, skills, and workflows.

Generates and maintains `Frontend/lib/utils/API_functions.dart` — the single source of truth for all HTTP calls from the Flutter app to the ReservAqui backend. Use this skill whenever a developer asks to "add an API function", "criar função de API", "implementar chamada para o backend", "adicionar endpoint no Flutter", "conectar tela com a API", or any variation of wiring a Flutter screen to a backend route. Also trigger this skill when a developer describes a feature that needs API data — even if they don't explicitly mention "API_functions.dart". Never rewrite the existing file; always append. Uses Dio as the HTTP client.

Implementação de CRUD completo para a API do ReservAqui. Especializada na arquitetura do projeto (Entity → Service → Controller → Routes) com multi-tenant PostgreSQL. Use esta skill sempre que precisar criar ou modificar endpoints REST, entidades, rotas, serviços ou controllers no backend — especialmente ao adicionar novos recursos a tabelas do master DB (usuario, anfitriao) ou ao schema tenant (hotel). Aciona automaticamente quando o usuário menciona: "criar endpoint", "novo recurso", "CRUD", "rota", "controller", "service", "adicionar ao backend", "preciso de uma API para", ou quando descreve uma necessidade de negócio que claramente requer novos endpoints ou entidades.

Secure storage implementation skill. Guides the design and implementation of any file/object storage system with a security-first methodology: discovers architecture needs through structured questions, proposes the most secure and optimized approach before writing a single line of code, and then implements it. Activate this skill whenever the user mentions: file upload, object storage, image/video/document storage, S3, GCS, Firebase Storage, Supabase Storage, local disk storage, CDN, media uploads, presigned URLs, multipart upload, storage buckets, secure file access, or anything involving storing user-generated files. Also trigger when the user asks to "add storage", "handle uploads", "store files securely", or "set up a CDN".

Use this skill whenever the user asks to modify, remove, or add new tables in the database, handle database modeling, or update SQL scripts. Make sure to trigger this skill for any relational schemas, PostgreSQL architecture planning, or when creating relationships (1:1, 1:N, N:N).

Orienta sistemas com LLM em producao: limites, custos, observabilidade e seguranca de dados. Use em RAG, agentes ou prompts em produto.

Orienta desenho de APIs REST/GraphQL/tRPC com respostas consistentes, versionamento e limites. Use ao definir endpoints, contratos ou revisar APIs.

Orquestra criacao de novos projetos a partir de templates e stack escolhida. Use com playbook `create.md` e plano aprovado.

Indice de templates de projeto do app-builder. Use ao instanciar um template especifico (Next, Electron, React Native, etc.).

Framework de decisao arquitetural com foco em simplicidade, trade-offs e registro de decisoes. Use em mudancas estruturais.

Boas praticas para scripts bash/sh em ambientes POSIX. Use ao escrever ou revisar shell scripts no projeto.

Ajusta postura da sessao (explorar vs implementar vs revisar) conforme o pedido. Use quando o usuario alternar entre ideacao e codigo.

Protocolo socratico para esclarecer pedidos ambiguos ou complexos antes da implementacao. Use em novas features e escopo indefinido.

Padroes pragmaticos de codigo limpo para implementacoes diretas e seguras. Use ao escrever, editar ou refatorar codigo.

Fornece checklist de revisao (correcao, seguranca, manutenibilidade). Use em PRs, diff grande ou antes de merge.

Orienta modelagem, escolha de BD/ORM, indices e migracoes seguras. Use ao criar ou alterar schema e consultas.

Orienta releases seguros: preparacao, backup, deploy, verificacao e rollback. Use antes de subir para staging ou producao.

Padroes para README, changelog e comentarios com foco no porquê. Use quando o usuario pedir documentacao tecnica explicita.

Orienta Firebase com regras de seguranca e limites de custo. Use ao usar Firestore, Auth, Functions ou Hosting.

Orienta Flutter/Dart com composicao, const e acessibilidade. Use em apps Flutter do repositorio.

Orienta decisoes de UI web (hierarquia, cor, tipo, movimento) com foco em usuario e contexto. Use ao desenhar telas, componentes ou revisar UX.

Foco em jogos 2D (sprites, tilemaps, fisica leve). Use com game-development em projetos 2D.

Foco em jogos 3D (camera, malhas, iluminacao basica). Use com game-development em projetos 3D.

Pipeline de arte 2D/3D para jogos. Use quando o pedido envolver assets e estilo visual in-game.

Audio em jogos (musica, SFX, espacializacao basica). Use em sistemas de som.

Mecanicas, loop e progressao de jogo. Use na fase de desenho de gameplay.

Orienta loop de jogo, orcamento de frame e padroes comuns 2D/3D. Use em engines listados no manual do projeto (Unity, Godot, web, etc.).

Jogos mobile (touch, bateria, frame rate). Use em builds iOS/Android.

Sincronizacao, latencia e autoridade em jogos multijogador. Use em features online.

Jogos desktop (input, resolucao, performance). Use em builds PC.

Realidade virtual e aumentada em jogos. Use quando o escopo for VR/AR.

Jogos em canvas/WebGL e performance no browser. Use em jogos web.

Orienta conteudo e estrutura para citacao em motores generativos (GEO). Use quando o produto depende de descoberta por IAs de busca.

Orienta internacionalizacao (textos, RTL, layout). Use ao adicionar idiomas ou revisar strings na UI.

Sugere quando escalar de especialista unico para orquestracao ou plano. Use em pedidos multi-dominio ou ambiguos.

Rotina de validacao de qualidade apos alteracoes de codigo. Use para lint, tipos e checagens basicas antes de concluir tarefas.

Sincroniza documentacao de agentes/skills com o estado do repositorio. Use ao atualizar DOT_AGENTS_MANUAL ou inventarios.

Orienta criacao de servidores e ferramentas MCP com schemas claros e retornos seguros. Use ao integrar IA a recursos externos.

Orienta UX mobile (alvos de toque, listas, performance). Use em React Native, Flutter ou web mobile-first.

Orienta Next.js e React com foco em Server/Client Components, dados e performance. Use em apps Next/React do repositorio.