SP-devSteps es un orquestador de proyectos para gente que quiere empezar desde cero sin perder el control del proceso. Te da una ruta clara para crear, documentar, validar y publicar software, y funciona tanto en terminal como desde editores agénticos.
No reemplaza tu criterio. Te ayuda a aprender el flujo real de desarrollo mientras trabajas con herramientas como Codex, Claude Code, VS Code, Cursor, Windsurf u OpenCode.
- Te dice qué hacer primero, qué validar después y cuándo estás listo para avanzar.
- Evita que dependas de instrucciones dispersas o de un agente que actúa sin contexto.
- Te deja trabajar desde la terminal o desde un editor agéntico con instrucciones ya preparadas.
- Documenta el proyecto para que puedas compartirlo, instalarlo y continuar más adelante sin empezar de nuevo.
SP-devSteps y SP-DevControl están pensados como herramientas hermanas:
SP-devStepsdefine y guía el pipeline del proyecto.SP-DevControlgobierna la ejecución de agentes, cambios, aprobaciones y políticas.
En una instalación completa, devSteps orquesta y DevControl vigila.
- CLI instalable para crear, ejecutar, validar y documentar proyectos.
- Guía paso a paso para recorrer el pipeline completo.
- Generación de archivos de contexto para agentes y editores.
- Integraciones básicas para VS Code, GitHub Actions y entornos MCP.
- Estándar DS-v1 para documentación, setup, seguridad, testing y release.
devSteps puede operar en dos canales de interacción: el usuario puede trabajar directamente en la terminal con el CLI, o puede trabajar desde un editor agéntico donde el agente lee las instrucciones generadas y guía el flujo dentro del proyecto.
Uso principal en terminal:
npm install -g sp-devsteps
devsteps --helpGenera contexto reutilizable para herramientas como Codex, Claude Code, Cursor o Windsurf. Este modo permite que el usuario converse con el agente en el editor mientras el agente sigue el pipeline, DS-v1 y las instrucciones del proyecto:
devsteps injectArchivos generados:
AGENTS.mdCLAUDE.md.cursorrules.windsurfrules
Preparación de entorno para editor o integración:
devsteps plugins --install vscode
devsteps plugins --install github-actionsTambién hay configuraciones de integración en opencode.json y .mcp.json, alineadas con DevControl.
Si tu objetivo es aprender y avanzar paso a paso, esta es la ruta recomendada:
Si necesitas instrucciones por sistema operativo o editor, revisa:
- Node.js 20+
- Git
- Un editor o terminal
- Opcional: Codex, Claude Code, OpenCode, Cursor o Windsurf
npm install -g sp-devstepsPara probar desde este repositorio:
npm install
npm run build
npm linkmkdir mi-primer-proyecto
cd mi-primer-proyecto
devsteps scaffold --name "Mi Primer Proyecto" --type web-app --stack typescript,node --forcedevsteps guidedevsteps injectgit init
sp-devcontrol init
sp-devcontrol inject
sp-devcontrol project:checkCon DevControl ganas validación adicional, políticas y una capa más clara de gobernanza cuando ya estás trabajando con agentes.
devsteps validatenpm install
npm run build
npm test| Comando | Uso |
|---|---|
devsteps init |
Inicializar un proyecto |
devsteps guide |
Recorrer el pipeline con explicación |
devsteps run |
Ejecutar el pipeline |
devsteps validate |
Validar DS-v1 |
devsteps inject |
Generar archivos para agentes |
devsteps docs --all |
Generar documentación base |
devsteps plugins --install vscode |
Preparar VS Code |
devsteps plugins --install github-actions |
Preparar CI en GitHub |
sp-devcontrol init |
Inicializar gobernanza DevControl en el mismo proyecto |
sp-devcontrol inject |
Inyectar reglas de agentes de DevControl |
- Validar idea
- Diseñar
- Inicializar
- Desarrollar
- Verificar
- Revisar
- Release
- Mantener
- Guía inicial
- Instalación en Windows y Linux
- Editores agénticos y MCP
- Requisitos
- Arquitectura
- Publicación
- Contribución
- Seguridad
El proyecto compila, sus tests pasan y el paquete publicado incluye guías para Windows, Linux y editores agénticos. La integración con SP-DevControl queda documentada para uso conjunto.
MIT