specrails-core

Specrails Core es un marco de CLI y flujo de trabajo de agentes para el desarrollo de software impulsado por especificaciones. Instala roles de base —arquitecto, desarrollador y revisor— en un proyecto y expone comandos nativos del proveedor para Claude Code, Codex CLI, Gemini CLI y Kimi Code. El flujo previsto es Especificación → Arquitectura → Implementación → Revisión → Entrega; el arquitecto produce una propuesta, diseño y tareas de OpenSpec, el desarrollador implementa el trabajo acordado, y el revisor verifica los resultados frente a la especificación y los comandos de verificación del proyecto. La instalación desde un proyecto es: npx specrails-core@latest init --provider claude (elige claude, codex, gemini o kimi). No interactiva: npx specrails-core@latest init --yes --provider claude. Los proveedores usan comandos nativos como /specrails:implement, $implement, y /skill:specrails-implement. La integración de Kimi apunta a Kimi Code 0.27.0+ y usa .kimi-code/specrails/run-skill.mjs para la activación sin cabeza. Core 5 instala roles y flujos de trabajo directamente sin invocar un modelo para una fase de enriquecimiento. Las superficies instaladas incluyen directorios de proveedores (.claude, .codex, .gemini, .kimi-code), specs de openspec/ y artefactos de cambio, .specrails/config.yaml e install-config.yaml, .specrails/rules/ y agent-memory/, .specrails/runtime/ y pipeline/, opcional .specrails/local-tickets.json, y .specrails/profiles/. Las instalaciones independientes normalmente copian artefactos comprometibles en el repositorio y usan un almacén de marco compartido en ~/.specrails/; los espacios de trabajo reubicados o gestionados por Desktop pueden mantener enlaces de marco y artefactos de proyecto fuera del checkout. Los archivos gestionados pueden ser regenerados por actualizaciones; las extensiones de usuario deben usar rutas documentadas como .specrails/profiles/** y roles custom-*. Las actualizaciones son separadas de refrescar el ejecutable: npx specrails-core@latest update --dry-run, update, doctor. Las selecciones de proveedor existentes son preservadas por la implementación de actualización actual; la fuente actual rechaza que una CLI más antigua sobrescriba un marco instalado más nuevo. Migrando desde Core 4, se elimina el comando enrich, los niveles de instalación rápida/completa y los agentes especialistas no centrales incluidos; los agentes personalizados deben ser movidos a roles custom-* protegidos y se deben actualizar las referencias de perfil. Se incluye un tiempo de ejecución de agente programático opt-in: un flujo de trabajo de LangGraph compartido con proveedores por rol, recuperación duradera y modelos locales compatibles con OpenAI, expuesto a través de una API de TypeScript y CLI. La entrega automática independiente puede crear ramas, commits, pushes y pull requests cuando está habilitada; los pull requests de GitHub requieren una CLI de gh autenticada. Los hosts como Specrails Desktop pueden establecer SPECRAILS_GIT_AUTO=false y ser propietarios de los worktrees y la entrega. Los contextos de múltiples repositorios deben identificar explícitamente los repositorios seleccionados y el propietario de OpenSpec/backlog. La configuración, las especificaciones y el estado de ejecución son archivos locales, pero las CLI de proveedores envían el contexto suministrado a los servicios de modelo configurados, y la instalación de paquetes, las integraciones de GitHub/Jira y MCP pueden usar la red. El uso del modelo es facturado por el proveedor. El proyecto tiene licencia MIT y requiere Node.js 20.19.0+ con Git y al menos una CLI de IA autenticada; el desarrollo desde la fuente usa los comandos npm ci, npm test, npm run build, typecheck y coverage.