sistema-multiagente-sdlc 1.2.0

package/CHANGELOG.md

@@ -0,0 +1,126 @@
+# Changelog
+
+## [1.2.0] — Unreleased
+
+### Phase 1 — Versionado y migraciones
+
+- Prepara metadata npm publica para `sistema-multiagente-sdlc`.
+- Actualiza `frameworkVersion` a `1.2.0`.
+- Reserva `scale` en config (`bug`, `feature`, `epic`, `platform`) para adaptive scale de v1.3.0.
+- Agrega targets de migracion `1.1.0` y `1.2.0` para cubrir upgrades `1.0.0 -> 1.2.0` y `1.1.0 -> 1.2.0`.
+
+### Phase 2 — Scripts operativos
+
+- Reemplaza stubs por 12 scripts sanitizados en `templates/scripts/`.
+- Agrega politica opt-in: `publish-trace` y scheduler requieren `-Apply`; sync externo requiere flags explicitos.
+- Instala `agent-skills.manifest.json`, `models.yaml` routing-only y config ejemplo de memoria Obsidian.
+- Amplia regresion con pruebas golden para `continua`, `publish-trace`, `register-claude-sync-task`, `compute-calibration` y `bootstrap-agent-skills`.
+
+### Phase 3 — C5/C6 skills
+
+- Agrega stack-skills canonicas `backend-audit` y `ui-ux-diseno` bajo `.github/skills`.
+- Agrega scaffolds de mirrors `.claude/skills`, `.agents/skills` y `.windsurf/skills`.
+- Extiende `stack` con `database` y `designSystem` para las nuevas skills parametrizadas.
+
+### Phase 4 — Gobierno operativo
+
+- Enriquece `.github/agent-state/` con `phase-status`, `active-slices`, decisiones, riesgos, lock TTL, drafts, calibration y templates de rework/handoff.
+- Fortalece `phase-graph.yaml` con rework label-driven, `F3_5` tecnico y `F3.5` display.
+- Agrega personas `.agent.md` validables, README de agentes y trazabilidad/guardrails genericos.
+
+### Phase 5 — Docs operativas
+
+- Agrega `docs/agents/` con presentacion F0-F17, catalogo de comandos, triage labels, mapa de handoffs, stack map y dominio base.
+- Documenta la instalacion opt-in de Obsidian, Graphify, caveman y sync de memoria en `external-tools-matrix.md`.
+- Agrega matriz de trazabilidad por superficie y guardrails semanticos genericos.
+
+### Phase 6 — OpenSpec specs base
+
+- Instala specs canonicas `business-production-readiness` y `project-phases`.
+- Deja specs donor especificas como referencia educativa no instalada en `docs/examples/openspec-specs-ejemplos/`.
+
+### Phase 7 — Validators
+
+- Agrega 9 validators nuevos: placeholder scripts, politica de herramientas externas, precedencia de gobierno, consistencia de skills, schema de personas, links docs, OpenSpec, Mustache y `models.yaml`.
+- `npm run validate` ahora ejecuta 14 validators en cadena.
+
+### Phase 8 — Doctor
+
+- `sdlc doctor` reporta runtime Node, PowerShell y Git.
+- Verifica agent-state base, specs canonicas, manifest de skills y `scale`.
+- Reporta Obsidian, Graphify y mirrors como checks informativos cuando siguen opt-in.
+
+### Phase 9-11 — E2E, community y CI/CD
+
+- Agrega alias `sdlc init` para `sdlc install` y prueba de regresion `init-alias`.
+- Expande README con quick start `npx`, flujo F0-F17, validators, matriz BMAD y roadmap.
+- Agrega workflows `regression-install`, `release` y `publish` manual con provenance.
+
+## [1.1.0] — 2026-05-18
+
+### Fase A — Template engine
+
+- Externaliza contenido inline a `templates/` con manifest selectivo (`templates/manifest.yaml`).
+- Motor logicless Mustache (`interpolate()`); placeholders `{{project.name}}`, `{{project.slug}}`, `{{mode}}`, `{{stack.*}}`, `{{gitFlow.*}}`, `{{obsidian.*}}`, `{{surfaces.*}}`.
+- Ningún template usa extensión `.mustache`; todos los archivos se interpolan al instalar.
+
+### Fase H — AJV schema-driven config validation
+
+- Validador de config basado en AJV; `config-schema.json` governa el contrato de entrada.
+- `validate:config-schema` corre antes de cualquier `install/upgrade`.
+
+### Fase E — Sistema de migraciones dinámico
+
+- `migrations/` con migraciones versionadas; `upgrade` y `rollback` con backup automático.
+- `doctor` detecta drift entre versión instalada y versión del framework.
+
+### Fase B — Extraction manifest
+
+- `docs/extraction/v1.0.0/extraction-manifest.yaml`: catálogo auditado de 75 entries (C1–C9 activos + C5–C6 diferidos + exclusiones).
+- Bloquea walk ciego de `templates/`; solo entradas explícitas en manifest se instalan.
+
+### Fase C — Template extraction (C1→C9)
+
+**C1 — Governance:**
+- `templates/AGENTS.md`, `templates/.github/AGENTS.md`, `templates/CLAUDE.md`, `templates/indice-operativo.md`.
+
+**C2 — Agent personas (7 activos):**
+- `planificador-opus`, `orquestador-opus`, `analista-requisitos` (legacy), `arquitecto`, `api-agent`, `web-agent`, `qa-security-review`.
+- Sanitizados: domain-specific refs (DIAN, FacturacionDian, Samcol) eliminadas; stack refs parametrizadas con `{{stack.backend}}`/`{{stack.frontend}}`.
+
+**C3 — Copilot instructions:**
+- `copilot-instructions-greenfield.md` (mode: greenfield), `copilot-instructions-legacy.md` (mode: legacy).
+- Ambos apuntan al mismo target `.github/copilot-instructions.md` según mode activo.
+
+**C4 — Core skills (18 archivos, 19 entries en extraction-manifest):**
+- `contexto-proyecto` (claude + github), `orquestacion-multiagente`, `enrich-us` (claude + github), `commit` (claude + github).
+- OpenSpec skills: `propose`, `explore`, `apply`, `archive`, `verify`, `sync`, `ff`, `new`, `continue`.
+- `documentacion-viva`, `operacion-cli-devops`.
+
+**C7 — OpenSpec schemas:**
+- `legacy-brownfield-sdd/`: `schema.yaml` + 5 templates (research, proposal, specs, design, tasks). Mode: legacy.
+- `greenfield-sdd/`: `schema.yaml` + 4 templates (proposal, specs, design, tasks). Mode: greenfield. New, no donor.
+- Profiles: `minimal.yaml`, `expanded.yaml`.
+- Scaffolds: `openspec/specs/.gitkeep`, `openspec/changes/.gitkeep`, `openspec/specs/business-production-readiness/README.md`.
+- Config mode-specific: `openspec/config-greenfield.yaml`, `openspec/config-legacy.yaml`.
+
+**C9 — Docs guides:**
+- `adopcion_openspec_sdd.md`, `business-production-readiness.md`, `memoria-persistente-multiagente.md`, `skills-multi-entorno.md`.
+- Sanitizados: paths específicos → `{{obsidian.memoryWorkspace}}`, `{{project.slug}}`; ejemplos domain-specific → genéricos.
+
+### Diferidos → v1.2.0
+
+- **C5** Stack skills (11): nestjs, nextjs, react, prisma, turborepo, vitest, playwright, tailwind, vercel, accessibility, bash-defensive-patterns.
+- **C6** Skill mirrors (3): `.agents/skills/`, `.windsurf/skills/`, `.cursorrules`.
+
+---
+
+## [1.0.0] — 2026-05-11
+
+Lanzamiento inicial del framework reusable extraído de `FacturacionDian` (commit `f1e7acafe7`).
+
+- CLI `sdlc install/upgrade/rollback/doctor/diff/prune-backups`.
+- Template engine con manifest selectivo.
+- AJV config validation.
+- Migration system con backup automático.
+- Extraction manifest v1.0.0 con catálogo completo de 75 entries.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Juan David Castrejon / GrupoIT
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,155 @@
+# SistemaMultiagente_SDLC
+
+AI-assisted SDLC framework con governance enterprise, SDD y enfoque brownfield-first.
+
+> BMAD orquesta; SistemaMultiagente_SDLC orquesta y verifica.
+
+## Why
+
+This project installs a governed multi-agent SDLC into greenfield or legacy repos. It combines reusable agent personas, OpenSpec/SDD workflows, phase gates, migrations, validators, rollback and optional persistent memory.
+
+The operating model is SDD waterfall by slice and agile by release: each slice has explicit requirements, readiness, design, implementation, verification and archive gates, while releases can stay iterative.
+
+## Quick Start
+
+Published package flow for v1.2.0:
+
+```powershell
+npx sistema-multiagente-sdlc init --target . --mode greenfield --project-name "My Project"
+```
+
+Local development flow:
+
+```powershell
+git clone https://github.com/JuanCastrejon/SistemaMultiagente_SDLC.git
+cd SistemaMultiagente_SDLC
+npm install
+npm run validate
+npm test
+node ./bin/sdlc.js install --target ../my-project --mode greenfield --project-name "My Project"
+```
+
+Legacy/brownfield:
+
+```powershell
+node ./bin/sdlc.js install --target ../legacy-project --mode legacy --project-name "Legacy Project"
+node ./bin/sdlc.js doctor --target ../legacy-project --json
+```
+
+## Modes
+
+| Mode | Use when | Adds |
+| --- | --- | --- |
+| `greenfield` | new repo or clean product start | greenfield SDD templates and governance |
+| `legacy` | existing repo, migration or brownfield modernization | mandatory research templates and legacy discovery gates |
+
+## Agents
+
+| Plane | Personas |
+| --- | --- |
+| Control | `planificador-opus`, `orquestador-opus` |
+| Definition | `analista-requisitos`, `arquitecto-modular-clean` |
+| Specialist | `api-nestjs`, `web-admin`, `mobile-sync` |
+| Gate | `qa-security-review` |
+
+## Phase Flow
+
+```mermaid
+flowchart LR
+  F0["F0 Bootstrap"] --> F1["F1 Requirements"]
+  F1 --> F2["F2 Human draft review"]
+  F2 --> F3["F3 Local issue"]
+  F3 --> F35["F3.5 Branch"]
+  F35 --> F4["F4 Readiness handoff"]
+  F4 --> F5["F5 SDD planning"]
+  F5 --> F6["F6 Planner handoff"]
+  F6 --> F7["F7 Orchestration"]
+  F7 --> F8["F8 Implementation"]
+  F8 --> F9["F9 QA"]
+  F9 --> F10["F10 Security"]
+  F10 --> F11["F11 Commit"]
+  F11 --> F12["F12 PR"]
+  F12 --> F13["F13 Human gate"]
+  F13 --> F14["F14 Merge"]
+  F14 --> F15["F15 Verify"]
+  F15 --> F16["F16 Archive"]
+  F16 --> F17["F17 Docs + trace"]
+```
+
+## Validators
+
+`npm run validate` runs 14 validators:
+
+- config schema
+- no personal paths
+- template sanitization
+- no inline managed content
+- manifest integrity
+- no placeholder scripts
+- external tools policy
+- governance precedence
+- skill manifest consistency
+- agent persona schema
+- docs links exist
+- OpenSpec consistency
+- Mustache references exist
+- models schema
+
+## Optional External Tools
+
+See `templates/docs/agents/external-tools-matrix.md` for setup details.
+
+| Tool | Required | Purpose |
+| --- | --- | --- |
+| OpenSpec | yes | SDD specs, changes and archive |
+| Graphify | no | structural graph for fast orientation |
+| Obsidian | no | local persistent memory vault |
+| caveman | no | token-saving communication mode |
+| gh CLI | yes for GitHub publish | issues, PRs and releases |
+
+All external installs are opt-in. Scripts default to dry-run or local-only behavior unless `-Apply` or another explicit install flag is provided.
+
+## BMAD Comparison
+
+| Feature | BMAD-METHOD | SistemaMultiagente_SDLC |
+| --- | --- | --- |
+| AI-driven agents | 12+ personas | 8 personas plus extensible roadmap |
+| Workflows | agile | SDD waterfall by slice, agile by release |
+| Scale-adaptive | yes | reserved for v1.3.0 |
+| Party mode | yes | roundtable opt-in planned for v1.3.0 |
+| Help CLI | bmad-help | `sdlc next` planned for v1.3.0 |
+| Modules/packs | yes | packs marketplace planned for v2.0.0 |
+| Governance validators | not core | 14 validators |
+| OpenSpec/SDD | not core | integrated |
+| Readiness L1/L2/L3 | not core | integrated |
+| Multi-agent lock | not core | TTL platform-context lock |
+| Brownfield-first | no | yes |
+| Migration system | not core | backup and rollback |
+| Sanitization validators | not core | no-personal-paths and template-sanitization |
+
+## Roadmap
+
+v1.3.0:
+
+- bash parity for critical scripts
+- `sdlc next`
+- adaptive scale: bug, feature, epic, platform
+- calibration extensions
+- roundtable opt-in
+- docs site
+
+v2.0.0:
+
+- extensible packs
+- plugin API
+- marketplace registry
+- English i18n
+- interactive contextual help
+
+## Contributing
+
+Read `CONTRIBUTING.md`, `CODE_OF_CONDUCT.md` and `SECURITY.md`.
+
+## License
+
+MIT.

package/bin/sdlc.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { main } from "../src/cli.js";
+
+main(process.argv.slice(2));

package/migrations/1.0.1/README.md

@@ -0,0 +1,28 @@
+# Migration 1.0.1
+
+Migracion de prueba para validar `upgrade`, backup, manifest integrity y rollback.
+
+## Efecto
+
+Agrega `.sdlc/migrations/1.0.1-applied.txt` y actualiza `frameworkVersion` en `.sdlc/config.json`.
+
+## Convencion de migraciones
+
+Cada directorio `migrations/<version>/` contiene:
+- `README.md` — descripcion del cambio, precondiciones y notas de rollback.
+- El estado aplicado se registra en `.sdlc/migrations/<version>-applied.txt` dentro del repo consumidor.
+- Las migraciones deben ser idempotentes: re-aplicar no rompe nada.
+
+## Trigger
+
+```sh
+sdlc upgrade --target <repo> --to-version 1.0.1
+```
+
+## Rollback
+
+```sh
+sdlc rollback --target <repo> --to <backup-id>
+```
+
+El backup-id se devuelve en la respuesta JSON del comando `upgrade`.

package/migrations/1.0.1/up.mjs

@@ -0,0 +1,6 @@
+// Returns additional managed files produced by this migration.
+export function up() {
+  return {
+    ".sdlc/migrations/1.0.1-applied.txt": "Migration 1.0.1 applied by SistemaMultiagente_SDLC.\ngenerated-by-sdlc\n"
+  };
+}

