Skip to content

getting-started.md

Latest commit

 

History

History
119 lines (81 loc) · 2.49 KB

getting-started.md

File metadata and controls

119 lines (81 loc) · 2.49 KB
Raw

Getting Started

Objetivo de esta guía

Ayudarte a usar devSteps aunque estés empezando desde cero, tanto en desarrollo general como en el uso de agentes como Codex o Claude Code.

1. Instala prerrequisitos

  • Node.js 20 o superior
  • Git
  • Una terminal
  • Opcional: Codex, Claude Code, OpenCode, Cursor o Windsurf

Guías específicas:

2. Instala SP-devSteps

npm install -g sp-devsteps

Para usar la copia local del repositorio:

npm install
npm run build
npm link

3. Crea tu primer proyecto

mkdir mi-primer-proyecto
cd mi-primer-proyecto
devsteps scaffold --name "Mi Primer Proyecto" --type web-app --stack typescript,node --force

4. Verifica que el proyecto generado cumple el estándar

devsteps validate

5. Instala dependencias del proyecto generado

npm install
npm run build
npm test

6. Recorre la experiencia guiada

devsteps guide

Este es el punto de entrada recomendado si todavía no sabes bien en qué orden hacer las cosas.

Puedes trabajar de dos formas: directamente en la terminal con devsteps guide, devsteps validate y devsteps run, o desde un editor agéntico después de ejecutar devsteps inject.

7. Activa el modo skill para agentes

devsteps inject

Esto genera archivos que explican a los agentes cómo deben trabajar dentro del proyecto.

8. Activa la capa de gobernanza con DevControl

Si vas a trabajar con agentes reales, esta es la combinación recomendada:

git init
sp-devcontrol init
sp-devcontrol inject
sp-devcontrol project:check

Con esto el proyecto tendrá repositorio Git, contexto de pipeline y reglas/gates de gobernanza.

9. Configura el editor

VS Code

devsteps plugins --install vscode

GitHub Actions

devsteps plugins --install github-actions

OpenCode / MCP

Edita opencode.json según tu entorno para conectar servicios MCP.

10. Valida antes de avanzar

devsteps validate

Flujo de trabajo recomendado

  1. Crea el proyecto con devsteps scaffold.
  2. Usa devsteps guide.
  3. Inyecta devsteps inject.
  4. Si habrá agentes, ejecuta git init, sp-devcontrol init, sp-devcontrol inject y revisa sp-devcontrol project:check.
  5. Documenta diseño y arquitectura.
  6. Ejecuta cambios.
  7. Corre tests y validación.
  8. Publica con commits convencionales.