복잡한 앱과 워크플로 로직을 관리하는 상태 머신, 상태 차트, 액터용 무의존성 JavaScript/TypeScript 라이브러리입니다.
ruvnet/sparc
TypeScript 상태 머신, CLI, MCP 서버를 통해 5단계 SPARC(Specification, Pseudocode, Architecture, Refinement, Completion)를 강제하는 증거 기반 엔지니어링 워크플로입니다.
- 스타
- 479
- 포크
- 91
- 열린 이슈
- 38
- 마지막 커밋
- 7일 전
어떤 프로젝트인가요?
SPARC는 프롬프트에 의존하지 않고 코드로 Specification, Pseudocode, Architecture, Refinement, Completion의 5단계를 강제하는 소프트웨어 변경 워크플로 프레임워크입니다. 각 단계에는 필수 산출물이 있으며, 게이트를 통과해야만 다음 단계로 진행할 수 있습니다. 변경 작업은 현재 리비전과 일치해야 하며, 재시도 시에는 최초 요청과 정확히 동일한 요청만 다시 실행됩니다.
이 프로젝트는 npm CLI와 로컬 stdio 및 원격 Streamable HTTP MCP 전송 방식을 제공하며, Claude와 OpenAI 호환 호스트에서 함께 사용할 수 있는 스킬도 포함합니다. 완료하려면 범위에 포함된 모든 승인 테스트에 대해 검증자가 통과를 확인한 증거가 있어야 하며, Ed25519 서명으로 증거를 검증할 수 있습니다. 실행은 인증된 주체별로 격리되고, 상태는 권한이 제한된 파일 모드로 원자적으로 기록되며, 영수증 체인은 로드 시 검증됩니다.
SPARC는 개발 증거를 기록하지만 실행에 저장된 승인 테스트 명령을 직접 실행하지는 않습니다. 이전 버전의 Python CLI도 호환성 인터페이스로 계속 제공됩니다.
핵심 기능
- 01결정론적 게이트를 통해 5단계 SPARC를 순서대로 강제합니다.
- 02리비전 확인과 멱등성 키를 사용해 충돌하거나 반복되는 변경을 방지합니다.
- 03완료 전에 서명된 검증자 확인 테스트 증거를 요구합니다.
- 04npm CLI와 로컬 및 원격 MCP 서버를 제공합니다.
- 05상태를 비공개로 유지하고 원자적으로 기록해 변조 여부를 확인할 수 있게 합니다.
활용 사례
- 감사 가능한 단계별 게이트와 테스트 증거를 갖춘 AI 지원 코드 변경을 진행합니다.
- MCP를 통해 Claude 또는 Codex에 구조화된 개발 워크플로를 제공합니다.
- 변경을 완료로 승인하기 전에 서명된 검증 결과를 요구합니다.
빠른 시작
- 1
doctor 명령으로 설치를 확인합니다(Node.js 20 이상 필요).
npx --yes @ruvnet/sparc@1.0.0 doctor - 2
SPARC 상태를 초기화합니다.
npx --yes @ruvnet/sparc@1.0.0 init - 3
요구 사항과 승인 테스트가 포함된 run 정의 JSON 파일을 만든 다음 run을 시작합니다.
사용 전 알아둘 점
- 통과 및 예외 증거를 확인하려면 상태를 읽거나 쓰는 모든 프로세스에 Ed25519 검증 공개 키를 구성해야 합니다.
- 원격 MCP를 사용하려면 인증된 HTTPS 리버스 프록시와 외부 ID 공급자가 필요합니다.
포함된 컬렉션
토픽
자주 묻는 질문
- sparc은(는) 무엇인가요?
- TypeScript 상태 머신, CLI, MCP 서버를 통해 5단계 SPARC(Specification, Pseudocode, Architecture, Refinement, Completion)를 강제하는 증거 기반 엔지니어링 워크플로입니다. SPARC는 프롬프트에 의존하지 않고 코드로 Specification, Pseudocode, Architecture, Refinement, Completion의 5단계를 강제하는 소프트웨어 변경 워크플로 프레임워크입니다. 각 단계에는 필수 산출물이 있으며, 게이트를 통과해야만 다음 단계로 진행할 수 있습니다. 변경 작업은 현재 리비전과 일치해야 하며, 재시도 시에는 최초 요청과 정확히 동일한 요청만 다시 실행됩니다.
- sparc은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- sparc은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- sparc은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. sparc의 마지막 커밋은 2026년 10월 31일입니다.
- sparc은(는) 어디에 사용할 수 있나요?
- 감사 가능한 단계별 게이트와 테스트 증거를 갖춘 AI 지원 코드 변경을 진행합니다. MCP를 통해 Claude 또는 Codex에 구조화된 개발 워크플로를 제공합니다. 변경을 완료로 승인하기 전에 서명된 검증 결과를 요구합니다.
- sparc는 어떻게 설치하나요?
- doctor 명령으로 설치를 확인합니다(Node.js 20 이상 필요).: npx --yes @ruvnet/sparc@1.0.0 doctor SPARC 상태를 초기화합니다.: npx --yes @ruvnet/sparc@1.0.0 init 요구 사항과 승인 테스트가 포함된 run 정의 JSON 파일을 만든 다음 run을 시작합니다.
- sparc은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/ruvnet/sparc
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
챗봇과 에이전트 같은 의사결정 애플리케이션을 상태 머신으로 만들고, 추적 및 모니터링을 위한 UI를 제공하는 Python 라이브러리입니다.
Zotero 연구 라이브러리를 Claude, ChatGPT, Cursor 등의 AI 어시스턴트와 연결해 검색·열람·주석을 지원하는 MCP 서버이자 CLI입니다.
FastGPT는 LLM 앱을 위한 데이터 처리, RAG 지식 베이스, 시각적 워크플로 오케스트레이션을 제공하는 오픈소스 AI Agent 구축 플랫폼입니다.
Claude Code, Codex, Cursor 같은 AI 코딩 에이전트에 요구사항, 설계, 작업, 자율 구현을 아우르는 명세 기반 개발 워크플로를 Agent Skills로 설치합니다.
Claude Code를 설정할 수 있도록 바로 사용할 수 있는 에이전트, 명령어, 설정, 훅, MCP 연동을 제공하는 CLI 및 템플릿 카탈로그입니다.