package/migrations/1.1.0/up.mjs

@@ -0,0 +1,8 @@
+// v1.1.0 published the governed template baseline.
+// It is represented as a migration target so upgrades can traverse 1.0.0 -> 1.2.0
+// and 1.1.0 -> 1.2.0 consistently.
+export function up() {
+  return {
+    ".sdlc/migrations/1.1.0-applied.txt": "Migration 1.1.0 applied by SistemaMultiagente_SDLC.\ngenerated-by-sdlc\n"
+  };
+}

package/migrations/1.2.0/up.mjs

@@ -0,0 +1,17 @@
+export function up(files = {}) {
+  const extra = {
+    ".sdlc/migrations/1.2.0-applied.txt": "Migration 1.2.0 applied by SistemaMultiagente_SDLC.\ngenerated-by-sdlc\n"
+  };
+
+  const configPath = ".sdlc/config.json";
+  if (typeof files[configPath] === "string") {
+    const config = JSON.parse(files[configPath]);
+    if (!config.scale) {
+      config.scale = "feature";
+    }
+    config.frameworkVersion = "1.2.0";
+    extra[configPath] = `${JSON.stringify(config, null, 2)}\n`;
+  }
+
+  return extra;
+}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "sistema-multiagente-sdlc",
+  "version": "1.2.0",
+  "description": "Framework reusable para instalar un SDLC multiagente gobernado en repos greenfield o legacy.",
+  "type": "module",
+  "bin": {
+    "sdlc": "./bin/sdlc.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "schemas/",
+    "templates/",
+    "profiles/",
+    "migrations/",
+    "scripts/",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "keywords": [
+    "ai",
+    "sdlc",
+    "multiagent",
+    "claude-code",
+    "openspec",
+    "governance",
+    "template",
+    "brownfield",
+    "sdd"
+  ],
+  "repository": "github:JuanCastrejon/SistemaMultiagente_SDLC",
+  "bugs": "https://github.com/JuanCastrejon/SistemaMultiagente_SDLC/issues",
+  "homepage": "https://github.com/JuanCastrejon/SistemaMultiagente_SDLC#readme",
+  "scripts": {
+    "sdlc": "node ./bin/sdlc.js",
+    "test": "node ./tests/run-regression.mjs",
+    "validate": "npm run validate:config-schema && npm run validate:no-personal-paths && npm run validate:template-sanitization && npm run validate:no-inline-managed-content && npm run validate:manifest-integrity && npm run validate:no-placeholder-scripts && npm run validate:external-tools-policy && npm run validate:governance-precedence && npm run validate:skill-manifest-consistency && npm run validate:agent-persona-schema && npm run validate:docs-links-exist && npm run validate:openspec-consistency && npm run validate:mustache-references-exist && npm run validate:models-schema",
+    "validate:config-schema": "node ./scripts/validate-config-schema.mjs",
+    "validate:no-personal-paths": "node ./scripts/validate-no-personal-paths.mjs",
+    "validate:template-sanitization": "node ./scripts/validate-template-sanitization.mjs",
+    "validate:no-inline-managed-content": "node ./scripts/validate-no-inline-managed-content.mjs",
+    "validate:manifest-integrity": "node ./scripts/validate-manifest-integrity.mjs --allow-empty",
+    "validate:no-placeholder-scripts": "node ./scripts/validate-no-placeholder-scripts.mjs",
+    "validate:external-tools-policy": "node ./scripts/validate-external-tools-policy.mjs",
+    "validate:governance-precedence": "node ./scripts/validate-governance-precedence.mjs",
+    "validate:skill-manifest-consistency": "node ./scripts/validate-skill-manifest-consistency.mjs",
+    "validate:agent-persona-schema": "node ./scripts/validate-agent-persona-schema.mjs",
+    "validate:docs-links-exist": "node ./scripts/validate-docs-links-exist.mjs",
+    "validate:openspec-consistency": "node ./scripts/validate-openspec-consistency.mjs",
+    "validate:mustache-references-exist": "node ./scripts/validate-mustache-references-exist.mjs",
+    "validate:models-schema": "node ./scripts/validate-models-schema.mjs"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "ajv": "^8.20.0"
+  }
+}

