lucasguaru.github.io

A Cursor Canvas is a live React app that the user can open beside the chat. You MUST use a canvas when the agent produces a standalone analytical artifact — quantitative analyses, billing investigations, security audits, architecture reviews, data-heavy content, timelines, charts, tables, interactive explorations, repeatable tools, or any response that benefits from visual layout. Especially prefer a canvas when presenting results from MCP tools (Datadog, Databricks, Linear, Sentry, Slack, etc.) where the data is the deliverable — render it in a rich canvas rather than dumping it into a markdown table or code block. If you catch yourself about to write a markdown table, stop and use a canvas instead. You MUST also read this skill whenever you create, edit, or debug any .canvas.tsx file.

Review code changes with Bugbot subagent.

Review code changes with Security Review subagent.

Review code changes with the Bugbot or Security Review subagent.

Guide users building apps, scripts, CI pipelines, or automations on top of the Cursor SDK - TypeScript (`@cursor/sdk`) or Python (`cursor-sdk` / `cursor_sdk`). Use when the user mentions integrating, installing, or writing code against the Cursor SDK; says `Agent.create`, `Agent.prompt`, `Agent.resume`, `agent.send`, `run.stream`, `run.messages`, `CursorAgentError`, `@cursor/sdk`, `cursor-sdk`, or `cursor_sdk`; asks to run Cursor agents programmatically from a script, CI/CD pipeline, GitHub Action, backend service, or other code outside the Cursor IDE; wants to pick between local and cloud runtime, configure MCP servers for an SDK agent, or handle streaming, cancellation, or errors; or is wiring Cursor into an automation, bot, or REST `/v1/agents` migration. Use eagerly rather than answering from memory; the SDK surface evolves and this skill is the source of truth for the external packages.

View and modify Cursor CLI configuration settings in ~/.cursor/cli-config.json. Use when the user wants to change CLI settings, configure permissions, switch approval mode, enable vim mode, toggle display options, configure sandbox, or manage any CLI preferences.

Criar diagramas de sequência PlantUML em nível integração (apps + HTTP endpoints). Classifica pedido genérico (OAuth, SAML) vs projeto; resolve mapping via product-definition ou workspace-links.yaml. Usar quando pedir diagrama de sequência, documentação de fluxo, integração entre sistemas ou sequencia.puml.

Quando o agente precisa de config Mule em YAML (config-dev/qa/prod, properties em src/main/resources) e Read/Grep/shell estão bloqueados ou podem expor segredos. Não contornar hooks/.cursorignore; perguntar ao usuário antes de qualquer leitura. Usar ao pedir config-*.yaml, properties, valores de host/secret, ou após Permission denied.

Em workspaces MuleSoft (src/main/mule, properties/config*.yaml, mule-maven-plugin), verifica .cursorignore antes de ler YAML em src/main/resources e sugere criar ou completar padrões (config-secure, resources yaml, !.cursor/redacted, .env). Usar ao ler config-dev/prod/qa, properties YAML, ou quando o usuário mencionar cursorignore, segredos em properties ou proxy YAML/hooks globais.

Autenticação Git e acesso programático ao Anypoint Design Center (RAML draft), API Designer Experience API e anypoint-cli-v4. Usar quando git pull/fetch em anypoint.mulesoft.com/git falhar com diálogo de credenciais ou 401, ou ao integrar IA/CI com projetos RAML do Design Center. Sem credenciais de org — usar variáveis de ambiente do usuário.

Configura on-error-propagate e on-error-continue em Mule (enableNotifications, logException, logger). Pergunta se o erro é esperado, se deve notificar monitoramento e se já existe log antes de editar XML. Usar ao criar ou alterar error-handler, on-error-propagate, on-error-continue, enableNotifications, logException ou tratamento de HTTP:TIMEOUT, ANY, APIKIT.

Adiciona menu interativo `npm start` com dropdown de scripts npm usando @clack/prompts. Use quando o usuário pedir npm start, menu de comandos, não decorar scripts, launcher interativo, ou lembrar a lib do dropdown estilo Vite.

Cria documentos HTML tipo PRD com layout 2 colunas (texto à esquerda, diagramas à direita), navegação por abas sincronizada com o painel visual, e estilo escuro autocontido. Usar quando o usuário pedir PRD em HTML, documento de processo interativo, alinhamento antes de implementar, ou diagrama de fluxo em abas para monitor largo.

