create-harness-btp 0.2.4 → 0.3.0

package/AI/clients/opencode/skills/cf-cli/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: cf-cli
+description: Uso estándar del CLI de Cloud Foundry (cf)
+---
+
+# CLI Cloud Foundry (`cf`)
+
+El CLI de Cloud Foundry se invoca **siempre** como `cf` (instalación
+estándar del CLI; adapta rutas según tu equipo). Si `cf` en tu máquina
+corresponde a otra herramienta, define un alias propio y úsalo de forma
+consistente donde el harness diga `cf`.
+
+## Lectura segura (sin secretos)
+
+```
+cf target          # endpoint / org / espacio actuales
+cf api             # endpoint y versión API
+cf orgs            # solo nombres
+cf spaces          # solo nombres
+cf apps            # estado observable (started/stopped, rutas)
+cf services        # instancias visibles
+cf logs <app> --recent
+```
+
+`target`, `api`, `orgs`, `spaces` y `app <nombre>` nunca muestran tokens.
+Si una salida incluyera un secreto, redáctalo antes de citarla.
+
+## Mutaciones (solo `deploy-cf`, con destino confirmado)
+
+- Confirmar endpoint/org/espacio contra la spec **antes** de cada despliegue.
+- `cf push` para apps simples; `cf deploy <archivo>.mtar` para MTA
+  (requiere plugin `multiapps`, no instalado: ver skill `mta-build`).
+- Verificar después: `cf apps` + `cf logs <app> --recent` + URL.
+
+## Denylist
+
+- Borrar o renombrar orgs, espacios, apps o servicios fuera del MVP.
+- `cf login`/re-autenticaciones no solicitadas (si la sesión caduca,
+  pedir al usuario el flujo interactivo, nunca credenciales en texto).
+- `--var`/`--vars-file` con secretos en shell compartida; usar archivos ya
+  ignorados por Git y no citar sus valores.

package/AI/clients/opencode/skills/mta-build/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: mta-build
+description: Construir y verificar artefactos MTAR con mbt en este equipo
+---
+
+# Build MTA (`mbt`)
+
+`mbt` es Cloud MTA Build Tool 1.2.50 (verificado 2026-10-29). Invocarlo
+siempre como `mbt`, nunca como `cf` ni rutas inventadas.
+
+## Flujo
+
+```
+mbt build                # requiere mta.yaml en la raíz del proyecto
+```
+
+- El `.mtar` resultante queda en `mta_archives/` con el nombre/versión de
+  `mta.yaml`. Comprobar existencia y fecha antes de desplegar.
+- Para módulos Node.js, `mbt` ejecuta `npm install`/`npm run build` según
+  `mta.yaml`; para Java necesita Maven (`mvn` no instalado: documentar como
+  pendiente si una spec lo exige).
+- `mbt build --help` para flags (`--mtar`, `--platform=cf`).
+
+## Despliegue del MTAR
+
+`cf deploy <archivo>.mtar` requiere el **plugin multiapps**. Verificar
+siempre con `cf plugins` antes de asumir su ausencia (2026-10-30 resultó
+ya instalado contra lo documentado). Instalarlo solo cuando un MVP necesite
+despliegue MTA:
+
+```
+cf install-plugin -r CF-Community multiapps
+```
+
+Alternativa sin plugin para MVPs simples: `cf push` por app según plan.
+
+## Notas
+
+- El binario `mbt.exe` se obtuvo con el propio `install.js` del paquete npm
+  (`node install.js cloud-mta-build-tool`). Si `mbt` vuelve a fallar tras
+  una actualización global, repetir ese comando en el directorio del paquete.
+- Nunca versionar `mta_archives/*.mtar` ni `default-services.json` con claves.
+- `mbt` exige `make` en `%PATH%` (ver `AGENTS.md` § Disciplina de shell y
+  CLIs): si falla `exec: "make": executable file not found`, anteponer el
+  `bin` de ezwinports/GnuWin32 al `$env:PATH` solo para el comando.

package/AI/clients/opencode/skills/sap-verify/SKILL.md

@@ -0,0 +1,27 @@
+---
+name: sap-verify
+description: Clasificar disponibilidad, cuenta y coste de servicios SAP/BTP
+---
+
+# Verificación de dependencias externas SAP
+
+Toda afirmación sobre un servicio, plan, API o capacidad BTP se clasifica en
+una de estas categorías, con fuente y fecha:
+
+| Categoría | Significado |
+|---|---|
+| **Documentado** | Docs oficiales vigentes + evidencia (comando, consola o enlace con fecha). |
+| **Pendiente en cuenta** | Existe en docs pero sin comprobar en la subcuenta/destino real. |
+| **Coste por cotizar** | Requiere plan de pago o métrica no verificada; no activar sin confirmación. |
+
+## Reglas
+
+- Desarrollo local y mocks primero; servicios reales solo con evidencia.
+- Distinguir Windows local frente a BAS/dev space remoto: una instalación o
+  capacidad de un lado no implica la del otro.
+- No afirmar que una integración está aprobada o disponible hasta comprobarla
+  con documentación y accesos vigentes.
+- Costes: antes de activar cualquier recurso con coste, verificar precio y
+  documentarlo en la spec; capa gratuita por defecto.
+- Bloqueos externos no paran el MVP: documentar evidencia y continuar con
+  mocks o adaptador local.

package/AI/commands/flow.md

@@ -0,0 +1,16 @@
+---
+description: Ciclo completo spec-despliegue de un MVP SAP BTP
+agent: orchestrator
+---
+
+Ejecuta el flujo sobre la especificación: $ARGUMENTS
+(p. ej. `/flow specs/mi-mvp.md`).
+
+El orquestador recorre las etapas 0–10 de `AGENTS.md` con los especialistas
+adecuados (`analyst`, `researcher`, `architect`, `frontend-ui5`,
+`backend-cap`, `qa-review`, `deploy-cf`, `documentarian`). En MVPs pequeños
+puede saltar etapas irrelevantes y registrarlo; ningún riesgo o
+incertidumbre bloquea por sí solo: se investiga, se decide con evidencia y
+se continúa con lo resoluble. La puerta de despliegue (etapa 7) es
+obligatoria antes de desplegar. Al cerrar: qué se hizo, verificaciones con
+comandos y resultado real, y qué quedó pendiente y por qué.

package/AI/commands/verify.md

@@ -0,0 +1,18 @@
+---
+description: Puerta de despliegue CF sin desplegar
+agent: orchestrator
+---
+
+Ejecuta solo la puerta de despliegue (etapa 7) para $ARGUMENTS
+(spec o nombre de app; si se omite, el MVP en curso).
+
+Verificaciones (delegables en `qa-review` + `deploy-cf` en solo lectura):
+
+1. `cf target` coincide con el destino de la spec (endpoint/org/espacio).
+2. El artefacto existe y es reciente (`.mtar` en `mta_archives/` o bundle
+   para `push`).
+3. Todos los criterios de aceptación están en verde con evidencia.
+4. Diff/Git sin secretos ni archivos que debieran estar ignorados.
+
+Veredicto: apto / no apto con motivos concretos. Este comando nunca
+despliega ni muta nada en Cloud Foundry.

package/AI/skills/cap-cli/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: cap-cli
+description: Invocación verificada del CLI de CAP y facets en este equipo
+---
+
+# CLI de CAP (`cds`)
+
+Nombres verificados el 2026-10-29 (docs cap.cloud.sap vía `context7`;
+paquete `@cap-js/cds-dk` **no existe** — el correcto es `@sap/cds-dk`):
+
+- CLI solo vía `npx -p @sap/cds-dk cds ...` (el `node_modules` del proyecto
+  no incluye el ejecutable `cds`; `npx cds` a secas falla).
+- Runtime del proyecto: `@sap/cds` v10 + `@cap-js/sqlite` v3 (SQLite solo
+  para dev local; sin persistencia en CF).
+- Scaffold: `npx -p @sap/cds-dk cds init <nombre> --nodejs` (no global).
+- Facets usadas en este harness: `mta xsuaa approuter html5-repo
+  destination ui5` (lista completa real con `cds add --help`, no de memoria).
+- Tras `cds add`, siempre `npm install` antes del siguiente comando.
+- `cds add` es aditivo y genera `mta.yaml`/`xs-security.json`: revisar el
+  diff antes de aceptar lo generado (nombres de instancia deben coincidir
+  con las existentes en la subcuenta).

package/AI/skills/cf-cli/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: cf-cli
+description: Uso estándar del CLI de Cloud Foundry (cf)
+---
+
+# CLI Cloud Foundry (`cf`)
+
+El CLI de Cloud Foundry se invoca **siempre** como `cf` (instalación
+estándar del CLI; adapta rutas según tu equipo). Si `cf` en tu máquina
+corresponde a otra herramienta, define un alias propio y úsalo de forma
+consistente donde el harness diga `cf`.
+
+## Lectura segura (sin secretos)
+
+```
+cf target          # endpoint / org / espacio actuales
+cf api             # endpoint y versión API
+cf orgs            # solo nombres
+cf spaces          # solo nombres
+cf apps            # estado observable (started/stopped, rutas)
+cf services        # instancias visibles
+cf logs <app> --recent
+```
+
+`target`, `api`, `orgs`, `spaces` y `app <nombre>` nunca muestran tokens.
+Si una salida incluyera un secreto, redáctalo antes de citarla.
+
+## Mutaciones (solo `deploy-cf`, con destino confirmado)
+
+- Confirmar endpoint/org/espacio contra la spec **antes** de cada despliegue.
+- `cf push` para apps simples; `cf deploy <archivo>.mtar` para MTA
+  (requiere plugin `multiapps`, no instalado: ver skill `mta-build`).
+- Verificar después: `cf apps` + `cf logs <app> --recent` + URL.
+
+## Denylist
+
+- Borrar o renombrar orgs, espacios, apps o servicios fuera del MVP.
+- `cf login`/re-autenticaciones no solicitadas (si la sesión caduca,
+  pedir al usuario el flujo interactivo, nunca credenciales en texto).
+- `--var`/`--vars-file` con secretos en shell compartida; usar archivos ya
+  ignorados por Git y no citar sus valores.

package/AI/skills/mta-build/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: mta-build
+description: Construir y verificar artefactos MTAR con mbt en este equipo
+---
+
+# Build MTA (`mbt`)
+
+`mbt` es Cloud MTA Build Tool 1.2.50 (verificado 2026-10-29). Invocarlo
+siempre como `mbt`, nunca como `cf` ni rutas inventadas.
+
+## Flujo
+
+```
+mbt build                # requiere mta.yaml en la raíz del proyecto
+```
+
+- El `.mtar` resultante queda en `mta_archives/` con el nombre/versión de
+  `mta.yaml`. Comprobar existencia y fecha antes de desplegar.
+- Para módulos Node.js, `mbt` ejecuta `npm install`/`npm run build` según
+  `mta.yaml`; para Java necesita Maven (`mvn` no instalado: documentar como
+  pendiente si una spec lo exige).
+- `mbt build --help` para flags (`--mtar`, `--platform=cf`).
+
+## Despliegue del MTAR
+
+`cf deploy <archivo>.mtar` requiere el **plugin multiapps**. Verificar
+siempre con `cf plugins` antes de asumir su ausencia (2026-10-30 resultó
+ya instalado contra lo documentado). Instalarlo solo cuando un MVP necesite
+despliegue MTA:
+
+```
+cf install-plugin -r CF-Community multiapps
+```
+
+Alternativa sin plugin para MVPs simples: `cf push` por app según plan.
+
+## Notas
+
+- El binario `mbt.exe` se obtuvo con el propio `install.js` del paquete npm
+  (`node install.js cloud-mta-build-tool`). Si `mbt` vuelve a fallar tras
+  una actualización global, repetir ese comando en el directorio del paquete.
+- Nunca versionar `mta_archives/*.mtar` ni `default-services.json` con claves.
+- `mbt` exige `make` en `%PATH%` (ver `AGENTS.md` § Disciplina de shell y
+  CLIs): si falla `exec: "make": executable file not found`, anteponer el
+  `bin` de ezwinports/GnuWin32 al `$env:PATH` solo para el comando.

package/AI/skills/sap-verify/SKILL.md

@@ -0,0 +1,27 @@
+---
+name: sap-verify
+description: Clasificar disponibilidad, cuenta y coste de servicios SAP/BTP
+---
+
+# Verificación de dependencias externas SAP
+
+Toda afirmación sobre un servicio, plan, API o capacidad BTP se clasifica en
+una de estas categorías, con fuente y fecha:
+
+| Categoría | Significado |
+|---|---|
+| **Documentado** | Docs oficiales vigentes + evidencia (comando, consola o enlace con fecha). |
+| **Pendiente en cuenta** | Existe en docs pero sin comprobar en la subcuenta/destino real. |
+| **Coste por cotizar** | Requiere plan de pago o métrica no verificada; no activar sin confirmación. |
+
+## Reglas
+
+- Desarrollo local y mocks primero; servicios reales solo con evidencia.
+- Distinguir Windows local frente a BAS/dev space remoto: una instalación o
+  capacidad de un lado no implica la del otro.
+- No afirmar que una integración está aprobada o disponible hasta comprobarla
+  con documentación y accesos vigentes.
+- Costes: antes de activar cualquier recurso con coste, verificar precio y
+  documentarlo en la spec; capa gratuita por defecto.
+- Bloqueos externos no paran el MVP: documentar evidencia y continuar con
+  mocks o adaptador local.

package/README.md

@@ -1,6 +1,6 @@
 # harness-btp
 
