Repolode
Enviar
ruvnet

ruvnet/sparc

Um fluxo de engenharia condicionado a evidências que aplica as cinco fases do SPARC (Specification, Pseudocode, Architecture, Refinement, Completion) por meio de uma máquina de estados em TypeScript, CLI e servidor MCP.

Ver no GitHub
Estrelas
479
Forks
91
Issues abertas
38
Último commit
há 7 dias

O que é?

SPARC é um framework de fluxo de trabalho para mudanças de software que aplica as cinco fases — Specification, Pseudocode, Architecture, Refinement e Completion — por meio de código, em vez de depender de prompts. Cada fase exige artefatos específicos e só avança quando sua etapa de validação é aprovada. As alterações precisam corresponder à revisão atual, e as tentativas repetidas reproduzem apenas a solicitação original exata.

O projeto oferece uma CLI npm e transportes MCP locais via stdio e remotos via Streamable HTTP, além de skills compartilhadas para Claude e hosts compatíveis com OpenAI. Para concluir, é preciso apresentar evidências aprovadas e atestadas por um verificador para cada teste de aceitação incluído no escopo; as evidências podem ser verificadas com assinaturas Ed25519. As execuções são isoladas por principal autenticado, o estado é gravado atomicamente com permissões de arquivo restritas e as cadeias de recibos são verificadas ao carregar.

O SPARC registra evidências de desenvolvimento, mas não executa os comandos dos testes de aceitação armazenados em uma execução. A CLI Python das versões anteriores continua disponível como interface de compatibilidade.

Recursos principais

  • 01Aplica as cinco fases do SPARC em ordem, com etapas de validação determinísticas.
  • 02Usa verificações de revisão e chaves de idempotência para evitar alterações conflitantes ou repetidas.
  • 03Exige evidências de teste assinadas e atestadas por um verificador antes da conclusão.
  • 04Oferece uma CLI npm e servidores MCP locais e remotos.
  • 05Mantém o estado privado, gravado atomicamente e protegido contra adulteração.

Casos de uso

  • Executar mudanças de código assistidas por IA com etapas de validação auditáveis e evidências de teste.
  • Disponibilizar um fluxo de desenvolvimento estruturado para Claude ou Codex por meio do MCP.
  • Exigir resultados de verificação assinados antes de aceitar uma mudança como concluída.

Início rápido

  1. 1

    Verifique a instalação com o comando doctor (requer Node.js 20 ou superior).

    npx --yes @ruvnet/sparc@1.0.0 doctor
  2. 2

    Inicialize o estado do SPARC.

    npx --yes @ruvnet/sparc@1.0.0 init
  3. 3

    Crie um arquivo JSON de definição de execução com requisitos e testes de aceitação e, em seguida, inicie uma execução.

Antes de usar

  • Para verificar evidências de aprovação e exceção, é necessário configurar chaves públicas de verificação Ed25519 em todos os processos que leem ou gravam o estado.
  • O uso remoto do MCP requer um proxy reverso HTTPS autenticado e um provedor de identidade externo.

Em coleções

Ferramentas, skills e plugins para Claude CodeServidores MCPFerramentas de CLI e terminal

Tópicos

#workflow#state-machine#mcp#cli#typescript#llm-agents#evidence#claude

Perguntas frequentes

O que é sparc?
Um fluxo de engenharia condicionado a evidências que aplica as cinco fases do SPARC (Specification, Pseudocode, Architecture, Refinement, Completion) por meio de uma máquina de estados em TypeScript, CLI e servidor MCP. SPARC é um framework de fluxo de trabalho para mudanças de software que aplica as cinco fases — Specification, Pseudocode, Architecture, Refinement e Completion — por meio de código, em vez de depender de prompts. Cada fase exige artefatos específicos e só avança quando sua etapa de validação é aprovada. As alterações precisam corresponder à revisão atual, e as tentativas repetidas reproduzem apenas a solicitação original exata.
sparc é gratuito? Qual é a licença?
sparc é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
sparc ainda é mantido?
Manutenção ativa. O último commit de sparc foi em 31 de out. de 2026.
Para que posso usar sparc?
Executar mudanças de código assistidas por IA com etapas de validação auditáveis e evidências de teste. Disponibilizar um fluxo de desenvolvimento estruturado para Claude ou Codex por meio do MCP. Exigir resultados de verificação assinados antes de aceitar uma mudança como concluída.
Como instalar sparc?
Verifique a instalação com o comando doctor (requer Node.js 20 ou superior).: npx --yes @ruvnet/sparc@1.0.0 doctor Inicialize o estado do SPARC.: npx --yes @ruvnet/sparc@1.0.0 init Crie um arquivo JSON de definição de execução com requisitos e testes de aceitação e, em seguida, inicie uma execução.
Onde consigo sparc?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/ruvnet/sparc

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

Projetos relacionados