AgtecCore

Adiciona suporte a embeddings vetoriais no módulo de IA do projeto usando pgvector. Use quando o usuário pedir para adicionar busca semântica, embeddings, vetorização de documentos, ou memória de longo prazo ao módulo de IA. Também ativa automaticamente quando o contexto menciona "embeddings", "busca semântica", "pgvector", "vetorização" ou arquivos no módulo de IA do projeto.

Adiciona um novo endpoint FastAPI ao projeto AgtecCore seguindo a arquitetura em camadas (router → use_case → crud). Use quando o usuário pedir para criar um endpoint, adicionar uma rota, implementar um CRUD, ou estender um módulo existente. Também ativa automaticamente quando o contexto menciona "novo endpoint", "nova rota", "criar endpoint" ou arquivos em módulos com routers.py.

Atualiza os artefatos de desenvolvimento assistido por IA do projeto AgtecCore (`.ia/` e `AGENTS.md`) quando há mudanças arquiteturais, novos módulos, novas restrições ou inconsistências detectadas. Use quando o usuário pedir para atualizar documentação IA, corrigir artefatos, ou após uma mudança arquitetural significativa. Também ativa automaticamente quando o contexto menciona "atualizar artefatos", "documentação IA", "artefatos desatualizados" ou arquivos em `.ia/`.

Criar uma branch de implementação a partir de uma task aprovada, usando o nome do arquivo da task como nome da branch e a branch atual como base. Opera apenas em Git e no arquivo da task. Usar quando a task estiver aprovada para implementação, quando for necessário abrir a branch da task ou quando a execução for sair da fase de análise para implementação.

Diagnostica e corrige bugs no projeto AgtecCore seguindo o protocolo anti-alucinação. Use quando o usuário reportar um erro, exceção, comportamento inesperado, ou falha em teste. Também ativa automaticamente quando o contexto menciona "bug", "erro", "exception", "falha", "não funciona" ou stack traces.

Escreve testes automatizados para o projeto AgtecCore usando pytest, pytest-asyncio e TestContainers. Use quando o usuário pedir para criar testes, aumentar cobertura, escrever test cases, ou validar uma implementação. Também ativa automaticamente quando o contexto menciona "escrever testes", "criar testes", "test coverage" ou arquivos em tests/.

Escrever e revisar testes automatizados com `pytest`, `pytest-asyncio` e `TestContainers` para routers, use cases e models do projeto FastAPI AgtecCore. Usar quando adicionar feature, bugfix, refactor ou alterar contrato de endpoint.

Validar a governança documental e operacional de agentes em `AGENTS.md` e `.ia/`, detectando placeholders, status inválidos, referências quebradas, hardcodes pessoais, documentos duplicados, menções a stack obsoleta em `AGENTS.md`, divergências essenciais entre skills e catálogos, e regressões do contrato `DD-MM-YYYY`/status em inglês. Usar quando o desenvolvedor pedir auditoria automatizada de governança ou antes de consolidar mudanças amplas em `.ia/`.

Fazer o merge de uma branch de task no padrão `task-DD-MM-YYYY-<hash_alfanumerico_10>` com a branch local `dev`. Skill agnóstica de linguagem e framework — opera apenas em Git. Usar quando o desenvolvedor pedir `merge com dev`, solicitar merge da branch atual da task para `dev` ou quiser validar esse fluxo com `--dry-run`.

Cria uma nova tool assíncrona no módulo de IA do projeto. Use quando o usuário pedir para adicionar uma tool de domínio, consulta ao banco ou transformação de dados para um agente. Também ativa automaticamente quando o contexto menciona "nova tool", "tool para o agente", "adicionar ferramenta IA" ou arquivos no módulo de agentes do projeto.

Cria um novo agente especialista no módulo de IA do projeto. Use quando o usuário pedir para adicionar um novo agente de domínio, especialista IA para um módulo, ou integrar um novo módulo ao orquestrador. Também ativa automaticamente quando o contexto menciona "novo agente", "agente especialista", "adicionar agente IA" ou arquivos no diretório de agentes do módulo de IA.

Usar quando o usuário perguntar sobre histórico, tarefas, specs, runbooks, decisões ou contexto de implementação do sistema. Resposta vem primeiro do vault Obsidian; fallback para o repositório somente se o vault não responder. Ativa em frases como "qual a última tarefa", "o que implementamos", "última spec", "buscar no cofre", "consultar obsidian".

Sincronizar o repositório atual com o vault Obsidian DevBrain. Usar quando o usuário pedir "obsidian-sync", "sincronizar obsidian" ou quiser exportar o contexto do repositório para o DevBrain.

Refatora um módulo existente do AgtecCore para alinhar com os padrões arquiteturais vigentes (CoreBase, BaseUseCases, Pydantic v2, async). Use quando o usuário pedir para refatorar, modernizar, ou corrigir padrões em um módulo FastAPI existente. Também ativa automaticamente quando o contexto menciona "refatorar", "modernizar", "padronizar módulo" ou "alinha ao padrão".

Cria uma especificação técnica de integração entre um módulo FastAPI do AgtecCore e o cliente Flutter Web. Usar quando o usuário pedir explicitamente para criar uma spec de integração Flutter web/mobile, spec flutter, integração flutter, flutter mobile, flutter web.

Encerrar uma task implementada, validar os campos finais obrigatórios e mover o arquivo de `.ia/docs/tasks/todo/` para `.ia/docs/tasks/done/` com status final canônico. Skill agnóstica de linguagem e framework — opera apenas sobre arquivos markdown e Git. Usar quando a implementação da task estiver concluída e a demanda estiver pronta para fechamento documental.

Orquestrar demandas assistidas por IA com task, seleção de skills e fechamento documental. Skill agnóstica de linguagem e framework — operacionaliza o ciclo de task (`planned` → `approved` → `in_progress` → `done`) sem assumir stack específica. Usar quando o pedido envolver tarefa, demanda, feature, bugfix, refactor, melhoria de testes, mudanças multi-arquivo ou alterações em `.ia/`.

Criar uma branch de implementação a partir de uma task aprovada, usando o nome do arquivo da task como nome da branch e a branch atual como base. Opera apenas em Git e no arquivo da task. Usar quando a task estiver aprovada para implementação, quando for necessário abrir a branch da task ou quando a execução for sair da fase de análise para implementação.

Construir e manter serializers DRF em `api/serializers/` para validação de entrada, serialização de saída e proteção de dados sensíveis. Usar quando criar ou alterar contratos de API.

Implementar endpoints DRF em `api/views/` e roteamento em `api/routers.py` e `base/urls_api.py`. Usar quando criar ou ajustar ViewSets/ReadOnlyViewSets, permissões, filtros e orquestração de casos de uso.

Projetar tarefas assíncronas com Celery em `tasks.py` para processos longos ou desacoplados do request HTTP. Usar quando houver trabalho em background, integração externa ou processamento em lote.

Projetar QuerySets e managers customizados em `managers.py` para encapsular consultas reutilizáveis e evitar N+1. Usar quando criar filtros complexos, seleção por contexto e acessos de dados de domínio.

Planejar, gerar e revisar migrations Django com foco em segurança de produção. Usar quando houver mudanças de schema, índices, constraints ou backfill de dados.

Definir e evoluir models Django ORM do monólito modular AgtecCore. Usar quando criar ou alterar entidades de domínio em `models.py`, campos, relacionamentos, constraints e índices.

Realizar checklist de validação inicial de um novo projeto Django gerado pelo template CookieCutter. Verificar configuração de INSTALLED_APPS, AUTH_USER_MODEL, banco de dados, variáveis de ambiente, migrations pendentes e conformidade com as regras do .ia/. Usar quando um novo projeto for gerado a partir do template ou quando houver necessidade de validar a saúde inicial do projeto.

Criar e evoluir regras de negócio em `services.py` ou `use_cases.py` por app. Usar quando implementar fluxos de domínio, integrações externas e operações com múltiplas escritas.

Escrever e revisar testes automatizados com `pytest`, `pytest-django` e TestContainers para models, API e casos de uso do projeto, executando-os com a `.venv` ativa e pelo fluxo do repositório que provisiona dependências via TestContainers. Usar quando adicionar feature, bugfix, refactor ou alterar contrato de endpoint.

Gerar especificação técnica para a equipe da camada FastAPI integrada ao Django. Usar sempre que o pedido envolver spec técnica, arquitetura, plano técnico ou detalhamento de implementação para FastAPI.

Validar a governança documental e operacional de agentes em `AGENTS.md` e `.ia/`, detectando placeholders, status inválidos, referências quebradas, hardcodes pessoais, documentos duplicados, menções a stack obsoleta em `AGENTS.md`, divergências essenciais entre skills e catálogos, e regressões do contrato `DD-MM-YYYY`/status em inglês. Usar quando o desenvolvedor pedir auditoria automatizada de governança ou antes de consolidar mudanças amplas em `.ia/`.

Fazer o merge de uma branch de task no padrão `task-DD-MM-YYYY-<hash_alfanumerico_10>` com a branch local `dev`. Skill agnóstica de linguagem e framework — opera apenas em Git. Usar quando o desenvolvedor pedir `merge com dev`, solicitar merge da branch atual da task para `dev` ou quiser validar esse fluxo com `--dry-run`.

Usar quando o usuário perguntar sobre histórico, tarefas, specs, runbooks, decisões ou contexto de implementação do sistema. Resposta vem primeiro do vault Obsidian; fallback para o repositório somente se o vault não responder. Ativa em frases como "qual a última tarefa", "o que implementamos", "última spec", "buscar no cofre", "consultar obsidian".

Sincronizar o repositório atual com o vault Obsidian DevBrain. Usar quando o usuário pedir "obsidian-sync", "sincronizar obsidian" ou quiser exportar o contexto do repositório para o DevBrain.

Encerrar uma task implementada, validar os campos finais obrigatórios e mover o arquivo de `.ia/docs/tasks/todo/` para `.ia/docs/tasks/done/` com status final canônico. Skill agnóstica de linguagem e framework — opera apenas sobre arquivos markdown e Git. Usar quando a implementação da task estiver concluída e a demanda estiver pronta para fechamento documental.

Orquestrar demandas assistidas por IA com task, seleção de skills e fechamento documental. Skill agnóstica de linguagem e framework — operacionaliza o ciclo de task (`planned` → `approved` → `in_progress` → `done`) sem assumir stack específica. Usar quando o pedido envolver tarefa, demanda, feature, bugfix, refactor, melhoria de testes, mudanças multi-arquivo ou alterações em `.ia/`.