package/profiles/greenfield-sdd/openspec.config.yaml

@@ -0,0 +1,15 @@
+schema: greenfield-sdd
+context: |
+  Proyecto nuevo gobernado por SistemaMultiagente_SDLC.
+  Investigar docs, backlog y prior art antes de proponer capacidades.
+rules:
+  research:
+    - Declarar objetivo, usuarios, KPI principal, riesgos y NFRs minimos.
+  proposal:
+    - Mantener cambios pequenos y trazables.
+  specs:
+    - Escribir comportamiento observable con Given/When/Then.
+  design:
+    - Registrar trade-offs y contratos entre superficies.
+  tasks:
+    - Dividir en slices verificables.

package/profiles/legacy-brownfield-sdd/openspec.config.yaml

@@ -0,0 +1,16 @@
+schema: legacy-brownfield-sdd
+context: |
+  Proyecto legacy/brownfield gobernado por SistemaMultiagente_SDLC.
+  La investigacion debe declarar fuente primaria, secundaria, evidencia y drift.
+rules:
+  research:
+    - Declarar fuente primaria, secundaria, evidencia revisada y vacios.
+    - Documentar AS-IS y TO-BE cuando cambie un flujo existente.
+  proposal:
+    - Referenciar evidencia legacy y exclusiones de alcance.
+  specs:
+    - No inventar comportamiento no confirmado.
+  design:
+    - Explicar transicion, rollback, paridad y riesgos.
+  tasks:
+    - Incluir validaciones de migracion y readiness.

