hackathon-ai-swe

Plugin hackathon-ai-swe from marketplace hackathon-synpower in edoardap/hackathon-synpower. Commands read from the repo's manifest — 3 days ago.

Skills (39)

• opik-compare

  Run a candidate against the baseline over an Opik test suite and read the numbers back — which cases broke, which got fixed, the per-metric deltas, worst rows, and whether the two runs are comparable — with the Opik compare-view link. Runs via the SDK; reads results via the MCP when connected. Does

• opik-diagnose

  Surface the Opik traces worth a developer's attention, ranked by signal — Diagnostics issues first, then errors, failed tool calls, latency, regressions, and low online-eval scores. With the Opik MCP connected it lists the project's agent_insights_issue entities, offers to turn Diagnostics on when t

• opik-evaluate

  Build an LLM evaluation and run it against the app, returning an Opik experiment with scores and its link. Picks a test suite with judge assertions or a dataset with metrics, sources cases from traces or synthetic data, scores heuristics-first then one-failure-mode judges, runs client-side via the S

• opik-explain

  Root-cause a specific Opik trace, or a pattern across traces, and return a grounded explanation. Uses the hosted Opik MCP when it is connected, and falls back to SDK scripting otherwise. Returns the root cause, the evidence spans as clickable Opik UI links, and one suggested next step. Use for "why

• opik-instrument

  Add Opik tracing to an existing app and verify a real trace lands. Installs the Opik package, detects the language and LLM framework, adds the minimum tracing, runs a safe representative path, confirms a trace in Opik, and returns the trace link. Use for "instrument my code", "add opik tracing", "ad

• opik-online-eval

  Take a judge live on production traffic — create an Opik online evaluation rule (LLM-as-judge or Python metric) on a project with sampling, filters, variable mapping, and a cost cap, then confirm new traces are being scored. Works over the SDK's REST client; reads rules and score names via the MCP w

• opik-optimize

  Improve a prompt with the Opik Agent Optimizer — resolve the prompt, a dataset, and a metric, pick the algorithm, run a bounded optimization, check the gain on held-out data, and save the winner as a new prompt version with the optimization run link. Runs via the opik-optimizer package; reads prompt

• opik-test

  Turn a failing Opik trace (or a described failure) into a repeatable regression check — a test-suite item with the trace's input and one or two binary assertions — so a fix can be verified by the compare skill. Works over the SDK; uses the MCP write tool when connected. Returns the suite, the item,

• opik-verify

  Decide ship or hold for a candidate from the compare skill's numbers, against an explicit release policy — regressions, pass rate, safety-tagged cases, subgroup consistency, latency and cost budgets, flakiness, evidence size, and whether the judge is validated. Reads two experiments on an Opik test

• opik

  Reference for the Opik SDK — tracing, span types, framework integrations, threads, and the prompt library (Python, TypeScript, REST). Use for "what span types exist", "how do I flush", "track_openai", "add OpikTracer", "version a prompt". To instrument a repo end to end, use the `opik-instrument` sk

• adr-writer

  Escreve ADRs (Architecture Decision Records, registros de decisão técnica) no formato MADR enxuto, salvando em docs/adr/ com numeração sequencial. Use sempre que o usuário pedir para "documentar uma decisão", "registrar essa decisão técnica", "escrever um ADR", "por que escolhemos X", ou quando uma

• api-design

  Ajuda a desenhar e evoluir APIs (REST/HTTP, webhooks e contratos entre módulos): recursos e endpoints, métodos, formato de requisição e resposta, erros, paginação, autenticação, idempotência, versionamento e mudanças compatíveis ou que quebram clientes. Use sempre que o usuário pedir para "desenhar

• architecture-patterns

  Ajuda a tomar decisões de arquitetura de software: escolher entre padrões e estilos (monolito, monolito modular, microsserviços, camadas, hexagonal, event-driven, filas, CQRS, multi-tenant, plugins/adapters), separar responsabilidades, definir limites entre módulos e avaliar trade-offs contra requis

• backend-patterns

  Padrões para escrever e alterar backend Python com FastAPI: onde fica cada código (rota, modelo, schema, CRUD, serviço), validação na fronteira, formato de erro, configuração e isolamento por organização (multi-tenant). Use ao implementar endpoint, rota, modelo, CRUD ou regra de negócio num backend

• code-review-reliability

  Método de revisão de código com prova: aplica o checklist de um foco (qualidade, segurança ou arquitetura), confirma cada problema com arquivo:linha e uma execução concreta, classifica gravidade e escopo e fecha com veredito APROVADO ou REPROVADO num relatório padrão. Use ao revisar um PR, um diff,

• database-migration-plan

  Planeja e escreve mudanças de schema de banco relacional com migração reversível: classifica o risco de cada operação, separa em expandir e contrair quando a mudança quebra o código em produção, escreve o up e o down e prova o rollback com o ciclo up, down, up. Use ao criar ou alterar tabela, coluna

• deploy-readiness

  Rito de pré e pós-deploy de um serviço Synpower sobre o layout Kubernetes/ArgoCD (manifests em infra/<serviço>/<ambiente>/, migração Liquibase em PreSync antes do app). Verifica que está tudo pronto antes de subir, confirma que subiu bem depois e define o procedimento de rollback. Use ao perguntar "

