Skip to content

scanoss-qg/openspec-tutorial

Repository files navigation

OpenSpec: Zero to Hero 🚀

Tutorial progresivo de OpenSpec — el framework de Spec-Driven Development (SDD) para trabajar con asistentes de IA de forma predecible y organizada.

¿Qué es OpenSpec?

OpenSpec agrega una capa de especificación liviana entre vos y tu asistente de IA. En lugar de escribir prompts vagos y esperar lo mejor, primero alineás en qué vas a construir, cómo, y recién entonces el AI genera código.

Sin OpenSpec:  "agregá dark mode"   →  AI hace lo que quiere  →  💥
Con OpenSpec:  /opsx:new dark-mode  →  acordás el spec  →  /opsx:apply  →  ✅

El hilo conductor: CryptoScan CLI

A lo largo del tutorial construiremos CryptoScan, una herramienta de línea de comandos que detecta algoritmos criptográficos en código fuente — usando OpenSpec para gestionar cada feature del desarrollo.

🗺️ Mapa de aprendizaje

Lección Tema Concepto clave
01 ¿Qué es SDD y OpenSpec? El problema que resuelve
02 Instalación e init Setup del proyecto
03 Estructura de carpetas specs/ vs changes/
04 Primera propuesta proposal.md
05 Specs y escenarios Given/When/Then + RFC 2119
06 Design y Tasks design.md + tasks.md
07 Apply Implementar desde el spec
08 Archive y ciclo completo Consolidar specs
09 Múltiples cambios Paralelos, dependencias
10 Patrones avanzados Brownfield, equipos, perfiles

🛠️ Requisitos

  • Node.js 20.19.0 o superior
  • Un asistente de IA compatible (Claude Code, Cursor, Copilot, etc.)
node --version   # debe ser >= 20.19.0
npm install -g @fission-ai/openspec@latest
openspec --version

📌 Cómo usar este repositorio

Cada carpeta contiene:

  • README.md — Explicación teórica y conceptos
  • ejemplo/ — Archivos de OpenSpec en el estado de esa lección (lo que genera el AI)
  • ejercicios.md — Ejercicios prácticos con soluciones

Se recomienda seguir las lecciones en orden ya que cada una construye sobre la anterior.

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors