Repolode
Enviar
ruvnet

ruvnet/sparc

Un flujo de ingeniería condicionado por evidencias que aplica las cinco fases de SPARC mediante una máquina de estados en TypeScript, una CLI y un servidor MCP.

Ver en GitHub
Estrellas
479
Forks
91
Issues abiertos
38
Último commit
hace 7 días

¿Qué es?

SPARC es un framework de flujos de trabajo para cambios de software que aplica las cinco fases —Specification, Pseudocode, Architecture, Refinement y Completion— mediante código, en lugar de depender de prompts. Cada fase requiere artefactos específicos y solo se puede avanzar cuando se supera su control. Las modificaciones deben corresponder a la revisión actual, y los reintentos reproducen únicamente la solicitud original exacta.

El proyecto incluye una CLI de npm y transportes MCP locales mediante stdio y remotos mediante Streamable HTTP, además de skills compartidas para Claude y hosts compatibles con OpenAI. Para completar una ejecución, se requieren evidencias aprobadas y certificadas por un verificador para cada prueba de aceptación incluida en el alcance; las evidencias pueden verificarse con firmas Ed25519. Las ejecuciones están aisladas por principal autenticado, el estado se escribe de forma atómica con permisos de archivo restringidos y las cadenas de recibos se verifican al cargar.

SPARC registra evidencias de desarrollo, pero no ejecuta los comandos de pruebas de aceptación almacenados en una ejecución. La CLI de Python de versiones anteriores sigue disponible como interfaz de compatibilidad.

Funciones clave

  • 01Aplica en orden las cinco fases de SPARC mediante controles deterministas.
  • 02Usa comprobaciones de revisión y claves de idempotencia para evitar modificaciones en conflicto o repetidas.
  • 03Exige evidencias de pruebas firmadas y certificadas por un verificador antes de completar el proceso.
  • 04Ofrece una CLI de npm y servidores MCP locales y remotos.
  • 05Mantiene el estado privado, escrito de forma atómica y a prueba de manipulaciones.

Casos de uso

  • Ejecutar cambios de código asistidos por IA con controles de fase auditables y evidencias de pruebas.
  • Ofrecer a Claude o Codex un flujo de desarrollo estructurado mediante MCP.
  • Exigir resultados de verificación firmados antes de aceptar que un cambio está completo.

Inicio rápido

  1. 1

    Comprueba la instalación con el comando doctor (requiere Node.js 20 o posterior).

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

    Inicializa el estado de SPARC.

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

    Crea un archivo JSON de definición de ejecución con requisitos y pruebas de aceptación y, después, inicia una ejecución.

Antes de usarlo

  • Para verificar las evidencias de aprobación y excepción, hay que configurar claves públicas de verificación Ed25519 en todos los procesos que lean o escriban el estado.
  • El uso remoto de MCP requiere un proxy inverso HTTPS autenticado y un proveedor de identidad externo.

En colecciones

Herramientas, skills y plugins para Claude CodeServidores MCPHerramientas de CLI y terminal

Temas

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

Preguntas frecuentes

¿Qué es sparc?
Un flujo de ingeniería condicionado por evidencias que aplica las cinco fases de SPARC mediante una máquina de estados en TypeScript, una CLI y un servidor MCP. SPARC es un framework de flujos de trabajo para cambios de software que aplica las cinco fases —Specification, Pseudocode, Architecture, Refinement y Completion— mediante código, en lugar de depender de prompts. Cada fase requiere artefactos específicos y solo se puede avanzar cuando se supera su control. Las modificaciones deben corresponder a la revisión actual, y los reintentos reproducen únicamente la solicitud original exacta.
¿sparc es gratuito? ¿Qué licencia tiene?
sparc es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿sparc sigue mantenido?
Mantenimiento activo. El último commit de sparc fue el 31 oct 2026.
¿Para qué puedo usar sparc?
Ejecutar cambios de código asistidos por IA con controles de fase auditables y evidencias de pruebas. Ofrecer a Claude o Codex un flujo de desarrollo estructurado mediante MCP. Exigir resultados de verificación firmados antes de aceptar que un cambio está completo.
¿Cómo se instala sparc?
Comprueba la instalación con el comando doctor (requiere Node.js 20 o posterior).: npx --yes @ruvnet/sparc@1.0.0 doctor Inicializa el estado de SPARC.: npx --yes @ruvnet/sparc@1.0.0 init Crea un archivo JSON de definición de ejecución con requisitos y pruebas de aceptación y, después, inicia una ejecución.
¿Dónde consigo sparc?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/ruvnet/sparc

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados