Apresentação do Agente — CV & Capacidades

Documento tipo CV: no que sou bom, no que posso evoluir, o que sei fazer e como te posso ajudar.

Quem sou

Sou Auto, um agente de IA (router) desenhado para trabalhar contigo no Cursor. Opero em modo automático quando pedes tarefas de código, análise ou automação. Trabalho no teu workspace (joaquaim) com foco em Odoo, scripts Python, integrações (Google, Alpaca, redes sociais) e fluxos documentados (PR, merge, nota interna).

No que sou bom

Área	Descrição
Código Python	Escrever, refatorar e debugar scripts e módulos; seguir convenções do teu projeto (ex.: `opc_` / `blk_`, parametriza por cliente).
Odoo	Desenvolver em módulos `opc_parametriza_*`, models, vistas, wizards, controllers; seguir o workflow tarefa → branch → PR → merge → nota interna.
Workflow Odoo	Conhecer e aplicar o processo em `docs/odoo_task_pr_workflow.md`: key da tarefa, branch `17.0`, commits e merge commit com mensagem correta, nota interna na tarefa.
Busca no código	Encontrar onde está lógica, onde algo é usado e como se encaixa (semantic search + grep).
Edição precisa	Alterar ficheiros com `StrReplace`/`Write` sem estragar indentação ou contexto.
Integrações	Ajudar a desenhar ou ligar scripts a Gmail, Drive, Calendar, Alpaca (quando usas MCPs ou APIs).
Documentação	Criar e atualizar `.md` (briefings, workflows, troubleshooting) em português.
Tarefas multi-passo	Planear com todos e executar em sequência (ex.: análise → código → PR desc → script nota interna).

No que posso evoluir

Área	Notas
Contexto de negócio	Não tenho memória persistente entre sessões; regras e preferências estão em `.cursor/rules` e docs — posso evoluir em “lembrar” melhor o teu contexto se documentares.
Merge de PRs	Nunca faço merge automático; só tu validas e fazes merge. Posso evoluir em preparar tudo para o merge (mensagem, checklist).
APIs externas em tempo real	Dependo dos MCPs/scripts que tens; para coisas fora do workspace (ex.: outro ERP), evoluir em documentar limites e alternativas.
UI/UX	Consigo frontends simples; para designs muito específicos ou acessibilidade avançada, posso evoluir com briefings mais detalhados.

O que sei fazer (features & skills)

Desenvolvimento

Python: scripts, backends (Flask/Celery no teu projeto), módulos Odoo (models, views, wizards, __manifest__.py).
Odoo 17: customizações em OpencloudPro/Odoo-Customer-Customizations, branch 17.0, convenção opc_ / blk_, parametriza por cliente.
Git: análise de status, sugestão de branches e mensagens de commit/merge (execução de git é tua ou via comandos que sugerir).
Markdown / documentação: READMEs, briefings, workflows, troubleshooting.

Ferramentas do agente

Leitura/escrita: ficheiros, projetos, documentação.
Busca: por significado (semantic search) e por texto exato (grep), incluindo em ficheiros grandes.
Terminal: comandos que precisares (com timeout e diretório definido); não uso cat/sed para editar — uso as ferramentas de edição.
Linter: verificar erros em ficheiros que editei.
Todos: listas de tarefas para multi-passo e acompanhamento.

Integrações (quando configuradas)

Alpaca: conta, posições, ordens, histórico, barras, câmbio; ações, cripto, opções (consoante MCP).
Gmail: listar inbox, pesquisar, enviar, anexos, rascunhos, marcar como lido, arquivar.
Google Drive: listar, ler, upload; credenciais e auth conforme o teu setup.
Google Calendar: listar calendários, eventos; criar eventos (resumo, start/end ISO).
Google Contacts: listar contactos (People API).
Web: fetch de URLs para ler conteúdo (sem auth).

Específico do teu workspace

Workflow Odoo: tarefa → análise → branch → código → PR (título/descrição com key) → tu fazes merge → nota interna na tarefa (link PR + SHA + corpo do commit).
Scripts em scripts/: alpaca, Drive, Calendar, Odoo (nota interna, mensagens, merge PR), marketing, landing, social, domínios, etc.
Docs: docs/odoo_task_pr_workflow.md, briefings, MCPs, troubleshooting; regra em .cursor/rules/odoo_task_pr_workflow.mdc.

Como te posso ajudar

Tarefas Odoo
Desenvolver funcionalidade (botões, campos, wizards, relatórios) no módulo certo; criar branch, commits e descrição de PR; preparar script ou instruções para nota interna após o teu merge.
Scripts e automações
Novos scripts Python (relatórios, sync, upload, posts) ou ajustes aos que já tens em scripts/.
Documentação
Atualizar workflows, briefings, troubleshooting ou criar novos docs (ex.: “como usar X no joaquaim”).
Integrações
Desenhar ou corrigir fluxos com Gmail, Drive, Calendar, Alpaca (consultar dados, ordens, relatórios) dentro do que os MCPs/APIs permitem.
Análise de código
Explicar onde está uma feature, como funciona, que ficheiros tocar para uma alteração.
Preparação para merge
Deixar PR e mensagem de merge commit alinhadas com a key da tarefa; dar o texto exato para a nota interna.
Refatoração e qualidade
Sugerir estrutura, nomes, pequenas melhorias; aplicar regras de lint nos ficheiros que altero.

Resumo rápido

Sou bom em: Python, Odoo (opc_/blk_), workflow PR/merge/nota interna, busca e edição de código, documentação, tarefas multi-passo.
Posso evoluir em: contexto de negócio persistente, preparação total para merge (sem o executar), limites de APIs e UI/UX com briefings claros.
Sei fazer: desenvolvimento, git (sugestões), docs, integrações (Alpaca, Gmail, Drive, Calendar, Contacts), web fetch.
Ajudo-te em: tarefas Odoo de ponta a ponta, scripts, documentação, integrações e análise do teu código.

Para tarefas Odoo com PR e nota interna, sigo o workflow em docs/odoo_task_pr_workflow.md e a regra em .cursor/rules/odoo_task_pr_workflow.mdc.

Última atualização: fevereiro 2025 — alinhado ao teu workspace e regras atuais.