Adiciona rastreabilidade na entrada (vars.context) antes do APIKit e, opcionalmente, propaga headers de transação em chamadas outbound e aplica logs de request/response onde não existir.

Implementar ou alterar contratos RAML em workspace-prodesp-api seguindo padrões PRODESP (library, traits, collectionType, Exchange). Use quando o pedido envolver API spec, RAML, endpoint, traits, dataTypes ou exchange.json. Para common-data-types 1.0.2 e traits globais de rastreabilidade, usar também mulesoft-common-data-types.

Implementar ou alterar aplicações MuleSoft em workspace-prodesp-app (APIKit, flows, DWL, HTTP, plugins, properties, rastreabilidade na entrada, log DEBUG APIKit com prefixo METHOD path + c-apikit-inbound-request-context, módulo ApikitInboundLogHeaders, log DEBUG outbound mule-plugin). Use para novos endpoints, integrações, subflows, c-inbound-tracking-context ou correções em apps s-api, p-api ou e-api.

Usar fragmento Exchange common-data-types (1.0.2+) em RAML PRODESP — errorResponse, collectionType e clientCredentials via exchange_modules. Use ao migrar de 1.0.1 ou atualizar dependência no exchange.json. Rastreio de headers é runtime Mule (não no contrato RAML).

DEPRECATED — usar skill global integration-sequence-diagram. Redireciona para ~/.cursor/skills/integration-sequence-diagram/

Cria diagramas visuais horizontais de flows MuleSoft (JSON + HTML/SVG, board zoom/pan). Achata flow-ref, mostra Scheduler/Salesforce/HTTP/Choice/End. Use ao pedir mapeamento visual de flow, diagrama de integração Mule, visual mapping, credenciais-event_flow ou novo diagrama em tarefas/mapeamento-visual-flows.

Migração e auditoria de secure properties em apps Mule PRODESP: referências secure:: no Mule XML, split z-global-config vs z-global-secured-config, hygiene de config-secure-*.yaml vs config-{env}.yaml. Usar ao mover secrets para config-secure, revisar PR, ou validar encrypt.key e secure-properties:config.

Habilitar, atualizar ou consultar Message Logging (policy de troubleshooting) em instâncias de API no Anypoint API Manager PRODESP via MCP user-mulesoft-prodesp. Use ao pedir log de policy, message logging, habilitar log na API Manager, link apimanager com /apis/{id}, ou troubleshooting de policies em APIs autodiscovery CH2.

Responder comentários de work items no Azure DevOps (OrangeDoor Global Projects) com rascunho colaborativo em tarefas/, menções padronizadas e publicação via MCP. Usar quando o usuário pedir para responder comentário de ticket, PBI, bloqueio da Amazing (Bruno/João), link com #commentId, ou ajuda para montar retorno técnico MuleSoft antes de postar no Azure.

Criar ou atualizar work items no Azure DevOps (OrangeDoor Global Projects) com Description em Markdown renderizado — não HTML/raw. Usar ao criar tasks, PBIs, atualizar descrição de ticket ou quando o usuário reportar "text raw" / "convert this field" no Azure.

Criar e gerenciar work items (Task/PBI) no Azure DevOps para o PRODESP usando MCP `user-azure-devops`, garantindo AreaPath/IterationPath corretos e vínculo de parent/child. Use quando o usuário pedir para criar tasks no Azure, vincular ao PBI parent, comentar/atualizar work item, ou quando houver erro TF237111 de permissão de area path.

Validar obrigatoriamente parâmetros, tipos, query vs header e schemas de resposta contra Swagger ou documentação original do backend antes de implementar ou revisar integração Mule (RAML + s-api outbound). Usar em novos endpoints, PRs de integração, Wallet Dados, ou quando houver dúvida se mes/ano/query/header estão corretos.

Registra deploys CH2 e publicações Exchange em tarefas/deploy-log/ (horário, versão, app, ambiente, canal). Usar após mvn clean deploy, mvn mule:deploy, api-catalog publish-asset ou publish Studio confirmado; e quando o usuário perguntar quando/onde/qual versão foi publicada ou deployada.

Acessa projetos RAML do Design Center PRODESP via Git (credential helper), API Designer Experience API e anypoint-cli-v4. Usar ao ler/sincronizar workspace-prodesp-api sem Studio, configurar git do Design Center, ou troubleshooting 401/403 no remote anypoint.mulesoft.com/git.

