Meta

Pergunte qual skill ou fluxo se encaixa na sua situação. Um roteador sobre as skills deste repositório.

Revisa as mudanças desde um ponto fixo (commit, branch, tag ou merge-base) em dois eixos: Standards (o código segue os padrões de código documentados deste repositório?) e Spec (o código corresponde ao que a issue/spec de origem pediu?). Roda as duas revisões em subagentes paralelos e reporta lado a lado. Use quando o usuário quiser revisar uma branch, uma PR, mudanças em andamento, ou pedir para "revisar desde X".

Vocabulário compartilhado para desenhar módulos profundos. Use quando o usuário quiser desenhar ou melhorar a interface de um módulo, encontrar oportunidades de aprofundamento, decidir onde fica um seam, tornar o código mais testável ou navegável por IA, ou quando outra skill precisar do vocabulário de módulo profundo.

Loop de diagnóstico para bugs difíceis e regressões de performance. Use quando o usuário disser "diagnostica"/"debuga isso", ou reportar algo quebrado/lançando erro/falhando/lento.

Constrói e afia o modelo de domínio de um projeto. Use ao discutir terminologia do codebase, escrever ou editar um CONTEXT.md, ou registrar/editar um ADR.

Como o harness usa OpenSpace (MCP de skills auto-evolutivas — FIX/DERIVED/CAPTURED). Define onde skills curadas vs evoluídas ficam, como distingui-las, quando confiar numa CAPTURED e como promover uma CAPTURED bem-sucedida para o conjunto curado. Invoque ao adotar/criticar uma skill evoluída, ao ver uma CAPTURED nova, ou ao decidir promover.

Configura hooks do Claude Code para bloquear comandos git perigosos (push, reset --hard, clean, branch -D, etc.) antes que sejam executados. Invoque quando o dev quiser prevenir operações git destrutivas, adicionar hooks de segurança git, ou bloquear git push/reset no Claude Code. Importada de mattpocock/skills.

Uma entrevista implacável para lapidar um plano ou design. Importada de mattpocock/skills.

Uma entrevista implacável para afiar um plano ou design, que também cria documentação (ADRs e glossário) no processo.

Interroga o dev de forma implacável sobre um plano, decisão ou ideia até chegar a um entendimento compartilhado. Invoque quando o dev quer estressar o próprio raciocínio, ou usa qualquer frase-gatilho com "grill". Importada de mattpocock/skills.

Compacta a conversa atual num documento de handoff para outro agente continuar.

Índice das skills do harness-engineering. Carrega regras universais (branches develop/main, sessões dev/QA, validação antes de commit) e aponta para skills específicas (workflow-*, frontend/*, backend/*, ratchet-*). Invoque sempre que iniciar uma sessão em projeto que contém .gsd/ ou .harness/, ou quando o dev mencionar "harness".

Implementa um trabalho a partir de um spec ou conjunto de issues. Importada de mattpocock/skills.

Varre a codebase em busca de oportunidades de aprofundamento (deepening), apresenta como relatório HTML visual, depois grilla a que for escolhida. Importada de mattpocock/skills.

Topologia de rede do Forgejo (interno, sem IP público) e do Coolify (VPS), ligados por uma tailnet Tailscale — inclusive o webhook de deploy. Referência para devs fazendo manutenção de infra; não é um workflow de código. Invoque quando o dev perguntar por que o Forgejo não responde por IP direto, como o deploy automático dispara, ou pedir os endereços da tailnet.

Convenção de uso do MemPalace (memória local-first, verbatim, busca semântica) dentro do harness. Define wings/rooms/drawers, cadência (wake-up, search, mine, sweep) e o que vale guardar vs ruído. Invoque no início de qualquer sessão (para puxar contexto cross-projeto), ao tomar decisão arquitetural (para registrar), ou ao terminar sessão (para indexar).

Migra arquivos de teste de type assertions `as` para @total-typescript/shoehorn. Invoque quando o dev mencionar shoehorn, quiser substituir `as` em testes, ou precisar de dados parciais de teste. Importada de mattpocock/skills.

Constrói um protótipo descartável para responder uma pergunta de design. Use quando o dev quer validar se um modelo de estado/lógica faz sentido, ou explorar como uma UI deveria ficar. Importada de mattpocock/skills.

Como manter .harness/feature_list.json (features com critérios verificáveis) e .harness/baseline.json (métricas de qualidade que só podem melhorar). Define quem escreve o quê (dev vs QA), regras inegociáveis e validação via check-harness.sh. Invoque quando o dev pedir para adicionar feature, atualizar baseline, ou diagnosticar PR bloqueado por feature não verificada.

Investiga uma pergunta contra fontes primárias de alta confiança e captura os achados como um arquivo Markdown no repo. Use quando o dev quer um tópico pesquisado, fatos de docs/API levantados, ou o trabalho braçal de leitura delegado a um agente em background. Importada de mattpocock/skills.

Use quando precisar resolver um conflito de merge/rebase do git em andamento. Importada de mattpocock/skills.

Cria estruturas de diretório de exercícios com sections, problems, solutions e explainers que passam no lint. Invoque quando o dev quiser criar esqueletos de exercícios ou configurar uma nova section de curso. Importada de mattpocock/skills.

Auditoria de segurança completa do projeto (6 categorias: isolamento de tenant, autorização client-side, IDOR, segredos hardcoded, XSS, armazenamento inseguro de token de auth), com relatório em PDF e issues prontas para o tracker. Invoque para validação final antes de release/PR develop→main, ou na FASE 0 do bootstrap quando o projeto já tem código (para surfacear falhas logo no início). Diferente da skill genérica `security-review` (revisão de diff) — esta é uma auditoria completa do código-fonte, mais pesada, com saída em PDF.

Rituais obrigatórios de início e fim de sessão para evitar perda de contexto entre conversas. Invoque automaticamente no PRIMEIRO turno de toda sessão (mesmo antes da tarefa concreta) e novamente quando o dev sinalizar fim de sessão (palavras como "vamos parar", "encerramos por hoje", "obrigado, é isso"). Cobre wake-up do MemPalace, search direcionado antes de decisões, e a verificação de que decisões notáveis viraram drawer.

Configura o pouco que as skills importadas de mattpocock/skills ainda precisam decidir por projeto: mapeamento dos labels de triage e o layout dos docs de domínio (CONTEXT.md/ADR). Rode uma vez por projeto antes de usar `triage`, `domain-modeling` ou `grill-with-docs`. Tracker de issues já é fixo (Forgejo) — não pergunte sobre isso.

Configura hooks de pre-commit do Husky com lint-staged (Prettier), type checking e testes no repositório atual. Invoque quando o dev quiser adicionar hooks de pre-commit, configurar Husky, configurar lint-staged, ou adicionar formatação/typecheck/testes no momento do commit. Importada de mattpocock/skills.

Test-driven development (red-green-refactor). Invoque quando o dev quer construir feature ou corrigir bug test-first, menciona "red-green-refactor", ou quer testes de integração. Referência agnóstica de stack — importada de mattpocock/skills.

Ensina o dev uma skill ou conceito novo, dentro deste workspace.

Transforma uma decisão que você não consegue responder sozinho num questionário para outra pessoa preencher.

Transforma a conversa atual em uma spec e publica como issue no Forgejo: sem entrevista, só síntese do que já foi discutido. Importada de mattpocock/skills.

Quebra um plano, spec, ou a conversa atual em um conjunto de tickets tracer-bullet, cada um declarando suas dependências (bloqueios), publicados como issues no Forgejo com os labels e milestones do workflow-issues. Importada de mattpocock/skills.

Move issues e PRs externas do Forgejo por uma máquina de estados de papéis de triagem, categoriza, verifica, "grilla" se preciso, e escreve briefs prontos para agente. Importada de mattpocock/skills.

Para. Essa última mensagem não fez sentido: repita o pitch.

Planeja um pedaço grande de trabalho (maior do que uma sessão de agente aguenta) como um mapa compartilhado de tickets de decisão no Forgejo, e resolve esses tickets um de cada vez até a rota até o destino ficar clara. Importada de mattpocock/skills.

Gera um wizard interativo em bash que guia um humano por passos que só ele pode executar. Use ao provisionar infraestrutura, configurar credenciais ou secrets de CI, navegar um dashboard de terceiros desconhecido, ou rodar uma migração/corte pontual. Não invoque para passos que o agente consegue executar sozinho. Importada de mattpocock/skills.

Escrever documentos para agentes. Invoque ao criar ou editar skills, ou ao modificar AGENTS.md ou CLAUDE.md.