vellus-tech
OrganizationSpec-Driven Development harness — fonte única .forge/, multi-agente (Claude/Codex/Cursor/…), validadores deterministas e code graph nativo (zero-dep).
Categories
Indexed Skills (13)
design-system-creator
Cria um design system completo a partir de um link de handoff do Claude Design (claude.ai/design). Baixa o bundle, lê o README + transcripts + tokens, instala o Storybook e materializa packages/design-tokens, packages/icons e packages/ui-components (primitivos + blocos + telas) além de docs/product/design-system/{design-system,tokens,components,accessibility}.md. Use quando o input for um link "https://api.anthropic.com/v1/design/h/<id>" seguido de "implemente os designs neste projeto" (PT ou EN), ou quando o usuário pedir para criar/implementar um design system a partir de um design do Claude Design.
using-git-worktrees
Use ao iniciar trabalho de feature que precisa de isolamento do workspace atual, ao executar um plano de implementação, ou quando o usuário pedir "worktree", "isolar o ambiente", "trabalhar numa branch separada sem mexer no meu checkout". Garante um workspace isolado via ferramenta nativa do harness ou, na ausência dela, via git worktree manual — com setup do projeto e baseline de testes verde antes de começar.
verify-build
Skill determinística usada pelo `code-evaluator` antes de gastar tokens com reviewers LLM. Detecta a stack do diff (`.cs` → .NET, `.ts/.tsx` → Node, `.java` → Java, `.py` → Python, `.kt/.kts` → Gradle) e roda compilação + testes. Retorna JSON com `passed: true/false`, lista de erros estruturada e métricas (coverage por camada quando disponível). Falha aqui = `REJECTED` imediato, sem chamar reviewers.
verify-diff-claims
Skill determinística usada pelo `code-evaluator` na Fase 1.2 para detectar alucinação textual: confronta o que o coder agent afirmou no commit message / PR description com o que o `git diff` realmente contém. Emite findings `CLAIM-NNN` quando há claim sem evidência (ex.: "adicionei IPaymentRepository" mas o símbolo não existe no diff).
dotnet-quality-scan
Varre código C#/.NET em busca do que o compilador e os analisadores Roslyn não reprovam — `async void`, `.Result`/`.Wait()` bloqueante, `new HttpClient()`, `#region`, nomes genéricos (Manager, Helper, Utils), parâmetro booleano de modo, `catch` vazio, `DateTime.Now`, SQL interpolado, estado estático mutável e interface com implementação única. Determinística: roda `scripts/scan.sh` e emite uma linha por regra, inclusive as que não acharam nada. Use antes de revisar C# ("revisar minhas mudanças", "code review", "olhar a qualidade deste serviço"), no `dotnet-reviewer` e no `/forge:verify` de change que toca `.cs`. Não use para bug de correção, falha de segurança de infraestrutura, ou para stack que não seja .NET.
frontend-ui-review
Revisa implementação de frontend/UI contra o design system, caçando despadronização: tokens fantasma (var(--x) nunca definidos), cores/bordas/espaçamentos hardcoded, controles nativos do browser sem estilo, reimplementação de componentes que o DS já provê, e dado cru (GUID/enum) vazando na tela. Roda gates determinísticos (scan de token/cor/controle nativo, custo zero, sem LLM) ANTES da revisão semântica. Use ao revisar PRs de UI, ao migrar telas para o design system, ao investigar quebra de dark mode, ou antes de declarar uma padronização "concluída". Gatilhos: "revisar UI", "padronização", "dark mode quebrado", "buraco de cor", "token fantasma", "design system", "componente ad-hoc". As convenções de escrita que ela verifica vivem em rules/frontend/design-system.md (§ Contrato de tokens); esta skill é o lado de auditoria.
gate-runner
Executa gates deterministas de uma feature/task — parseabilidade, grep positivo/negativo, anti-empty e smoke com timeout — emitindo UMA linha OK/FAIL por gate, com output bruto em /tmp. Use durante /forge:implement e /forge:verify para validar artefatos gerados sem estourar contexto.
node-quality-scan
Varre código Node/TypeScript em busca do que nem o ESLint com as regras `forge-quality/*` reprova — `.then()` sem `.catch()`, `fs.*Sync()` bloqueando o event loop, `new Pool()`/`new Client()` fora de bootstrap de banco, `process.env` lido direto fora de config central, `new Date()` sem argumento, `any` explícito, nomes genéricos (Manager/Helper/Utils), `let` mutável exportado do módulo, `catch` vazio, interpolação de SQL em template literal e interface com implementação única. Determinística: roda `scripts/scan.sh` e emite uma linha por regra, inclusive as que não acharam nada. Use antes de revisar Node/TS ("revisar minhas mudanças", "code review", "olhar a qualidade deste serviço"), no `node-reviewer` e no `/forge:verify` de change que toca `.ts`/`.tsx`/`.js`/`.jsx`. Não use para bug de correção, falha de segurança de infraestrutura, ou para stack que não seja Node/TypeScript.
c4-render
Gera ou cura diagramas C4 (Mermaid) e o overview.html a partir do grafo de código do Forge, respeitando a convenção de labels (sem pontos, sem em-dash). Use quando o usuário pede um mapa visual da arquitetura, um C4, ou o overview navegável do projeto.
capability-dispatcher
Carrega somente os capability packs Forge aplicáveis à área afetada de uma mudança. Use ao planejar, implementar, revisar ou verificar código quando `.forge/forge.yaml` tiver `capabilities.active`, quando o doctor sugerir um pack de stack, ou quando a tarefa tocar C#/.NET, Node/TypeScript, Java, Python ou migrations relacionais.
impact-scan
Executa análise de impacto reversa sobre o grafo de dependências do projeto — quais módulos são transitivamente alcançados a partir dos arquivos do change. Promovida do script lib/impact-scan.mjs (W4.2). Obrigatória em scale >= 3 antes do archive quando o change toca código.
story-context
Carrega o contexto mínimo de uma story específica do change ativo — lê apenas STORY-NN.md e epic_context.md. Proibido ler fora do escopo da story (sem tasks.md completo, sem design.md completo). Retorna contexto compacto para uso no /forge:implement story a story.
wave-advance
Verifica se a wave atual pode ser fechada e avança para a próxima wave elegível. Checa stories done, deferrals e gates antes de fechar; nega avanço se bloqueado. Operado por scripts deterministas (wave-ops.sh + deferral-ops.sh).
Bio shown is the top-scored skill's repo description as a fallback — real GitHub bios land in a future update.