create-sdlc-system v2

Kit SDLC multi-agente orquestado por IA con Azure DevOps como fuente de verdad.

Que es

Un sistema de desarrollo asistido donde multiples agentes de IA (Claude Code) trabajan como un equipo real: planifican, desarrollan, testean, despliegan y gestionan el repositorio. Azure DevOps es la unica fuente de verdad.

Agentes

| Agente | Rol | Que hace | |--------|-----|----------| | ORQUESTADOR | Planificador | Recibe requerimientos, crea tasks en ADO, coordina, documenta Wiki | | DEV | Desarrollador | Toma tasks, escribe codigo en ramas feature/bugfix, reporta | | QA | Tester | Valida tasks con Playwright, escribe tests, unico que cierra tasks | | DEVOPS | Infraestructura | Recursos Azure, pipelines CI/CD, deployments | | GIT-MASTER | Git | Mergea ramas, resuelve conflictos, controla flujo git |

Instalacion

npx create-sdlc-system

El installer te pide la URL de tu proyecto en Azure DevOps y genera la carpeta sdlc-system/ lista para usar.

El team y las ramas de ambiente se detectan automaticamente al iniciar sesion.

Uso

cd tu-proyecto/sdlc-system
claude

Selecciona el agente con el que quieras trabajar. El agente se conecta a ADO, lee el estado actual del proyecto y te muestra un resumen para retomar donde quedaste.

Flujo

Humano (tu) ←→ ORQUESTADOR ←→ Azure DevOps
                                    ↕
                        DEV toma tasks y desarrolla
                        QA valida y cierra tasks
                        GIT-MASTER mergea ramas
                        DEVOPS despliega a ambientes

Flujo de una task

1. ORQUESTADOR crea task en ADO
2. DEV la toma, crea rama feature/task-<id>, desarrolla
3. DEV marca lista para QA
4. QA valida con Playwright, escribe tests, aprueba o rechaza
5. Si aprobada → QA cierra la task
6. GIT-MASTER mergea la rama a dev
7. Cuando el sprint cierra → GIT-MASTER mergea dev → qa → prod
8. DEVOPS despliega a los ambientes

Git flow

feature/task-<id>  →  dev  →  qa  →  prod
bugfix/task-<id>   →  dev  →  qa  →  prod
hotfix/task-<id>   →  prod (+ backport a dev y qa)

Permisos por agente

Cada agente tiene permisos especificos para evitar que se salga de su rol:

| Accion | ORQ | DEV | QA | DEVOPS | GIT | |--------|-----|-----|----|--------|-----| | Crear User Stories | ✓ | ✗ | ✗ | ✗ | ✗ | | Crear Tasks | ✓ | ✗ | ✗ | ✗ | ✗ | | Crear Bugs | ✗ | ✗ | ✓ | ✗ | ✗ | | Cerrar Tasks | ✗ | ✗ | ✓ | ✗ | ✗ | | Cerrar User Stories | ✓ | ✗ | ✗ | ✗ | ✗ | | Config board/sprints | ✓ | ✗ | ✗ | ✗ | ✗ | | Crear rama feature | ✗ | ✓ | ✗ | ✗ | ✓ | | Escribir codigo app | ✗ | ✓ | ✗ | ✗ | ✗ | | Tests Playwright | ✗ | ✗ | ✓ | ✗ | ✗ | | Crear PR | ✗ | ✓ | ✗ | ✗ | ✗ | | Mergear a ramas env | ✗ | ✗ | ✗ | ✗ | ✓ | | Push a ramas env | ✗ | ✗ | ✗ | ✗ | ✓ | | Pipelines/infra | ✗ | ✗ | ✗ | ✓ | ✗ | | Documentar Wiki | ✓ | ✗ | ✗ | ✓* | ✗ |

*DEVOPS solo documenta /Infraestructura y /Variables-de-Entorno

Skills

Cada agente tiene una carpeta skills/ donde puedes agregar archivos .md con instrucciones especificas. Los skills se cargan automaticamente al iniciar el agente.

Esto permite que el kit sea 100% generico: los agentes vienen sin tecnologia predefinida y tu cargas las instrucciones segun el proyecto.

Ejemplo: cargar skill de React para DEV

Crea el archivo sdlc-system/agents/dev/skills/react-vite.md:

# React + Vite + TypeScript

## Convenciones
- Usar functional components con hooks
- Estado global con Zustand
- Routing con React Router v6
- Estilos con Tailwind CSS

## Estructura de carpetas
src/
  components/   — componentes reutilizables
  pages/        — vistas/paginas
  hooks/        — custom hooks
  services/     — llamadas a APIs
  utils/        — funciones utilitarias

## Patrones
- Un componente por archivo
- Props tipadas con interface (no type)
- Archivos en PascalCase para componentes, camelCase para utils

Logs de sesion

El kit incluye un sistema de logs locales para continuidad entre sesiones.

Al terminar de trabajar, escribe "cerrar sesion" o "/cerrar-sesion" y el agente guardara un resumen en logs/{agente}/{fecha}.md. Al iniciar la siguiente sesion, el agente lee el ultimo log para retomar con contexto.

Los logs son locales (.gitignore) y no se commitean al repositorio.

Comunicacion entre agentes

Los agentes no se hablan directamente. Se comunican a traves de:

1. Estados de tasks en ADO — cada estado indica la fase
2. Comentarios en tasks — dudas, reportes, feedback
3. Tags — Blocked (esperando respuesta), Ready (listo para QA)

Requisitos

• Node.js 18+
• Claude Code
• Acceso a Azure DevOps (OAuth via browser)

Estructura del kit

sdlc-system/
├── CLAUDE.md                      — Menu principal y tabla de permisos
├── .mcp.json                      — Configuracion MCP (Azure DevOps)
├── cerrar-sesion.md               — Instrucciones para log de cierre
├── context/
│   ├── project-context.md         — Config del proyecto (org, URL)
│   ├── azure-devops-context.md    — Referencia de operaciones ADO
│   ├── git-flow.md                — Estrategia de ramas
│   └── wiki-structure.md          — Que documentar en la Wiki
├── logs/                          — Logs de sesion por agente (local, .gitignore)
│   └── .gitignore
├── ORQUESTADOR/CLAUDE.md          — Instrucciones del planificador
├── DEV/CLAUDE.md                  — Instrucciones del desarrollador
├── QA/CLAUDE.md                   — Instrucciones del tester
├── DEVOPS/CLAUDE.md               — Instrucciones del devops
├── GIT-MASTER/CLAUDE.md           — Instrucciones del git master
└── agents/
    ├── orquestador/
    │   └── skills/                — Skills del orquestador
    ├── dev/
    │   └── skills/                — Skills de desarrollo
    ├── qa/
    │   └── skills/                — Skills de testing
    ├── devops/
    │   └── skills/                — Skills de infraestructura
    └── git-master/
        └── skills/                — Skills de git