-[![version](https://img.shields.io/badge/version-v0.2.4-blue)](https://github.com/horangelmillan/harness-btp/releases/tag/v0.2.4)
+[![version](https://img.shields.io/badge/version-v0.3.0-blue)](https://github.com/horangelmillan/harness-btp/releases/tag/v0.3.0)
 [![license](https://img.shields.io/badge/license-MIT-green)](LICENSE)
 [![platform](https://img.shields.io/badge/platform-windows%20%7C%20linux%20%7C%20macos-lightgrey)](https://github.com/horangelmillan/harness-btp)
 [![agent](https://img.shields.io/badge/agent-any%20AGENTS.md--compatible-purple)](https://github.com/horangelmillan/harness-btp)
@@ -18,6 +18,7 @@ Para quien construye MVPs SAP BTP y quiere empezar cada proyecto con el mismo fl
 - [Instalación asistida por agente](#instalación-asistida-por-agente)
 - [Actualizar y desinstalar](#actualizar-y-desinstalar)
 - [Adaptadores opcionales](#adaptadores-opcionales)
+- [Multi-cliente](#multi-cliente)
 - [Estructura del repo](#estructura-del-repo)
 - [Cómo lo descubre el agente](#cómo-lo-descubre-el-agente)
 - [Troubleshooting](#troubleshooting)
@@ -55,7 +56,7 @@ El camino de 30 segundos en un proyecto nuevo. Elige tu shell:
 PowerShell (Windows):
 
 ```powershell
-npx -p degit degit horangelmillan/harness-btp#v0.2.4 AI-tmp -- AI-tmp
+npx -p degit degit horangelmillan/harness-btp#v0.3.0 AI-tmp -- AI-tmp
 powershell -ExecutionPolicy Bypass -File AI-tmp/install.ps1 -Dest .
 Remove-Item -Recurse -Force AI-tmp
 ```
@@ -63,7 +64,7 @@ Remove-Item -Recurse -Force AI-tmp
 bash (Linux, macOS o Git Bash):
 
 ```bash
-npx -p degit degit horangelmillan/harness-btp#v0.2.4 AI-tmp -- AI-tmp
+npx -p degit degit horangelmillan/harness-btp#v0.3.0 AI-tmp -- AI-tmp
 sh AI-tmp/install.sh --dest .
 rm -rf AI-tmp
 ```
@@ -79,7 +80,7 @@ Descarga solo lo necesario, sin historial git:
 PowerShell:
 
 ```powershell
-npx -p degit degit horangelmillan/harness-btp#v0.2.4 AI-tmp -- AI-tmp
+npx -p degit degit horangelmillan/harness-btp#v0.3.0 AI-tmp -- AI-tmp
 powershell -ExecutionPolicy Bypass -File AI-tmp/install.ps1 -Dest .
 Remove-Item -Recurse -Force AI-tmp
 ```
@@ -87,7 +88,7 @@ Remove-Item -Recurse -Force AI-tmp
 bash:
 
 ```bash
-npx -p degit degit horangelmillan/harness-btp#v0.2.4 AI-tmp -- AI-tmp
+npx -p degit degit horangelmillan/harness-btp#v0.3.0 AI-tmp -- AI-tmp
 sh AI-tmp/install.sh --dest .
 rm -rf AI-tmp
 ```
@@ -99,7 +100,7 @@ Clon superficial anclado al tag:
 PowerShell:
 
 ```powershell
-git clone --branch v0.2.4 --depth 1 https://github.com/horangelmillan/harness-btp AI-tmp
+git clone --branch v0.3.0 --depth 1 https://github.com/horangelmillan/harness-btp AI-tmp
 powershell -ExecutionPolicy Bypass -File AI-tmp/install.ps1 -Dest .
 Remove-Item -Recurse -Force AI-tmp
 ```
@@ -107,7 +108,7 @@ Remove-Item -Recurse -Force AI-tmp
 bash:
 
 ```bash
-git clone --branch v0.2.4 --depth 1 https://github.com/horangelmillan/harness-btp AI-tmp
+git clone --branch v0.3.0 --depth 1 https://github.com/horangelmillan/harness-btp AI-tmp
 sh AI-tmp/install.sh --dest .
 rm -rf AI-tmp
 ```
@@ -117,22 +118,25 @@ rm -rf AI-tmp
 Sin descargas manuales (requiere publicar `create-harness-btp` en el registry). Igual en todos los SO:
 
 ```bash
-pnpm dlx create-harness-btp@0.2.4 --dest .
+pnpm dlx create-harness-btp@0.3.0 --dest .
 ```
 
 ### Qué hace el instalador
 
 - `CREATE: AI/` o `SKIP: AI/ ya existe` (solo lo reemplaza con `-Force` / `--force`, con backup a `AI.bak`).
 - `CREATE: AGENTS.md` o `SKIP: AGENTS.md ya existe` (tu `AGENTS.md` propio se conserva; con `-Force` / `--force` se respalda a `AGENTS.md.bak`).
+- Fusiona el árbol del cliente agéntico (`--client`, por defecto `auto`) desde `AI/clients/<cliente>/` en la raíz (ver [Multi-cliente](#multi-cliente)): sin fuerza solo copia los archivos que falten (`SKIP: <dir>/<ruta> ya existe` por cada uno conservado); con `-Force` / `--force` respalda cada dir a `<dir>.bak` (`BACKUP: <dir>/ -> <dir>.bak`) y copia todo.
 - Fusiona `.gitignore`: añade las líneas que falten, sin duplicar ni borrar las tuyas.
 - **No toca** `package.json` ni `mta.yaml` de tu proyecto, nunca.
 
 Salida típica en proyecto nuevo:
 
 ```text
-CREATE: AI/
+CREATE: AI/ (v0.3.0)
 CREATE: AGENTS.md
-OK: harness v0.2.4 instalado
+CLIENT: auto -> opencode
+CREATE: .opencode/ (+17 archivos)
+OK: harness v0.3.0 instalado
 ```
 
 ## Instalación asistida por agente
@@ -152,7 +156,7 @@ Vale para proyecto nuevo (con URL), existente, Windows/Linux/macOS y cualquier c
 PowerShell:
 
 ```powershell
-npx -p degit degit horangelmillan/harness-btp#v0.2.4 AI-tmp -- AI-tmp
+npx -p degit degit horangelmillan/harness-btp#v0.3.0 AI-tmp -- AI-tmp
 powershell -ExecutionPolicy Bypass -File AI-tmp/install.ps1 -Dest . -Force
 Remove-Item -Recurse -Force AI-tmp
 # tu versión anterior queda en AI.bak por si quieres comparar
@@ -161,7 +165,7 @@ Remove-Item -Recurse -Force AI-tmp
 bash:
 
 ```bash
-npx -p degit degit horangelmillan/harness-btp#v0.2.4 AI-tmp -- AI-tmp
+npx -p degit degit horangelmillan/harness-btp#v0.3.0 AI-tmp -- AI-tmp
 sh AI-tmp/install.sh --dest . --force
 rm -rf AI-tmp
 # tu versión anterior queda en AI.bak por si quieres comparar
@@ -192,9 +196,32 @@ El harness funciona con **cualquier** cliente agéntico que lea `AGENTS.md`. Est
 - **`AI/.opencode/`** — agentes, comandos y skills de ejemplo con el layout de OpenCode. Si tu cliente usa otro layout, ignóralos o adaptalos: el flujo vive en `AI/AGENTS.md`, `AI/INICIO.md`, `AI/docs/` y `AI/scripts/`, que son Markdown + shell portátil.
 - **`AI/opencode.fragment.jsonc`** — fragmento de ejemplo para fusionar en tu `opencode.jsonc` (p. ej. el bloque MCP `graphify-code`, deshabilitado por defecto). Solo aplica a OpenCode; otros clientes lo ignoran sin efecto.
 - **`install.ps1` / `install.sh`** — elige el de tu shell; ambos aplican la misma lógica idempotente. Los scripts de `AI/scripts/` también vienen en par `.ps1` / `.sh`.
+- **Multi-cliente:** desde v0.3.0 la fuente única es `AI/agents/`, `AI/commands/`, `AI/skills/` y cada cliente recibe su árbol renderizado en `AI/clients/<cliente>/` (ver [Multi-cliente](#multi-cliente)). `AI/.opencode/` se conserva intacto por compatibilidad.
 
 Nada del núcleo exige OpenCode, Windows ni ningún modelo concreto.
 
+## Multi-cliente
+
+El harness se configura para el cliente agéntico de turno desde UNA sola definición canónica:
+
+- **Canónico (`AI/`):** `AI/agents/*.md` (11 agentes), `AI/commands/*.md` (`flow`, `verify`), `AI/skills/*/SKILL.md` (4 skills). Es la única fuente que se edita a mano.
+- **Render (`AI/clients/`):** generado con `node scripts/render-clients.js` (sin dependencias); `node scripts/render-clients.js --check` solo verifica. El CI lo exige en verde antes de publicar (ver `.github/workflows/publish.yml`). No edites `AI/clients/` a mano: tus cambios se pierden en el próximo render.
+
+| Cliente | `--client` | Rutas generadas en la raíz | Adaptación |
+|---|---|---|---|
+| OpenCode | `opencode` | `.opencode/agents/`, `.opencode/commands/`, `.opencode/skills/` | copia exacta de `AI/.opencode/` |
+| Claude Code | `claude` | `.claude/agents/`, `.claude/commands/`, `.claude/skills/` | agents con `{name,description}` (sin `mode`) |
+| Cursor | `cursor` | `.cursor/commands/`, `.agents/skills/` | commands sin frontmatter (solo cuerpo) |
+| Copilot | `copilot` | `.github/agents/*.agent.md`, `.github/prompts/*.prompt.md`, `.github/skills/` | renombrados a su convención |
+| Aider (y genéricos) | `aider` | nada que generar | usan el `AGENTS.md` raíz |
+
+Flag `--client` en `install.ps1` (`-Client`), `install.sh` y `bin/harness-btp.js`:
+
+- `auto` (defecto): detecta por huellas (`CLAUDE.md`/`.claude`→claude, `.cursor`→cursor, `.github`→copilot, `opencode.json*`/`.opencode`→opencode); sin huellas usa opencode por compatibilidad histórica. Si hay huellas de varios clientes, fusiona los detectados.
+- `all`: fusiona los cuatro árboles.
+- Lista explícita (`-Client claude,cursor` / `--client claude,cursor`): solo esos.
+- Fusión idempotente con mensajes `CREATE:`/`SKIP:` por archivo y `BACKUP` a `<dir>.bak` con fuerza (mismo patrón que `AI/`).
+
 ## Estructura del repo
 
 ```text
@@ -202,18 +229,24 @@ harness-btp/
 ├── AI/                        # lo que queda instalado en tu proyecto
 │   ├── AGENTS.md              # reglas del harness (parametrizado, sin rutas absolutas)
 │   ├── INICIO.md              # punto de entrada para el agente
+│   ├── agents/                # CANÓNICO: 11 agentes (única fuente, se edita a mano)
+│   ├── commands/              # CANÓNICO: flow + verify (única fuente)
+│   ├── skills/                # CANÓNICO: 4 skills (única fuente)
+│   ├── clients/               # RENDERIZADO por scripts/render-clients.js (no editar a mano)
 │   ├── opencode.fragment.jsonc# ADAPTER opcional: ejemplo para opencode.jsonc
-│   ├── .opencode/             # ADAPTER opcional: agents + commands + skills de ejemplo
+│   ├── .opencode/             # ADAPTER opcional: se conserva intacto (compatibilidad)
 │   ├── scripts/               # pares .ps1 / .sh + provision-espacio.template.ps1
 │   ├── docs/                  # flujo-etapas, cf-safe, habilitacion-trial
 │   ├── specs/                 # plantilla _template.md
 │   └── .gitignore.fragment    # líneas a fusionar en tu .gitignore
+├── scripts/
+│   └── render-clients.js      # genera AI/clients/ desde el canónico (--check en CI)
 ├── templates/
 │   └── AGENTS.pointer.md      # plantilla del puntero AGENTS.md raíz
 ├── install.ps1 / install.sh   # instaladores idempotentes (SKIP / CREATE / BACKUP / OK)
 ├── bin/                       # ejecutable de create-harness-btp (pnpm dlx)
 ├── package.json               # name create-harness-btp
-└── VERSION                    # 0.2.4
+└── VERSION                    # 0.3.0
 ```
 
 ## Cómo lo descubre el agente
@@ -230,12 +263,14 @@ Tú no configuras nada: el agente se adapta solo.
 | Problema | Causa | Comando |
 |---|---|---|
 | `SKIP: AI/ ya existe` y quería actualizar | reinstalación sin fuerza conserva lo existente | repite con `-Force` (`.ps1`) o `--force` (`.sh`); guarda `AI.bak` |
+| No aparece `orchestrator` / no existe `/flow` | fusión a `.opencode/` raíz ausente (OpenCode solo descubre `.opencode/` en la raíz del proyecto, no `AI/.opencode/`) | reinstala sin fuerza (copia solo faltantes) o copia `AI/.opencode/` a `.opencode/` en la raíz sin pisar archivos propios |
 | Mi `AGENTS.md` propio desapareció | se instaló con fuerza | recupera `AGENTS.md.bak` |
 | Líneas duplicadas en `.gitignore` | edición manual tras la fusión | el instalador fusiona sin duplicar; borra el duplicado a mano |
 | `ExecutionPolicy` bloquea `install.ps1` | política de PowerShell | `powershell -ExecutionPolicy Bypass -File AI-tmp/install.ps1 -Dest .` (o usa `install.sh` en Git Bash) |
 | `ABORT: opción desconocida` en `install.sh` | flag inexistente | `sh install.sh --help` lista `--dest`, `--force` |
-| `degit` falla sin Node | `degit` corre sobre Node 18+ | instala Node o usa `git clone --branch v0.2.4` |
+| `degit` falla sin Node | `degit` corre sobre Node 18+ | instala Node o usa `git clone --branch v0.3.0` |
 | Tu cliente no lee los agentes de `.opencode/` | layout específico de OpenCode | son un adapter opcional; el flujo está en `AI/AGENTS.md` + `AI/INICIO.md` |
+| Mi cliente no ve los agentes (claude/cursor/copilot) | instalaste sin el `--client` que usa tu proyecto (`auto` no encontró sus huellas) | reinstala sin fuerza con `--client <tu-cliente>` (p. ej. `--client claude`) y verifica la tabla de [Multi-cliente](#multi-cliente): `.claude/`, `.cursor/commands/` + `.agents/skills/`, o `.github/agents\|prompts\|skills` según cliente; si sigue sin verlos, revisa la fusión y no dupliques archivos a mano |
 | No se deja borrar la carpeta del proyecto ("Carpeta en uso") | procesos huérfanos parados dentro (shells/MCPs de una sesión ya cerrada) | resmon → CPU → Identificadores asociados → busca la carpeta y termina solo esos PIDs; nunca fueron del instalador (solo copia archivos y termina) |
 
 ## Compatibilidad
@@ -262,8 +297,11 @@ MIT. Haz lo que quieras con el harness; sin garantía.
 
 ## Changelog
 
+- **v0.3.0** — multi-cliente: definición canónica única en `AI/agents/`, `AI/commands/`, `AI/skills/`; render a `AI/clients/<cliente>/` con `scripts/render-clients.js` (opencode byte-idéntico a `AI/.opencode/`, que se conserva intacto); instaladores con flag `--client auto|all|<lista>` (detección por huellas, fusión idempotente con `SKIP`/`BACKUP` por dir); `prompts/setup.md` pregunta el cliente si es ambiguo y verifica adopción por cliente; CI exige `render-clients.js --check` antes de la guardia de versiones.
+
+- **v0.3.0** — fusión a `.opencode/` raíz: el instalador sincroniza `AI/.opencode/` (agents + commands + skills) en `.opencode/` del proyecto para que OpenCode descubra `orchestrator` y `/flow` (SKIP sin fuerza, `.opencode.bak` con fuerza); `prompts/setup.md` verifica adopción y fusiona el fragmento MCP.
 - **v0.2.4** — estilo Neon: una línea que lee `prompts/setup.md` (versionado, siempre al día) en vez de un bloque que caduca.
 - **v0.2.3** — prompt universal todo-en-uno: clona + instala con la versión que indique el README (nunca caduca), verifica AI/VERSION instalado.
 - **v0.2.2** — anti-huérfanos: bloque de agente con regla de cierre limpio (no dejar servidores corriendo, no borrar carpetas con procesos dentro) + troubleshooting de carpeta bloqueada (resmon → Identificadores asociados).
 - **v0.2.1** — trazabilidad y versión visible: `AI/VERSION` viaja en el paquete, los instaladores imprimen la versión (`OK: harness vX.Y.Z…`, `BACKUP` con vieja→nueva) y el workflow exige que `package.json`, `VERSION` y `AI/VERSION` coincidan. Comandos fijados a `@0.2.1` / `#v0.2.1` / `--branch v0.2.1`.
-- **v0.2.0** — versión inicial: carpeta `AI/` parametrizada, instaladores idempotentes `install.ps1` / `install.sh`, `create-harness-btp` vía `pnpm dlx`, plantilla de puntero, docs de flujo / cf-safe / habilitación trial, plantilla de spec.
+- **v0.2.0** — versión inicial: carpeta `AI/` parametrizada, instaladores idempotentes `install.ps1` / `install.sh`, `create-harness-btp` vía `pnpm dlx`, plantilla de puntero, docs de flujo / cf-safe / habilitación trial, plantilla de spec.

package/VERSION

@@ -1 +1 @@
-0.2.4
+0.3.0

package/bin/harness-btp.js

@@ -1,6 +1,8 @@
 #!/usr/bin/env node
-// harness-btp init --dest <dir> [--force] [--ref <tag>]
-// Copia AI/, crea AGENTS.md puntero y fusiona .gitignore. Sin secretos.
+// harness-btp init --dest <dir> [--force] [--ref <tag>] [--client auto|all|opencode,claude,...]
+// Copia AI/, crea AGENTS.md puntero, fusiona el árbol del cliente agéntico
+// desde AI/clients/<cliente>/ en la raíz (solo faltantes; con --force hace
+// backup a <dir>.bak) y fusiona .gitignore. Sin secretos.
 // No toca package.json ni mta.yaml del proyecto.
 const fs = require("fs");
 const path = require("path");
@@ -18,10 +20,11 @@ if (!cmd || cmd.startsWith("-")) {
 const dest = arg("--dest", ".");
 const force = process.argv.includes("--force");
 const ref = arg("--ref", null);
+const clientSpec = arg("--client", "auto");
 const src = path.join(__dirname, "..");
 
 if (cmd !== "init") {
-  console.log("Uso: harness-btp init --dest <dir> [--force] [--ref <tag>]");
+  console.log("Uso: harness-btp init --dest <dir> [--force] [--ref <tag>] [--client auto|all|opencode,claude,...]");
   process.exit(1);
 }
 if (ref) console.log("REF: " + ref + " (el paquete incluye su propia versión; ver VERSION)");
@@ -61,6 +64,87 @@ if (fs.existsSync(agentsDst)) {
   console.log("CREATE: AGENTS.md (puntero a AI/AGENTS.md)");
 }
 
+const KNOWN = ["opencode", "claude", "cursor", "copilot", "aider"];
+function resolveClients(spec, destDir) {
+  const s = (spec + "").trim().toLowerCase();
+  if (s === "auto") {
+    const d = [];
+    if (fs.existsSync(path.join(destDir, "CLAUDE.md")) || fs.existsSync(path.join(destDir, ".claude"))) d.push("claude");
+    if (fs.existsSync(path.join(destDir, ".cursor"))) d.push("cursor");
+    if (fs.existsSync(path.join(destDir, ".github"))) d.push("copilot");
+    if (fs.readdirSync(destDir, { withFileTypes: true }).some((e) => e.isFile() && e.name.startsWith("opencode.json")) || fs.existsSync(path.join(destDir, ".opencode"))) d.push("opencode");
+    if (!d.length) d.push("opencode");
+    console.log("CLIENT: auto -> " + d.join(","));
+    return d;
+  }
+  if (s === "all") return ["opencode", "claude", "cursor", "copilot"];
+  const list = s.split(",").map((x) => x.trim().toLowerCase()).filter(Boolean);
+  for (const c of list) {
+    if (!KNOWN.includes(c)) {
+      console.log("ABORT: cliente desconocido '" + c + "' (usa auto|all|opencode,claude,cursor,copilot,aider)");
+      process.exit(1);
+    }
+  }
+  if (!list.length) {
+    console.log("ABORT: --client vacío (usa auto|all|opencode,claude,cursor,copilot,aider)");
+    process.exit(1);
+  }
+  return list;
+}
+
+function mergeTree(treeSrc, treeDst, label) {
+  if (!fs.existsSync(treeSrc)) {
+    console.log("AVISO: no existe " + treeSrc + " (regenera con node scripts/render-clients.js)");
+    return;
+  }
+  const bakLabel = label.replace(/\/$/, "") + ".bak";
+  if (force) {
+    if (fs.existsSync(treeDst)) {
+      const bak = treeDst + ".bak";
+      fs.rmSync(bak, { recursive: true, force: true });
+      fs.renameSync(treeDst, bak);
+      console.log("BACKUP: " + label + " -> " + bakLabel);
+    }
+    fs.cpSync(treeSrc, treeDst, { recursive: true });
+    console.log("CREATE: " + label + " (+" + listFilesRec(treeDst, treeDst).length + " archivos)");
+  } else {
+    let count = 0;
+    for (const rel of listFilesRec(treeSrc, treeSrc)) {
+      const tgt = path.join(treeDst, rel);
+      if (fs.existsSync(tgt)) {
+        console.log("SKIP: " + label + rel.split(path.sep).join("/") + " ya existe");
+      } else {
+        fs.mkdirSync(path.dirname(tgt), { recursive: true });
+        fs.copyFileSync(path.join(treeSrc, rel), tgt);
+        count++;
+      }
+    }
+    console.log("CREATE: " + label + " (+" + count + " archivos)");
+  }
+}
+
+const clientsSrc = path.join(src, "AI", "clients");
+for (const c of resolveClients(clientSpec, dest)) {
+  if (c === "opencode") mergeTree(path.join(clientsSrc, "opencode"), path.join(dest, ".opencode"), ".opencode/");
+  else if (c === "claude") mergeTree(path.join(clientsSrc, "claude"), path.join(dest, ".claude"), ".claude/");
+  else if (c === "cursor") {
+    mergeTree(path.join(clientsSrc, "cursor", "commands"), path.join(dest, ".cursor", "commands"), ".cursor/commands/");
+    mergeTree(path.join(clientsSrc, "cursor", "skills"), path.join(dest, ".agents", "skills"), ".agents/skills/");
+  } else if (c === "copilot") {
+    mergeTree(path.join(clientsSrc, "copilot", "agents"), path.join(dest, ".github", "agents"), ".github/agents/");
+    mergeTree(path.join(clientsSrc, "copilot", "skills"), path.join(dest, ".github", "skills"), ".github/skills/");
+    mergeTree(path.join(clientsSrc, "copilot", "prompts"), path.join(dest, ".github", "prompts"), ".github/prompts/");
+  } else if (c === "aider") console.log("SKIP: aider usa AGENTS.md raiz (nada que fusionar)");
+}
+function listFilesRec(dir, base) {
+  let out = [];
+  for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
+    const p = path.join(dir, e.name);
+    if (e.isDirectory()) out = out.concat(listFilesRec(p, base));
+    else out.push(path.relative(base, p));
+  }
+  return out;
+}
 const frag = fs.readFileSync(path.join(src, "AI", ".gitignore.fragment"), "utf8")
   .split(/\r?\n/).map((l) => l.trim()).filter((l) => l && !l.startsWith("#"));
 let cur = [];