@accionpoint/sdlc

CLI que orquesta agentes Claude para cubrir el ciclo de vida completo de software: refinamiento de spec → análisis + diseño → estimación → implementación → QA → post-producción (bugs, CR, feedback).

Instalación

npm install -g @accionpoint/sdlc

El postinstall detecta tu OS/arch y descarga el binario correspondiente desde GitHub Releases (con verificación SHA-256). Plataformas soportadas:

| OS | Arch | |----|------| | Linux | x64 | | macOS | x64, arm64 | | Windows | x64 |

Node >=18 requerido para el postinstall.

Activación

Después de instalar, activá tu licencia:

sdlc activate <TU-LICENSE-KEY>

La key se canjea por un token firmado (HMAC-SHA256) que queda cacheado localmente en ~/.config/sdlc/license.json (o %APPDATA%\sdlc\ en Windows). La validación contra el license server se hace 1×/día; si el server está caído hay 7 días de offline grace period para seguir trabajando.

Comandos relacionados:

sdlc activate --status       # muestra estado actual
sdlc activate --deactivate   # borra el cache local

Modo desarrollo (sin licencia)

export SDLC_DEV_MODE=1
sdlc help

Uso rápido

# Preparación
sdlc preflight                        # valida entorno (docker, git, MCPs)

# Análisis + diseño
sdlc refinar                          # refinamiento iterativo de la spec
sdlc analizar-spec                    # 7 artefactos + SUMMARY
sdlc validar                          # validación de estructura

# Implementación
sdlc implementar                      # siguiente batch → PR
sdlc sprint                           # batches en paralelo con worktrees
sdlc estado                           # progreso
sdlc resume                           # reanudar batch interrumpido

# QA
sdlc qa                               # 8 capas de detección
sdlc qa diagnose                      # genera qa-sessions.md
sdlc qa ejecutar-fixes                # aplica FIX-XXX
sdlc security                         # audit OWASP standalone

# Post-producción
sdlc bug "el endpoint /users rompe"   # reporte de bug → PR
sdlc cambio "agregar campo phone"     # CR con análisis de impacto
sdlc feedback "el cálculo está mal"   # clasifica y procesa/delega

# Migración GeneXus legacy
sdlc run-pipeline                     # 6 stages + gates G1-G5
sdlc check-gates

Ver sdlc help para la lista completa.

Configuración del proyecto

Cada proyecto donde usás sdlc necesita un archivo .sdlc/pipeline-config.yaml:

name: mi-proyecto
github_owner: mi-org
github_repo: mi-repo
test_all: "pytest -v"
test_regression: "pytest tests/ --tb=short"
critical_modules:
  - src/auth/
  - src/payments/
staging_url: https://staging.example.com
health_endpoint: /healthz

El comando sdlc preflight valida que este archivo y las herramientas requeridas estén presentes.

Telemetry (opt-in, por default apagado)

sdlc telemetria on        # habilita
sdlc telemetria off       # deshabilita
sdlc telemetria estado    # muestra preferencia actual

Con opt-in se envían métricas agregadas (tokens, costos, errores) al license server. Nunca código, prompts, output de Claude, paths locales, ni contenido de Issues/PRs.

Variables de entorno

| Variable | Default | Descripción | |----------|---------|-------------| | SDLC_DEV_MODE | — | 1 para bypass de licencia | | ANTHROPIC_API_KEY | — | key del cliente para el SDK de Claude | | GITHUB_TOKEN | — | token con scope repo + issues (habilita MCP GitHub) | | SDLC_LOG_LEVEL | INFO | DEBUG, INFO, WARNING, ERROR | | SDLC_LOG_FORMAT | json | json o plain | | SDLC_LOG_FILE | — | ruta a archivo adicional de logs | | SDLC_TELEMETRY | — | 1 o 0 para override explícito del opt-in | | SDLC_LICENSE_SERVER | https://licenses.accionpoint.com | override del server | | SDLC_LICENSE_CACHE | ~/.config/sdlc/ | override del directorio de cache |

Requisitos

• Node.js >=18 (sólo para el postinstall)
• Git — el CLI opera sobre repos git
• Docker + docker-compose — para las capas QA que lo requieren
• GitHub MCP server — se invoca via npx -y @modelcontextprotocol/server-github si hay GITHUB_TOKEN
• Playwright MCP server (opcional) — para capa QA visual

Licencia

Propietario — Accionpoint SA. Ver LICENSE.

Soporte

• Issues críticos: contactar a Accionpoint SA
• Docs: sdlc help y sdlc <comando> --help
• Logs de una sesión: SDLC_LOG_FILE=/tmp/sdlc.log sdlc <comando> y adjuntar el archivo