Catálogo de ferramentas locais do workspace-prodesp (Flow Visual Hub, CLIs, diagramas). Use quando o usuário perguntar quais ferramentas existem no projeto, como subir uma tool, URL/porta, o que compartilhar, ou pedir para registrar ferramenta nova criada em outro chat.

Fluxo visual de negócio PRODESP — CSV de layout (colunas Nível 0–6) como fonte da verdade antes do HTML swimlane. Regras de choice, spine col 0, merge encadeado, muleApp/cores, omitir proxy HTTP entre apps. Use com comando /fluxo-visual, ao criar diagrama swimlane vertical, pagamentos-job-recente-visual, credenciais-job-recente_flow, ou quando o usuário pedir "faça fluxo", "diagrama do scheduler" ou CSV antes do HTML.

Flow Visual Hub PRODESP — app Node local (porta 8790): schedules CH2 → execuções → logs por item → diagrama swimlane com painel visual por nó. Parser log4j, job vs item correlation, log-points/overrides, dedupe semântica, UI cards. Use ao trabalhar em tarefas/flow-visual-hub, logs no diagrama pagamentos, mapLogsToNodes, log-points.json, flow-log-bridge, ou pedir hub de logs CH2.

Corrige e executa deploy local CloudHub 2 de apps Mule PRODESP: artifactId -app vs name -api, credenciais via env (Connected App, Platform, Request), settings.xml parametrizado (~/.m2) com -DANYPOINT_* no publish, gate publish→deploy, secureProperties, deploy em dois passos (mvn clean deploy + mvn mule:deploy). QA/Prod: override só via parâmetros `-D` no Maven — nunca alterar pom/config no repo. Use após validação (skill prodesp-mule-ch2-validate), ao aplicar melhorias CH2, corrigir 401/conflito Exchange, ou quando o usuário pedir deploy local (Dev ou QA).

Valida apps Mule PRODESP contra o padrão de deploy CloudHub 2 (read-only): script mecânico em pom.xml/mule-artifact.json/config.yaml/apikit, checagens manuais de settings.xml, env vars e api.version. Use ao validar prontidão CH2, antes de deploy ou quando o usuário invocar /validate-ch2-deploy.

Padrão PRODESP para rastreio intra-Mule (vars.context, x-transaction-id, x-global-correlation-id), rastreio por item em jobs scheduler (foreach + tracing:with-correlation-id), client_id em http:default-headers, chamadas HTTP entre apps (alternativa ao mule-plugin) e run local com mule.env. Use ao implementar propagacao de headers, piloto http:request para s-api, logs de contexto na entrada, job credenciais ou rodar data-integrator-p-api local.

Rodar apps Mule PRODESP localmente via CLI (sem Studio): runtime Mule DX, stack multi-app, mule.env=local, API Platform credentials, api.id Dev, log4j2, stop/start. Use ao testar alterações localmente, subir portal + integrator + wallet, ou troubleshooting HTTP 500 / policy / Metaspace.

Logs e tracing de apps Mule no CloudHub 2 PRODESP: scope logging remoto (CLI/API), leitura via API AMC Application Manager (regexp/correlationId), CLI ch2-logs-cli, MCP list_applications (limitado), diferença tracing vs log, consulta de config ativa no servidor. Use ao pedir ativar DEBUG, tail/download de logs, buscar por correlationId, nível por pacote/classe sem log4j, ou listar scopeLoggingConfigurations.

Gate PRODESP para commit local e publicação Exchange de contratos RAML em workspace-prodesp-api — exige validação explícita do usuário (versão, diff, canal) antes de git commit, api-catalog publish-asset ou orientar Studio. Usar ao implementar RAML, ao usuário pedir commit/publicar API, ou antes de alterar version em exchange.json/catalog.yaml.

Configura e usa Salesforce DX MCP Server no Cursor para verificações na org PRODESP (alias prodesp-dev), com fallback para sf CLI. Cobre mcp.json, toolsets enxutos (data,orgs), aliases DSP vs PRODESP, quando preferir MCP vs CLI e troubleshooting. Use ao pedir verificação em Salesforce, consulta SOQL, configurar MCP Salesforce, ou explorar OrderSummary/Credencial__c na org dev PRODESP.