theus-cli-linux-x64 0.2.84

package/vendor/theus-arsenal/commands/build-kotlin.md

@@ -0,0 +1,176 @@
+---
+description: Corrige incrementalmente errores de build de Kotlin/Gradle, advertencias del compilador y problemas de dependencias. Invoca al agente resolutor-builds-kotlin para arreglos mínimos y quirúrgicos.
+---
+
+# Build y corrección de Kotlin
+
+Este comando invoca al agente **resolutor-builds-kotlin** para corregir incrementalmente errores de build de Kotlin con cambios mínimos.
+
+## Qué hace este comando
+
+1. **Ejecutar diagnósticos**: correr `./gradlew build`, `detekt`, `ktlintCheck`
+2. **Parsear errores**: agrupar por archivo y ordenar por severidad
+3. **Corregir incrementalmente**: un error a la vez
+4. **Verificar cada arreglo**: reejecutar el build tras cada cambio
+5. **Informar el resumen**: mostrar qué se corrigió y qué queda pendiente
+
+## Cuándo usarlo
+
+Usa `/build-kotlin` cuando:
+
+- `./gradlew build` falla con errores
+- El compilador de Kotlin reporta errores
+- `./gradlew detekt` reporta violaciones
+- Falla la resolución de dependencias de Gradle
+- Después de traer cambios (pull) que rompen el build
+
+## Comandos de diagnóstico ejecutados
+
+```bash
+# Verificación principal del build
+./gradlew build 2>&1
+
+# Análisis estático
+./gradlew detekt 2>&1 || echo "detekt no configurado"
+./gradlew ktlintCheck 2>&1 || echo "ktlint no configurado"
+
+# Problemas de dependencias
+./gradlew dependencies --configuration runtimeClasspath 2>&1 | head -100
+
+# Refresco profundo opcional cuando las cachés o los metadatos de dependencias son sospechosos
+./gradlew build --refresh-dependencies
+```
+
+## Sesión de ejemplo
+
+````text
+Usuario: /build-kotlin
+
+Agente:
+# Resolución de build de Kotlin
+
+## Diagnóstico inicial
+
+```bash
+$ ./gradlew build
+e: src/main/kotlin/com/example/service/UserService.kt:25:15 Unresolved reference: UserRepository
+e: src/main/kotlin/com/example/routes/UserRoutes.kt:42:9 Type mismatch: inferred type is String but Int was expected
+e: src/main/kotlin/com/example/routes/UserRoutes.kt:58:5 'when' expression must be exhaustive
+```
+
+Errores encontrados: 3
+
+## Arreglo 1: referencia sin resolver
+
+Archivo: src/main/kotlin/com/example/service/UserService.kt:25
+Error: Unresolved reference: UserRepository
+Causa: falta el import
+
+```kotlin
+// Import agregado
+import com.example.repository.UserRepository
+```
+
+```bash
+$ ./gradlew build
+# Quedan 2 errores
+```
+
+## Arreglo 2: incompatibilidad de tipos
+
+Archivo: src/main/kotlin/com/example/routes/UserRoutes.kt:42
+Error: Type mismatch: inferred type is String but Int was expected
+
+```kotlin
+// Se cambió
+val count = call.parameters["count"]
+// Por
+val count = call.parameters["count"]?.toIntOrNull()
+    ?: return@get call.respond(HttpStatusCode.BadRequest, "Invalid count")
+```
+
+```bash
+$ ./gradlew build
+# Queda 1 error
+```
+
+## Arreglo 3: `when` no exhaustivo
+
+Archivo: src/main/kotlin/com/example/routes/UserRoutes.kt:58
+Error: 'when' expression must be exhaustive
+
+```kotlin
+// Rama faltante agregada
+when (user.role) {
+    Role.ADMIN -> handleAdmin(user)
+    Role.USER -> handleUser(user)
+    Role.MODERATOR -> handleModerator(user) // Agregado
+}
+```
+
+```bash
+$ ./gradlew build
+# ¡Build exitoso!
+```
+
+## Verificación final
+
+```bash
+$ ./gradlew detekt
+# Sin problemas
+
+$ ./gradlew test
+# Todas las pruebas pasaron
+```
+
+## Resumen
+
+| Métrica | Cantidad |
+|---------|----------|
+| Errores de build corregidos | 3 |
+| Problemas de detekt corregidos | 0 |
+| Archivos modificados | 2 |
+| Problemas restantes | 0 |
+
+Estado del build: CORRECTO
+````
+
+## Errores comunes corregidos
+
+| Error | Arreglo típico |
+|-------|----------------|
+| `Unresolved reference: X` | Agregar import o dependencia |
+| `Type mismatch` | Corregir la conversión de tipos o la asignación |
+| `'when' must be exhaustive` | Agregar las ramas faltantes de la clase sellada |
+| `Suspend function can only be called from coroutine` | Agregar el modificador `suspend` |
+| `Smart cast impossible` | Usar un `val` local o `let` |
+| `None of the following candidates is applicable` | Corregir los tipos de los argumentos |
+| `Could not resolve dependency` | Corregir la versión o agregar el repositorio |
+
+## Estrategia de corrección
+
+1. **Primero los errores de build** — el código debe compilar
+2. **Segundo las violaciones de detekt** — corregir problemas de calidad de código
+3. **Tercero las advertencias de ktlint** — corregir el formato
+4. **Un arreglo a la vez** — verificar cada cambio
+5. **Cambios mínimos** — no refactorizar, solo corregir
+
+## Condiciones de parada
+
+El agente se detendrá e informará si:
+
+- El mismo error persiste tras 3 intentos
+- Un arreglo introduce más errores
+- Se requieren cambios de arquitectura
+- Faltan dependencias externas
+
+## Comandos relacionados
+
+- `/test-kotlin` — ejecutar las pruebas cuando el build pase
+- `/revisar-kotlin` — revisar la calidad del código
+- Skill `bucle-verificacion` — bucle de verificación completo
+
+## Relacionado
+
+- Agente: `agents/resolutor-builds-kotlin.md`
+- Skill: `skills/patrones-kotlin/`

package/vendor/theus-arsenal/commands/build-react.md

@@ -0,0 +1,187 @@
+---
+description: Arregla fallos de build de React (Vite, webpack, Next.js, CRA, Parcel, esbuild, Bun) de forma incremental — errores de compilación JSX/TSX, desajustes de hidratación, fallos de límite entre componentes de servidor/cliente, tipos faltantes. Invoca al agente resolutor-builds-react para correcciones mínimas y quirúrgicas.
+---
+
+# Build y arreglo de React
+
+Este comando invoca al agente **resolutor-builds-react** para corregir errores de build de React de forma incremental y con cambios mínimos.
+
+## Qué hace este comando
+
+1. **Detectar el sistema de build**: identifica Vite, webpack, Next.js, CRA, Parcel, esbuild o Bun
+2. **Ejecutar el build**: corre el script de build del proyecto
+3. **Analizar los errores**: los agrupa por capa (TypeScript / configuración del bundler / runtime / hidratación)
+4. **Corregir incrementalmente**: un error a la vez, re-ejecutando el build tras cada cambio
+5. **Reportar un resumen**: muestra qué se corrigió y qué queda pendiente
+
+## Cuándo usarlo
+
+Usa `/build-react` cuando:
+
+- `npm run build` (o el equivalente con pnpm/yarn/bun) falla
+- Hay errores de compilación JSX/TSX tras una actualización de TypeScript o React
+- Aparecen errores de desajuste de hidratación de Next.js en tiempo de ejecución
+- Hay errores de límite entre Server/Client Components en App Router
+- Después de instalar o actualizar `react`, `react-dom`, `@types/react` o un bundler
+- Hay tipos faltantes o errores de "module not found" que involucran a React
+
+## Alcance
+
+Este comando es dueño de los fallos de **build/bundler/hidratación en runtime de React**. Para errores de tipos de TypeScript puros sin React involucrado, usa `/arreglar-build` (genérico).
+
+## Comandos de diagnóstico que se ejecutan
+
+```bash
+# Script de build del proyecto (preferido)
+npm run build --if-present
+pnpm build 2>/dev/null
+yarn build 2>/dev/null
+bun run build 2>/dev/null
+
+# Typecheck independiente
+npm run typecheck --if-present
+tsc --noEmit -p tsconfig.json
+
+# Alternativa específica por bundler
+next build                          # Next.js
+vite build                          # Vite
+react-scripts build                 # CRA
+webpack --mode=production           # webpack
+parcel build src/index.html         # Parcel
+bun build ./src/index.tsx --outdir=dist
+```
+
+## Sesión de ejemplo
+
+````text
+Usuario: /build-react
+
+Agente:
+# Resolución de build de React
+
+## Sistema de build detectado
+Vite (vite.config.ts presente, @vitejs/plugin-react en las dependencias)
+
+## Diagnóstico inicial
+
+```bash
+$ npm run build
+> tsc -b && vite build
+
+src/components/UserCard.tsx:1:8 - error TS6133: 'React' is declared but its value is never read.
+src/components/Modal.tsx:12:15 - error TS7016: Could not find a declaration file for module 'react-portal'.
+src/pages/Home.tsx:42:5 - error: 'useState' is not defined
+```
+
+Errores encontrados: 3
+
+## Corrección 1: resto del transform JSX antiguo
+
+Archivo: src/components/UserCard.tsx:1
+Causa: `tsconfig.json` ya usa `"jsx": "react-jsx"`; el `import React` explícito no se usa.
+
+```tsx
+// Eliminado
+- import React from 'react';
+```
+
+```bash
+$ npm run build
+# Quedan 2 errores
+```
+
+## Corrección 2: tipos faltantes
+
+Archivo: src/components/Modal.tsx
+Causa: `@types/react-portal` no está instalado.
+
+```bash
+$ npm i -D @types/react-portal
+added 1 package
+```
+
+```bash
+$ npm run build
+# Queda 1 error
+```
+
+## Corrección 3: import de hook faltante
+
+Archivo: src/pages/Home.tsx
+Causa: se referencia `useState` pero no está importado.
+
+```tsx
+- import { useEffect } from "react";
++ import { useEffect, useState } from "react";
+```
+
+```bash
+$ npm run build
+# ¡Build exitoso!
+```
+
+## Verificación final
+
+```bash
+$ npm run build
+✓ built in 2.34s
+
+$ npm test
+✓ 47 tests passed
+```
+
+## Resumen
+
+| Métrica | Cantidad |
+|--------|-------|
+| Errores de build corregidos | 3 |
+| Archivos modificados | 2 |
+| Dependencias añadidas | 1 (@types/react-portal) |
+| Problemas restantes | 0 |
+
+Estado del build: PASS: ÉXITO
+````
+
+## Errores comunes que corrige
+
+| Error | Corrección típica |
+|---|---|
+| `'React' is not defined` | Configurar `"jsx": "react-jsx"` en tsconfig (React 17+) |
+| Falta `@types/react` | `npm i -D @types/react @types/react-dom` |
+| `Unexpected token '<'` | Añadir `@vitejs/plugin-react` / `babel-loader` |
+| `You're importing a component that needs useState` (Next.js) | Añadir `"use client"` o mover el hook a un hijo Client Component |
+| `Module not found: Can't resolve 'fs'` (Next.js) | Quitar el import de `fs` o mover la lógica a un Server Component / ruta de API |
+| `Hydration failed because the initial UI does not match` | Mover `Date.now()`/`Math.random()`/`window.*` a `useEffect` |
+| `Invalid hook call` | Múltiples copias de React — deduplica con `resolutions`/`overrides` |
+| `Element type is invalid` | Desajuste entre import por defecto e import con nombre |
+
+## Estrategia de corrección
+
+1. **Primero los errores de compilación** — el código debe compilar
+2. **Segundo los errores de hidratación** — afectan la corrección en producción
+3. **Tercero la configuración del bundler** — restaurar la corrección de plugins/loaders
+4. **Una corrección a la vez** — verificar cada cambio
+5. **Cambios mínimos** — nunca usar `// @ts-ignore` sin explicación
+6. **Re-ejecutar tras cada corrección** — hacer aflorar errores nuevos de inmediato
+
+## Condiciones de parada
+
+El agente se detendrá y reportará si:
+
+- El mismo error persiste tras 3 intentos
+- Una corrección introduce más errores de los que resuelve
+- Se requiere un cambio arquitectónico que excede la resolución del build (p. ej., rediseñar el límite RSC)
+- La versión del bundler ya no soporta la versión mayor de React instalada
+
+## Comandos relacionados
+
+- `/test-react` — ejecutar tests después de que el build esté en verde
+- `/revisar-react` — revisar la calidad del código después de que el build tenga éxito
+- `/arreglar-build` — arreglador de builds genérico (no React)
+- Skill `bucle-verificacion` — bucle de verificación completo
+
+## Relacionado
+
+- Agente: `agents/resolutor-builds-react.md`
+- Skills: `skills/patrones-react/`, `skills/patrones-frontend/`
+- Reglas: `rules/react/coding-style.md`, `rules/react/patterns.md`

package/vendor/theus-arsenal/commands/build-rust.md

@@ -0,0 +1,187 @@
+---
+description: Corrige errores de build de Rust, problemas del borrow checker y de dependencias de forma incremental. Invoca al agente resolutor-builds-rust para arreglos mínimos y quirúrgicos.
+---
+
+# Build y corrección de Rust
+
+Este comando invoca al agente **resolutor-builds-rust** para corregir errores de build de Rust de forma incremental y con cambios mínimos.
+
+## Qué hace este comando
+
+1. **Ejecutar diagnósticos**: `cargo check`, `cargo clippy`, `cargo fmt --check`
+2. **Parsear errores**: identificar códigos de error y archivos afectados
+3. **Corregir incrementalmente**: un error a la vez
+4. **Verificar cada arreglo**: volver a ejecutar `cargo check` tras cada cambio
+5. **Informar el resumen**: mostrar qué se corrigió y qué queda pendiente
+
+## Cuándo usarlo
+
+Usa `/build-rust` cuando:
+- `cargo build` o `cargo check` fallan con errores
+- `cargo clippy` reporta advertencias
+- Errores del borrow checker o de lifetimes bloquean la compilación
+- Falla la resolución de dependencias de Cargo
+- Tras hacer pull de cambios que rompen el build
+
+## Comandos de diagnóstico ejecutados
+
+```bash
+# Verificación principal del build
+cargo check 2>&1
+
+# Lints y sugerencias
+cargo clippy -- -D warnings 2>&1
+
+# Verificación de formato
+cargo fmt --check 2>&1
+
+# Problemas de dependencias
+cargo tree --duplicates
+
+# Auditoría de seguridad (si está disponible)
+if command -v cargo-audit >/dev/null; then cargo audit; else echo "cargo-audit no está instalado"; fi
+```
+
+## Ejemplo de sesión
+
+````text
+Usuario: /build-rust
+
+Agente:
+# Resolución del build de Rust
+
+## Diagnóstico inicial
+
+```bash
+$ cargo check
+error[E0502]: cannot borrow `map` as mutable because it is also borrowed as immutable
+  --> src/service/cache.rs:25:5
+error[E0308]: mismatched types
+  --> src/handler/api.rs:42:12
+error[E0425]: cannot find value `db` in this scope
+  --> src/handler/api.rs:58:9
+```
+
+Errores encontrados: 3
+
+## Arreglo 1: error del borrow checker
+
+Archivo: src/service/cache.rs:25
+Error: E0502 — no se puede tomar `map` como mutable porque ya está prestado como inmutable
+Causa: el préstamo inmutable sigue activo durante el insert mutable
+
+```rust
+// Cambio: reestructurado para terminar el préstamo inmutable antes del acceso mutable
+if !map.contains_key("key") {
+    map.insert("key".into(), default);
+}
+```
+
+```bash
+$ cargo check
+# Quedan 2 errores
+```
+
+## Arreglo 2: tipos incompatibles
+
+Archivo: src/handler/api.rs:42
+Error: E0308 — tipos incompatibles: se esperaba `usize`, se encontró `&str`
+
+```rust
+// Antes
+let count = params.get("count");
+// Después
+let count: usize = params.get("count")
+    .and_then(|s| s.parse().ok())
+    .unwrap_or(0);
+```
+
+```bash
+$ cargo check
+# Queda 1 error
+```
+
+## Arreglo 3: nombre sin resolver
+
+Archivo: src/handler/api.rs:58
+Error: E0425 — no se encuentra el valor `db` en este ámbito
+Causa: falta el import
+
+```rust
+// Añadido
+use crate::db;
+```
+
+```bash
+$ cargo check
+# ¡Build exitoso!
+```
+
+## Verificación final
+
+```bash
+$ cargo clippy -- -D warnings
+# Sin advertencias
+
+$ cargo test
+running 6 tests
+test service::cache::tests::test_insert ... ok
+test service::cache::tests::test_get ... ok
+test handler::api::tests::test_parse_count ... ok
+test handler::api::tests::test_missing_count ... ok
+test handler::api::tests::test_db_import ... ok
+test handler::api::tests::test_response ... ok
+
+test result: ok. 6 passed; 0 failed; 0 ignored
+```
+
+## Resumen
+
+| Métrica | Cantidad |
+|--------|-------------|
+| Errores de build corregidos | 3 |
+| Advertencias de clippy corregidas | 0 |
+| Archivos modificados | 2 |
+| Problemas restantes | 0 |
+
+Estado del build: ÉXITO
+````
+
+## Errores comunes corregidos
+
+| Error | Arreglo típico |
+|-------|-------------|
+| `cannot borrow as mutable` | Reestructurar para terminar antes el préstamo inmutable; clonar solo si está justificado |
+| `does not live long enough` | Usar un tipo con propiedad o añadir anotación de lifetime |
+| `cannot move out of` | Reestructurar para tomar la propiedad; clonar solo como último recurso |
+| `mismatched types` | Añadir `.into()`, `as` o una conversión explícita |
+| `trait X not implemented` | Añadir `#[derive(Trait)]` o implementarlo a mano |
+| `unresolved import` | Añadir a Cargo.toml o corregir la ruta del `use` |
+| `cannot find value` | Añadir el import o corregir la ruta |
+
+## Estrategia de corrección
+
+1. **Primero los errores de build** — el código debe compilar
+2. **Luego las advertencias de clippy** — corregir construcciones sospechosas
+3. **Después el formato** — cumplir con `cargo fmt`
+4. **Un arreglo a la vez** — verificar cada cambio
+5. **Cambios mínimos** — no refactorizar, solo corregir
+
+## Condiciones de parada
+
+El agente se detendrá e informará si:
+- El mismo error persiste tras 3 intentos
+- Un arreglo introduce más errores
+- Se requieren cambios de arquitectura
+- Un error del borrow checker exige rediseñar la propiedad de los datos
+
+## Comandos relacionados
+
+- `/test-rust` — ejecutar los tests cuando el build pase
+- `/revisar-rust` — revisar la calidad del código
+- Skill `bucle-verificacion` — bucle de verificación completo
+
+## Relacionados
+
+- Agente: `agents/resolutor-builds-rust.md`
+- Skill: `skills/patrones-rust/`