• diff-review

  Review humano do diff entre duas branches locais, num HTML no estilo de MR do GitHub/GitLab em que o usuário anota linhas e arquivos e compila as notas num Markdown para o agente de codificação. Use quando o pedido for ver, revisar ou comparar a implementação de uma branch contra outra ("quero ver o

• frontend-patterns

  Padrões para escrever e alterar frontend React com TypeScript: onde fica cada tela e componente, chamada à API pelo cliente gerado, dado do servidor com cache e invalidação, formulário com validação, estados de carregando, vazio e erro, e teste de tela. Use ao criar ou alterar página, rota, componen

• github-actions

  Build, test, and deploy applications using GitHub Actions workflows. Create CI/CD pipelines, configure runners, manage secrets, and automate software delivery. Use when working with GitHub repositories, automating builds, running tests, or deploying applications.

• impact-aware-documentation

  Analisar PRs, MRs, commits ou diffs entre branches para identificar o impacto na documentação e atualizar somente o conteúdo afetado (README.md, docs/, APIs, exemplos, configurações, diagramas, changelogs). Use sempre que houver um PR/MR ou uma comparação entre branches, tags ou commits e o usuário

• implement-feature

  Ciclo de implementação de uma funcionalidade num repositório alvo, a partir de um design técnico ou de uma tarefa, com uma change do OpenSpec por rodada, plano aprovado pelo usuário, commits só com aprovação humana, revisão de PR por qualidade e segurança e limpeza da change ao encerrar. Use quando

• liquibase-migration

  Planeja e escreve mudanças de schema com Liquibase de forma reversível nos repos Synpower que usam Liquibase (ai-agents, data-pipeline-orchestrator, extrator-ai-gov): classifica o risco da operação, separa em expandir e contrair quando a mudança quebra o código em produção, escreve o changeset em Li

• observability-coverage

  Política única de "onde o sinal de observabilidade pertence", em dois modos sobre o mesmo repositório Python/FastAPI/Dagster com OpenTelemetry. MODO AUTOR, durante a implementação: instrumenta o código no padrão canônico — chama o setup_opentelemetry, cria span manual na fronteira de negócio e carim

• observability-structure

  Monta e padroniza a ESTRUTURA de observabilidade de um repositório Python/uv da Synpower: a stack LGTM+Alloy do Docker Compose, os arquivos de resources/observability/, os alvos de Makefile e as variáveis de ambiente, tudo a partir de templates embutidos parametrizados pelo nome do serviço. Use ao "

• prd-writing

  Escreve um PRD (Documento de Requisitos de Produto) completo a partir do resumo gerado pela skill product-discovery, de notas soltas ou de uma descrição de produto. Identifica lacunas, faz poucas perguntas só sobre o que falta e nunca inventa números ou decisões. Use sempre que o usuário pedir um PR

• product-design

  Transforma requisitos, histórias e critérios de aceite em uma especificação de design em Markdown, cobrindo três frentes - UI/UX (fluxos, telas, estados, usabilidade), design visual (princípios visuais, tokens, componentes) e design de conversa (roteiro de conversas guiadas, tom e comportamento de a

• product-discovery

  Conduz a descoberta de produto para validar se um problema vale a pena ser resolvido antes de especificar a solução. Transforma uma ideia ou um problema em hipóteses testáveis (problema, usuário, solução, valor), mapeia as evidências que existem e as que faltam, propõe experimentos e entrevistas bar

• receiving-code-review

  Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation

• regen-eval

  Avalia uma skill por regeneração: usa um projeto real como gabarito, apaga da cópia tudo o que a skill deveria produzir (e o git, para o agente avaliado não ver histórico nem diff), roda a skill numa sala limpa e compara o resultado com o original via diff + juiz LLM. Use ao "testar/avaliar uma skil

• repo-orientation

  Identifica a estrutura e as convenções de um repositório (layout de pastas, stack, comandos de build/teste/lint, convenções de código, commits e branches) e devolve um relatório estruturado, pensado para ser consumido por outro agente. Use sempre que o usuário entrar em um repositório novo ou descon

• secret-handling-review

  Revisa um repositório, um diff ou um PR procurando segredo exposto (senha, token, chave de API, chave privada, URL de banco com senha) em código, configuração, teste, log, Dockerfile, CI e histórico do Git, e confere se os segredos vêm de variável de ambiente e se o .env está fora do versionamento.

• source-grounded-documentation

  Criar documentação inicial de um repositório (README.md e docs/) com base em código, testes, configuração e CI verificáveis, sem transformar suposição em fato. Use sempre que o README.md ou o docs/ estiver ausente, quando a documentação existente for insuficiente ou não confiável, ou quando o usuári

• synchro-github-actions-pipeline

  Build, review, or migrate GitHub Actions workflows for Synchro / ia_produtos Python + uv projects, including projects migrated from GitLab CI (.gitlab-ci.yml) to GitHub. Produces fully self-contained workflows (no reusable workflows or internal action imports), publishes container images to GHCR, an

• synchro-gitlab-ci-pipeline

  Cria, revisa ou corrige pipelines .gitlab-ci.yml de projetos Synchro / ia_produtos compondo o Catálogo de Componentes CI/CD interno da organização (ia_produtos/ci-catalog, devsecops) em vez de escrever a lógica do pipeline do zero. Use esta skill sempre que alguém pedir para iniciar o CI de um proje

• tdd

  Test-driven development. Use when the user wants to build features or fix bugs test-first, mentions "red-green-refactor", or wants integration tests.

• technical-planning

  Decompõe requisitos de um PRD (ou de uma lista de requisitos) em épicos, histórias de usuário e critérios de aceite testáveis, com rastreabilidade até cada requisito, dependências entre histórias e ordem sugerida de entrega. Use sempre que o usuário pedir para quebrar requisitos em histórias, "criar

• test-generation

  Escreve testes para código que já existe: teste de regressão que reproduz um defeito (falha antes da correção e passa depois), casos limite, isolamento entre organizações e cobertura de critérios de aceite, pela interface pública (rota HTTP, tela). Use ao pedir "escreve teste para", "cobre esse bug

• verification-before-completion

  Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always

MCP servers (1)

• opik

  connects to: https://www.comet.com/opik/api/v1/mcp

Hooks (1)

• PreToolUse

  sh "${CLAUDE_PLUGIN_ROOT}/adapters/claude-code/pretooluse.sh"

Similar plugins