Об этом проекте

Specrails Core — это Node.js CLI и фреймворк для specification-driven разработки ПО. Он устанавливает базовые роли — архитектор, разработчик и рецензент — в проект и предоставляет provider-native команды для Claude Code, Codex CLI, Gemini CLI и Kimi Code. Ожидаемый поток: Specification → Architecture → Implementation → Review → Delivery; архитектор создаёт предложение 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/. Стэндалон установки обычно копируют коммитируемые артефакты в репозиторий и используют общий store фреймворка под ~/.specrails/; перемещённые или Desktop-управляемые рабочие пространства могут хранить ссылки фреймворка и проектные артефакты вне checkout. Управляемые файлы можно регенерировать обновлениями; пользовательские расширения должны использовать документированные пути, такие как .specrails/profiles/** и custom-* роли. Обновления отдельно от обновления исполняемого файла: npx specrails-core@latest update --dry-run, update, doctor. Существующие выборы провайдеров сохраняются текущей реализацией обновления; текущий источник отвергает перезапись более нового установленного фреймворка более старым CLI. Миграция с Core 4 удаляет команду enrich, уровни быстрой/полной установки и встроенных не core специалиста агентов; пользовательские агенты следует переместить в защищённые custom-* роли и обновить ссылки профилей. Опциональный программный runtime агентов включает: общий LangGraph workflow с провайдерами на роль, durable recovery и локальные OpenAI-совместимые модели, экспонируемые через TypeScript API и CLI. Стэндалон автоматическая доставка может создавать ветки, коммиты, push и pull requests при включении; GitHub pull requests требуют аутентифицированный gh CLI. Хосты, такие как Specrails Desktop, могут устанавливать SPECRAILS_GIT_AUTO=false и управлять worktrees и доставкой. Мультирепозиторийные контексты должны явно идентифицировать выбранные репозитории и владельца OpenSpec/backlog. Конфигурация, спецификации и состояние выполнения — локальные файлы, но provider CLSI передают контекст в настроенные модели, а установка пакетов, GitHub/Jira и MCP интеграции могут использовать сеть. Использование моделей оплачивается провайдером. Проект под MIT лицензией, требует Node.js 20.19.0+ с Git и хотя бы одним аутентифицированным AI CLI; разработка из исходников использует npm ci, npm test, npm run build, typecheck и coverage команды.