package/schemas/sdlc.config.schema.json

@@ -0,0 +1,106 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://example.invalid/sistema-multiagente-sdlc/sdlc.config.schema.json",
+  "title": "SistemaMultiagente_SDLC config",
+  "type": "object",
+  "required": ["schemaVersion", "frameworkVersion", "project", "mode", "surfaces", "gitFlow", "openspec"],
+  "properties": {
+    "schemaVersion": { "type": "integer", "const": 1 },
+    "frameworkVersion": { "type": "string" },
+    "project": {
+      "type": "object",
+      "required": ["name", "slug"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "slug": { "type": "string", "minLength": 1 },
+        "organization": { "type": "string" }
+      }
+    },
+    "mode": { "type": "string", "enum": ["greenfield", "legacy"] },
+    "scale": {
+      "type": "string",
+      "enum": ["bug", "feature", "epic", "platform"],
+      "default": "feature",
+      "description": "Reserved for v1.3.0 adaptive scale. Not consumed in v1.2.0."
+    },
+    "stack": {
+      "type": "object",
+      "properties": {
+        "backend": { "type": "string" },
+        "frontend": { "type": "string" },
+        "database": { "type": "string" },
+        "designSystem": { "type": "string" },
+        "mobile": { "type": "string" }
+      }
+    },
+    "surfaces": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "path", "owner"],
+        "properties": {
+          "id": { "type": "string" },
+          "path": { "type": "string" },
+          "owner": { "type": "string" }
+        }
+      }
+    },
+    "gitFlow": {
+      "type": "object",
+      "required": ["integrationBranch", "stableBranch"],
+      "properties": {
+        "integrationBranch": { "type": "string" },
+        "stableBranch": { "type": "string" },
+        "branchPrefixes": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "openspec": {
+      "type": "object",
+      "required": ["profile"],
+      "properties": {
+        "profile": { "type": "string", "enum": ["minimal", "expanded", "custom"] },
+        "customProfile": {
+          "anyOf": [
+            { "type": "null" },
+            {
+              "type": "object",
+              "required": ["name", "workflows"],
+              "properties": {
+                "name": { "type": "string", "minLength": 1 },
+                "workflows": { "type": "array", "minItems": 1, "items": { "type": "string" } }
+              }
+            }
+          ]
+        }
+      }
+    }
+  },
+  "if": {
+    "properties": {
+      "openspec": {
+        "type": "object",
+        "properties": { "profile": { "const": "custom" } },
+        "required": ["profile"]
+      }
+    },
+    "required": ["openspec"]
+  },
+  "then": {
+    "properties": {
+      "openspec": {
+        "type": "object",
+        "required": ["customProfile"],
+        "properties": {
+          "customProfile": {
+            "type": "object",
+            "required": ["name", "workflows"],
+            "properties": {
+              "name": { "type": "string", "minLength": 1 },
+              "workflows": { "type": "array", "minItems": 1, "items": { "type": "string" } }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/scripts/install-sistema-sdlc.ps1

@@ -0,0 +1,22 @@
+param(
+  [Parameter(Mandatory = $true)]
+  [string]$Target,
+  [ValidateSet('greenfield', 'legacy')]
+  [string]$Mode = 'greenfield',
+  [string]$ProjectName = '',
+  [string]$ProjectSlug = '',
+  [switch]$DryRun,
+  [switch]$Json
+)
+
+$ErrorActionPreference = 'Stop'
+$repoRoot = Split-Path -Path $PSScriptRoot -Parent
+$argsList = @((Join-Path $repoRoot 'bin\sdlc.js'), 'install', '--target', $Target, '--mode', $Mode)
+
+if ($ProjectName) { $argsList += @('--project-name', $ProjectName) }
+if ($ProjectSlug) { $argsList += @('--project-slug', $ProjectSlug) }
+if ($DryRun) { $argsList += '--dry-run' }
+if ($Json) { $argsList += '--json' }
+
+node @argsList
+exit $LASTEXITCODE

package/scripts/install-sistema-sdlc.sh

@@ -0,0 +1,33 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+TARGET=""
+MODE="greenfield"
+PROJECT_NAME=""
+PROJECT_SLUG=""
+DRY_RUN=""
+JSON_FLAG=""
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --target)       TARGET="$2";       shift 2 ;;
+    --mode)         MODE="$2";         shift 2 ;;
+    --project-name) PROJECT_NAME="$2"; shift 2 ;;
+    --project-slug) PROJECT_SLUG="$2"; shift 2 ;;
+    --dry-run)      DRY_RUN="--dry-run"; shift ;;
+    --json)         JSON_FLAG="--json";  shift ;;
+    *) echo "Opcion desconocida: $1" >&2; exit 1 ;;
+  esac
+done
+
+ARGS=("$REPO_ROOT/bin/sdlc.js" install --mode "$MODE")
+[[ -n "$TARGET" ]]       && ARGS+=(--target "$TARGET")
+[[ -n "$PROJECT_NAME" ]] && ARGS+=(--project-name "$PROJECT_NAME")
+[[ -n "$PROJECT_SLUG" ]] && ARGS+=(--project-slug "$PROJECT_SLUG")
+[[ -n "$DRY_RUN" ]]      && ARGS+=("$DRY_RUN")
+[[ -n "$JSON_FLAG" ]]    && ARGS+=("$JSON_FLAG")
+
+node "${ARGS[@]}"