package/vendor/theus-arsenal/commands/campana-marketing.md

@@ -0,0 +1,125 @@
+---
+description: Planifica y ejecuta una campaña de marketing completa. Acepta un brief de producto y devuelve posicionamiento, copy de landing page, secuencia de correos, publicaciones sociales, variantes de anuncios, guiones de video y un calendario de contenidos. También puede auditar copy existente por calidad de conversión.
+allowed-tools: ["Read", "Grep", "Glob", "WebSearch", "WebFetch", "Write"]
+---
+
+# /campana-marketing
+
+Planifica y ejecuta una campaña de marketing, desde el brief hasta la suite completa de contenidos.
+
+## Uso
+
+```
+/campana-marketing                              # Solicita el brief de forma interactiva
+/campana-marketing [brief de producto]          # Campaña completa desde un brief en línea
+/campana-marketing copy [tipo]                  # Solo un entregable
+/campana-marketing review [archivo-o-brief]     # Auditoría de copy por conversión y consistencia de marca
+```
+
+## Qué hace
+
+1. **Investigación** — Perfila la audiencia objetivo y mapea a la competencia antes de escribir nada
+2. **Posicionamiento** — Fija primero el ángulo de la campaña y el perfil de tono
+3. **Producción de copy** — Genera la suite completa de contenidos en el orden correcto (landing page → correos → redes sociales → anuncios → guiones de video → calendario)
+4. **Revisión** — Pasa toda la salida por una lista de verificación de conversión y consistencia de marca
+
+## Modos
+
+### Modo de campaña completa
+
+Proporciona un brief de producto que contenga:
+- Nombre y descripción del producto
+- Audiencia objetivo (específica, no genérica)
+- Problema central que el producto resuelve
+- Beneficio / resultado central
+- Guía de tono
+- Canales requeridos
+- Meta de lanzamiento o cronograma
+
+El agente devuelve todos los entregables de la campaña en orden, con un resumen de revisión del copy al final.
+
+### Modo de entregable único
+
+```
+/campana-marketing copy landing-page
+/campana-marketing copy email-sequence
+/campana-marketing copy social-posts
+/campana-marketing copy ads
+/campana-marketing copy video-scripts
+```
+
+Requiere que el posicionamiento esté definido primero. Ejecuta el modo completo o proporciona el ángulo antes de pedir un entregable único.
+
+### Modo de revisión de copy
+
+```
+/campana-marketing review ruta/al/copy.md
+/campana-marketing review "pega el copy aquí"
+```
+
+Devuelve una auditoría estructurada contra:
+- Prueba de claridad de 5 segundos (copy sobre el pliegue)
+- Calidad del CTA (específico, ganado, uno por pieza)
+- Consistencia del tono de marca
+- Especificidad y sustentabilidad de las afirmaciones
+- Ajuste nativo a cada plataforma
+- Consistencia entre canales
+
+## Plantilla de brief
+
+```markdown
+Producto: [nombre]
+Descripción: [1-3 oraciones sobre qué hace]
+Audiencia: [quién, específicamente]
+Problema: [el dolor concreto que el producto resuelve]
+Beneficio: [el resultado que obtiene el usuario]
+Tono: [adjetivos + qué evitar]
+Canales: [landing page, correo, LinkedIn, X, anuncios, video]
+Meta: [lanzamiento, lista de espera, registros, awareness — y cronograma]
+```
+
+## Ubicación de la salida
+
+Al guardar los activos de la campaña, la convención es `.theus/campaigns/{nombre-de-campana}/`:
+
+```
+.theus/campaigns/lanzamiento-producto/
+├── positioning.md
+├── landing-page.md
+├── email-sequence.md
+├── social-posts.md
+├── ad-copy.md
+├── video-scripts.md
+└── content-calendar.md
+```
+
+Confirma la ubicación de guardado antes de escribir archivos.
+
+## Ejemplos
+
+```
+/campana-marketing Construye una campaña de lanzamiento de 7 días para una plataforma de carrera con IA dirigida a estudiantes universitarios del Reino Unido.
+```
+
+```
+/campana-marketing copy landing-page
+```
+
+```
+/campana-marketing review .theus/campaigns/mi-campana/landing-page.md
+```
+
+## Delegación a agentes y skills
+
+Este comando invoca:
+- `estratega-marketing` — planificación de campaña y producción de copy
+- `voz-de-marca` — captura de voz cuando hay que fijar el tono en varias salidas
+- `motor-de-contenido` — producción de contenido social nativo por plataforma
+- `publicacion-cruzada` — distribución multiplataforma
+- `investigacion-profunda` — inteligencia profunda de audiencia o de competencia
+
+## Comandos relacionados
+
+- `/plan` — Planificación estratégica antes de una campaña
+- `/plan-prd` — Documento de requisitos de producto antes de armar el brief de campaña
+- `/revisar-codigo` — Revisar el código detrás de la implementación de una landing page