इस प्रोजेक्ट के बारे में

Specrails Core एक Node.js CLI और agent workflow framework है जो specification-driven सॉफ़्टवेयर विकास के लिए है। यह baseline roles—architect, developer और reviewer—को एक प्रोजेक्ट में इंस्टॉल करता है और Claude Code, Codex CLI, Gemini CLI और Kimi Code के लिए provider-native commands को expose करता है। intended flow है Specification → Architecture → Implementation → Review → Delivery; architect एक OpenSpec proposal, design और tasks तैयार करता है, developer agreed work को implement करता है, और reviewer results को spec और project verification commands के खिलाफ चेक करता है। Installation from a project: npx specrails-core@latest init --provider claude (claude, codex, gemini या kimi में से चुनें)। Non-interactive: npx specrails-core@latest init --yes --provider claude। Providers native commands का उपयोग करते हैं जैसे /specrails:implement, $implement, और /skill:specrails-implement। Kimi integration Kimi Code 0.27.0+ को target करता है और headless activation के लिए .kimi-code/specrails/run-skill.mjs का उपयोग करता है। Core 5 roles और workflows को सीधे इंस्टॉल करता है बिना enrichment phase के लिए model को invoke किए। Installed surfaces में provider directories (.claude, .codex, .gemini, .kimi-code), openspec/ specs और change artifacts, .specrails/config.yaml और install-config.yaml, .specrails/rules/ और agent-memory/, .specrails/runtime/ और pipeline/, optional .specrails/local-tickets.json, और .specrails/profiles/ शामिल हैं। Standalone installs आमतौर पर committable artifacts को repo में कॉपी करते हैं और ~/.specrails/ के तहत एक shared framework store का उपयोग करते हैं; relocated या Desktop-managed workspaces framework links और project artifacts को checkout के बाहर रख सकते हैं। Managed files को updates द्वारा regenerate किया जा सकता है; user extensions को documented paths जैसे .specrails/profiles/** और custom-* roles का उपयोग करना चाहिए। Updates executable को refresh करने से अलग हैं: npx specrails-core@latest update --dry-run, update, doctor। Existing provider selections को current update implementation द्वारा preserve किया जाता है; current source एक older CLI को newer installed framework को overwrite करने से रोकता है। Core 4 से migrating enrich command, quick/full installation tiers और bundled non-core specialist agents को हटा देता है; custom agents को protected custom-* roles में move किया जाना चाहिए और profile references को update किया जाना चाहिए। एक opt-in programmatic agent runtime शामिल है: per-role providers, durable recovery और local OpenAI-compatible models के साथ एक shared LangGraph workflow, जो TypeScript API और CLI के माध्यम से exposed है। Standalone automatic delivery branches, commits, pushes और pull requests create कर सकता है जब enabled हो; GitHub pull requests के लिए एक authenticated gh CLI की आवश्यकता है। Hosts जैसे Specrails Desktop SPECRAILS_GIT_AUTO=false सेट कर सकते हैं और worktrees और delivery को own कर सकते हैं। Multi-repository contexts को explicitly selected repositories और OpenSpec/backlog owner की पहचान करनी चाहिए। Configuration, specs और run state local files हैं, लेकिन provider CLIs supplied context को configured model services को भेजते हैं, और package installation, GitHub/Jira और MCP integrations network का उपयोग कर सकते हैं। Model usage provider द्वारा billed किया जाता है। प्रोजेक्ट MIT licensed है और Node.js 20.19.0+ with Git और कम से कम एक authenticated AI CLI की आवश्यकता है; source से development npm ci, npm test, npm run build, typecheck और coverage commands का उपयोग करता है।