Repolode
Enviar
truecourse-ai

truecourse-ai/truecourse

Gera testes end-to-end com Playwright a partir de PRDs, ADRs e READMEs e sinaliza quando o produto e a documentação divergem.

Ver no GitHubSite
Estrelas
538
Forks
44
Issues abertas
52
Último commit
há 24 dias

O que é?

O TrueCourse lê a documentação que a equipe já produz, como PRDs, ADRs, READMEs e sites de documentação, e a organiza em um conjunto de afirmações. Em seguida, identifica os fluxos percorridos pelos usuários no produto e escreve um teste para cada um, usando as interfaces em execução.

Quando um teste falha, isso significa que o produto e a documentação deixaram de estar alinhados, e a falha indica a afirmação específica envolvida. Os testes são escritos como specs do Playwright, cada um com seus próprios dados seed para que os testes não compartilhem estado. A ferramenta funciona com um login do Claude Code e inclui um modo local que não exige login, além de verificações de pull requests por meio de um GitHub App.

O projeto usa TypeScript, um monorepo com pnpm e PostgreSQL. Ele disponibiliza um endpoint MCP para que o Claude Code possa ler documentos, fluxos, execuções e falhas do workspace.

Recursos principais

  • 01Transforma PRDs, ADRs, READMEs e sites de documentação em um conjunto de afirmações que podem ser testadas.
  • 02Escreve testes end-to-end com Playwright para cada fluxo de usuário, usando o produto em execução.
  • 03Informa quais testes falharam e qual afirmação da documentação eles contradizem.
  • 04Verifica pull requests no GitHub em busca de conflitos na documentação e falhas nos testes.
  • 05Disponibiliza um endpoint MCP para que o Claude Code consulte os resultados do workspace.

Casos de uso

  • Verificar se o produto ainda se comporta conforme descrito no PRD e na documentação para usuários.
  • Detectar divergências entre registros de decisões de arquitetura e o sistema em execução.
  • Executar verificações baseadas na documentação em pull requests antes do merge.

Início rápido

  1. 1

    Copie o arquivo de ambiente de exemplo

    cp .env.example .env
  2. 2

    Inicie o Postgres com Docker Compose

    docker compose up -d
  3. 3

    Instale as dependências

    pnpm install
  4. 4

    Inicie o servidor de desenvolvimento e abra http://localhost:3000

    pnpm dev

Antes de usar

  • É necessário fazer login no Claude Code e ter o binário claude no PATH.
  • O CLI npm truecourse foi descontinuado e não recebe mais manutenção.
  • Para usar o código de ee/ em produção, é necessária uma assinatura Enterprise.

Em coleções

Frameworks e apps de agentes de IA open sourceFrameworks de teste e ferramentas de automação de testesGeradores de sites estáticos e ferramentas de documentação

Tópicos

#testing#end-to-end-testing#documentation#llm#test-automation#playwright#agents#ai#developer-tools#typescript

Perguntas frequentes

O que é truecourse?
Gera testes end-to-end com Playwright a partir de PRDs, ADRs e READMEs e sinaliza quando o produto e a documentação divergem. O TrueCourse lê a documentação que a equipe já produz, como PRDs, ADRs, READMEs e sites de documentação, e a organiza em um conjunto de afirmações. Em seguida, identifica os fluxos percorridos pelos usuários no produto e escreve um teste para cada um, usando as interfaces em execução.
truecourse é gratuito? Qual é a licença?
truecourse é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
truecourse ainda é mantido?
Manutenção ativa. O último commit de truecourse foi em 14 de out. de 2026.
Para que posso usar truecourse?
Verificar se o produto ainda se comporta conforme descrito no PRD e na documentação para usuários. Detectar divergências entre registros de decisões de arquitetura e o sistema em execução. Executar verificações baseadas na documentação em pull requests antes do merge.
Como instalar truecourse?
Copie o arquivo de ambiente de exemplo: cp .env.example .env Inicie o Postgres com Docker Compose: docker compose up -d Instale as dependências: pnpm install Inicie o servidor de desenvolvimento e abra http://localhost:3000: pnpm dev
Onde consigo truecourse?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/truecourse-ai/truecourse

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados