specrails-core

Specrails Core é uma CLI e um framework de fluxo de trabalho de agente para desenvolvimento de software orientado por especificações. Ele instala funções básicas — arquiteto, desenvolvedor e revisor — em um projeto e expõe comandos nativos do provedor para Claude Code, Codex CLI, Gemini CLI e Kimi Code. O fluxo de trabalho pretendido é Especificação → Arquitetura → Implementação → Revisão → Entrega; o arquiteto produz uma proposta OpenSpec, design e tarefas, o desenvolvedor implementa o trabalho acordado e o revisor verifica os resultados em relação à especificação e aos comandos de verificação do projeto. Instalação a partir de um projeto: npx specrails-core@latest init --provider claude (escolha claude, codex, gemini ou kimi). Não interativo: npx specrails-core@latest init --yes --provider claude. Os provedores usam comandos nativos como /specrails:implement, $implement e /skill:specrails-implement. A integração com Kimi é direcionada ao Kimi Code 0.27.0+ e usa .kimi-code/specrails/run-skill.mjs para ativação sem cabeça. O Core 5 instala funções e fluxos de trabalho diretamente sem invocar um modelo para uma fase de enriquecimento. As superfícies instaladas incluem diretórios de provedores (.claude, .codex, .gemini, .kimi-code), especificações openspec/ e artefatos de mudança, .specrails/config.yaml e install-config.yaml, .specrails/rules/ e agent-memory/, .specrails/runtime/ e pipeline/, optional .specrails/local-tickets.json, e .specrails/profiles/. Instalações autônomas normalmente copiam artefatos comprometíveis para o repositório e usam um armazenamento de framework compartilhado em ~/.specrails/; workspaces realocados ou gerenciados pelo Desktop podem manter links de framework e artefatos de projeto fora do checkout. Arquivos gerenciados podem ser regenerados por atualizações; extensões de usuário devem usar caminhos documentados como .specrails/profiles/** e roles custom-*. As atualizações são separadas da atualização do executável: npx specrails-core@latest update --dry-run, update, doctor. As seleções de provedor existentes são preservadas pela implementação de atualização atual; a fonte atual rejeita uma CLI mais antiga sobrescrevendo um framework instalado mais recente. A migração do Core 4 remove o comando enrich, os níveis de instalação rápida/completa e os agentes especialistas não principais embutidos; agentes personalizados devem ser movidos para roles custom-* protegidos e as referências de perfil devem ser atualizadas. Um runtime de agente programático opt-in está incluído: um fluxo de trabalho LangGraph compartilhado com provedores por função, recuperação durável e modelos locais compatíveis com OpenAI, exposto por meio de uma API TypeScript e CLI. A entrega automática autônoma pode criar branches, commits, pushes e pull requests quando habilitada; pull requests do GitHub requerem uma CLI gh autenticada. Hosts como o Specrails Desktop podem definir SPECRAILS_GIT_AUTO=false e assumir o controle das árvores de trabalho e da entrega. Contextos de vários repositórios devem identificar explicitamente os repositórios selecionados e o proprietário do OpenSpec/backlog. Configuração, especificações e estado de execução são arquivos locais, mas as CLIs do provedor enviam o contexto fornecido para serviços de modelo configurados, e a instalação de pacotes, integrações com GitHub/Jira e MCP podem usar a rede. O uso do modelo é cobrado pelo provedor. O projeto é licenciado sob a MIT e requer Node.js 20.19.0+ com Git e pelo menos uma CLI de IA autenticada; o desenvolvimento a partir do código-fonte usa os comandos npm ci, npm test, npm run build, typecheck e coverage.