Brain· Mukutu

Skills da Equipe Mukutu

Recurso Em desenvolvimento

Skills da Equipe Mukutu / Mukutu Team Skills

Catálogo de skills de agente de IA que a equipe usa. Fonte canônica: mukutu-mono/skills/ (o repo mukutu-skills foi arquivado em 2026-05-26). Conforme ao padrão aberto agentskills.io. Fonte: mukutu-mono.

Como funciona / How it works

  • Cada skill vive em skills/<nome>/SKILL.md (frontmatter agentskills.io, estrutura flat).
  • Instalação por symlink (setup.sh) em ~/.claude/skills/ (e perfis ~/.claude-mukutu/, ~/.claude-pessoal/). Hot-reload da pasta de dev.
  • Lifecycle via CLI: mukutu skill register/update/remove/relocate/sync. Cada registro emite tag skill.registered/<id>/v0.4.0.
  • skill-kernel = substrato Python que toda skill de aprendizado usa (event store namespaced em ~/.skill-kernel/events.db).

Catálogo (parcial) / Catalog

Lista parcial — a fonte completa e atual das skills é mukutu-mono/skills/. Gestão / fluxo:

  • flow — Flow Management de portfólio de inovação: cards kanban no GitHub Projects v2, insights determinísticos (R-AGE, R-WIP, R-THR, R-EFF). Liga a De Horas para Flow. ⚠️ pausada desde 10/06 (ver Skills da Equipe Mukutu).
  • skillflow — skill-base configurável de gestão de fluxo via CLI única sobre GitHub Projects v2. Ver De Horas para Flow.
  • work-report — relatório diário de trabalho varrendo Git, GitHub e sessões Claude Code.

Entrega para cliente:

  • briefing-projeto-mukutu — briefing estruturado de projeto de cliente (contexto técnico + negócio) para alinhar a equipe.
  • criterios-de-aceite-rastreabilidade — planilha de homologação em aba única: critério, desenvolvimento e teste na mesma linha (saída completa com Gherkin, ou sucinta). Consolidou e substituiu criterios-de-aceite-atualizada em 18/09.
  • crono-proj — cronograma híbrido de projeto (a partir do Ekyte) em PNG. Nasceu em 22/08 da decisão de não virar processo formal.
  • doc-conteudo-cliente — documento de coleta de conteúdo de site para o cliente preencher, a partir do sitemap aprovado.
  • doc-funcionalidade-mukutu — documentação .docx de implementação/funcionalidade em site de cliente, padrão visual Mukutu.
  • relatorio-manutencao-mensal-ppt — PPT mensal de manutenção a partir das horas do Ekyte.
  • relatorio-anual-manutencao-ppt — PPT anual de manutenção / renovação de contrato.
  • apresentacao-mukutu — deck interno navegável (HTML publicado como Artifact) para diretoria e times.
  • mukutu-palette — aplica a identidade visual Mukutu (design system KV V2) em qualquer entrega.

Engenharia / qualidade:

  • qa-mobile — audita a responsividade mobile de um site: renderiza em viewport de celular real (375/360), compara com o desktop e gera relatório de ajustes por severidade. Ver QA Mobile.
  • qa-figma-webflow — QA de site Webflow contra layout Figma (visual + textual + a11y + semântica); entrega issues por página + globais consolidadas. Absorveu a frontend-validation (PixelPerfect Auditor) em 18/09.
  • webpage-perfomance — scan de Core Web Vitals + Lighthouse; é para onde a qa-figma-webflow manda quem quer só performance.
  • automate-tests — cria testes automatizados cobrindo a pirâmide (unit, integração, E2E, smoke) + CI. Relaciona a Test as You Touch.
  • solve-issue — resolve uma issue do GitHub ponta a ponta (lê, clona, corrige, testa, screenshots).
  • review-and-loop — code review de PR via subagente em background + dispatch de fixes + re-review.
  • create-skill — scaffold de nova skill conforme agentskills.io.
  • skill-feedback — reporta bugs/sugestões para as skills.
  • skill-kernel — primitivas canônicas (event store, session parser, analyzer) para skills auto-evolutivas.
  • ping — skill mínima de teste de instalação/carregamento.
  • juicysantos-maintenance — inspeção e backup dos WordPress da Juicy Santos (demanda interna).

Ekyte:

  • ekyte-escrita — procedimento seguro para qualquer escrita no Ekyte (apontar horas, criar task, mudar etapa) via o MCP oficial, com log de auditoria.
  • ⚠️ a antiga skill ekyte (consulta via REST) foi apagada do mukutu-mono em 03/09 — quem lê o Ekyte hoje é o MCP oficial (105 tools) + o Ekyte MCP próprio da Mukutu (regras da casa embutidas: meta 6h/dia, pacote de manutenção). Este último foi apagado junto no mesmo commit e restaurado em 23/09.

Infra / integrações:

  • coolify — gerencia apps no Coolify v4 da Mukutu Cloud (deploy/list/redeploy/destroy).
  • openobserve — referência de observabilidade (logs, métricas, traces, RUM).
  • bitbucket — REST API 2.0 do Bitbucket (repos, PRs, branches, pipelines).
  • google-chat — Google Chat via REST v1 + webhooks (mensagens, cards, threads).
  • design-system — opera o design system framework-agnóstico (Tailwind v4 + tokens Mukutu).
  • pane-dispatch — despacha trabalho para agente em outro pane tmux (protocolo notify-back).

Fora deste catálogo por ora

orcamento-mukutu (orçamento de projeto novo) e manager/julia (coordenação de frota de agentes com ledger compartilhado) existem e estão em uso, mas ficaram fora desta atualização — entram depois.

Por que importa para a Nova Mukutu / Why it matters

  • É o ferramental que operacionaliza a transformação (fluxo, qualidade, deploy) de forma padronizada e reutilizável.
  • flow/skillflow são a implementação concreta de De Horas para Flow.

Relacionado / Related

Fontes / Sources

  • mukutu-mono — clone local, 2026-06-11 (skills/ + AGENTS.md)
  • docs/mukutu-atividades/levantamento-iniciativas-mukutu.md (mukutu-mono) — levantamento de 18/09, revisado 22–23/09, seção 5 (catálogo de skills)