프로젝트 소개

Specrails Core는 사양 기반 소프트웨어 개발을 위한 Node.js CLI 및 에이전트 워크플로우 프레임워크입니다. 프로젝트에 아키텍트, 개발자 및 리뷰어의 기본 역할을 설치하고, Claude Code, Codex CLI, Gemini CLI 및 Kimi Code에 대한 공급자 고유의 명령을 노출합니다. 의도된 흐름은 사양 → 아키텍처 → 구현 → 리뷰 → 전달이며, 아키텍트는 OpenSpec 제안, 설계 및 작업을 생성하고, 개발자는 합의된 작업을 구현하며, 리뷰어는 결과를 사양 및 프로젝트 검증 명령과 비교합니다. 프로젝트에서 설치: npx specrails-core@latest init --provider claude (claude, codex, gemini 또는 kimi 선택). 비대화식: npx specrails-core@latest init --yes --provider claude. 공급자는 /specrails:implement, $implement, /skill:specrails-implement과 같은 고유 명령을 사용합니다. Kimi 통합은 Kimi Code 0.27.0+를 대상으로 하며, 헤드리스 활성화를 위해 .kimi-code/specrails/run-skill.mjs를 사용합니다. Core 5는 부가 가치 단계 없이 직접 역할과 워크플로우를 설치합니다. 설치된 표면에는 공급자 디렉토리 (.claude, .codex, .gemini, .kimi-code), openspec/ 사양 및 변경 아티팩트, .specrails/config.yaml 및 install-config.yaml, .specrails/rules/ 및 agent-memory/, .specrails/runtime/ 및 pipeline/, 선택적 .specrails/local-tickets.json, 및 .specrails/profiles/가 포함됩니다. 독립형 설치는 일반적으로 커밋 가능한 아티팩트를 저장소로 복사하고 ~/.specrails/ 아래에 공유 프레임워크 저장소를 사용합니다. 재배치되거나 Desktop에서 관리되는 작업 공간은 체크아웃 외부에서 프레임워크 링크와 프로젝트 아티팩트를 유지할 수 있습니다. 관리되는 파일은 업데이트로 재생성할 수 있으며, 사용자 확장은 .specrails/profiles/** 및 custom-* 역할을 사용해야 합니다. 업데이트는 실행 파일 새로 고침과 별개입니다: npx specrails-core@latest update --dry-run, update, doctor. 현재 업데이트 구현은 기존 공급자 선택을 유지합니다. 현재 소스는 더 오래된 CLI가 더 새로운 설치된 프레임워크를 덮어쓰는 것을 거부합니다. Core 4에서 마이그레이션하면 enrich 명령, 빠른/전체 설치 계층 및 번들된 비핵심 전문 에이전트가 제거됩니다. 사용자 정의 에이전트는 보호된 custom-* 역할로 이동하고 프로필 참조를 업데이트해야 합니다. 선택적 프로그래밍 에이전트 런타임이 포함되어 있습니다: 역할별 공급자를 갖춘 공유 LangGraph 워크플로우, 내구성 있는 복구 및 로컬 OpenAI 호환 모델, TypeScript API 및 CLI를 통해 노출됩니다. 독립형 자동 전달은 활성화되면 브랜치, 커밋, 푸시 및 풀 요청을 생성할 수 있습니다. GitHub 풀 요청에는 인증된 gh CLI가 필요합니다. Specrails Desktop과 같은 호스트는 SPECPECRAILS_GIT_AUTO=false를 설정하고 작업 트리와 전달을 소유할 수 있습니다. 다중 저장소 컨텍스트는 선택된 저장소와 OpenSpec/백로그 소유자를 명시적으로 식별해야 합니다. 구성, 사양 및 실행 상태는 로컬 파일이지만, 공급자 CLI는 제공된 컨텍스트를 구성된 모델 서비스로 보내며, 패키지 설치, GitHub/Jira 및 MCP 통합은 네트워크를 사용할 수 있습니다. 모델 사용은 공급자에 의해 청구됩니다. 프로젝트는 MIT 라이선스를 가지며, Node.js 20.19.0+와 Git, 그리고 최소 하나의 인증된 AI CLI가 필요합니다. 소스에서 개발하려면 npm ci, npm test, npm run build, typecheck 및 coverage 명령을 사용합니다.