QA Studio
Extensão para VS Code que coloca automação e inteligência artificial nas mãos de times de negócio — sem exigir conhecimento técnico. Analistas, gerentes e especialistas de negócio planejam, validam e garantem a qualidade de produtos digitais com autonomia, rastreabilidade e eficiência.
O usuário pensa em Releases, Componentes, Cenários e Resultados Esperados — nunca em arquivos, scripts ou comandos. A complexidade técnica (IA, Playwright, chamadas HTTP, Page Objects) acontece nos bastidores.
Principais recursos
- Gestão de qualidade orientada ao negócio — projetos, releases, sistemas-alvo, componentes e cenários de teste em uma árvore navegável na Activity Bar.
- Geração de cenários com IA — o Claude Code sugere cenários de teste a partir do contexto do projeto; o usuário revisa, edita e aprova antes de salvar.
- Automação de ponta a ponta — testes de usuário (frontend, via Playwright) e testes de componente (backend, via HTTP), na mesma experiência unificada.
- Execução determinística — os testes preparados rodam sem IA, de forma reproduzível, com histórico imutável de execuções.
- Rastreabilidade nativa — tudo é persistido em
.qa-studio/ (XML versionável via Git). Trilha de auditoria sem banco de dados externo.
- Segurança de credenciais — segredos pessoais ficam em
vscode.SecretStorage, nunca no XML nem no Git.
Requisitos
- VS Code
^1.85.0
- Claude Code CLI instalado e acessível no
PATH (ou configure o caminho em qa.studio.claudeCodePath)
- Node.js (para desenvolvimento da extensão)
Instalação
A partir do .vsix gerado:
npm run package # gera qa-studio-<versão>.vsix
Instale o pacote pelo VS Code (Extensions: Install from VSIX...) ou via linha de comando:
code --install-extension qa-studio-<versão>.vsix
Ao ativar, a extensão instala as skills necessárias em ~/.claude/skills/.
Uso
- Abra a view QA Studio na Activity Bar.
- Crie seu primeiro projeto com Novo Projeto.
- Cadastre uma release, um sistema-alvo e componentes de negócio.
- Gere cenários com IA, revise e aprove.
- Prepare a automação (frontend ou backend) e execute de forma determinística.
Todos os dados ficam em .qa-studio/ dentro do workspace aberto — versione essa pasta no Git para manter o histórico e habilitar colaboração.
Configurações
| Configuração |
Padrão |
Descrição |
qa.studio.claudeCodePath |
claude |
Caminho do executável do Claude Code CLI usado na geração de cenários. |
qa.studio.automationTimeoutMs |
1800000 |
Tempo máximo (ms) para a preparação agêntica da automação. |
qa.studio.executionTimeoutMs |
120000 |
Tempo máximo (ms) para uma execução determinística. |
qa.studio.automationRehearsalMaxAttempts |
3 |
Máximo de tentativas de autocorreção durante o ensaio da automação. |
Desenvolvimento
npm run dev # tsc --watch + vite build --watch (via concurrently)
npm run build # build de produção (tsc + vite build)
npm run compile # apenas tsc (Extension Host)
npm run watch # alias para tsc --watch
npm run package # gera o .vsix via vsce
Para depurar, pressione F5 no VS Code para abrir um Extension Development Host. Não há suíte de testes automatizados.
Arquitetura em resumo
- Extension Host (
src/, build via tsc → out/): módulos que implementam QAModule, gerenciados pelo ModuleRegistry. O core/ concentra infraestrutura compartilhada (FileSystemService, WebviewManager, MessageBus, SecretService, SkillInstaller).
- Webview UI (
webview-ui/, build via Vite → webview-ui/dist/): React 18 em sandbox de browser, sem acesso a Node.js. Comunica com o Extension Host por postMessage tipado (src/shared/types/messages.types.ts).
- Persistência: XML com CDATA em
.qa-studio/, versionável via Git.
- IA: o
ClaudeRunner spawna o claude como subprocesso (sem shell), com servidores MCP locais (QAMCPServer, AutomationMCPServer).
Consulte ARCHITECTURE.md, DESIGN.md e PRODUCT.md para detalhes.
Licença
GPL-3.0-or-later.
