# Manual AGENC-IA

> Para cuando se te olvide. Tres minutos de lectura.
>
> Última actualización: 2026-07-31

---

## Lo que hay que recordar

**Una sola carpeta:**

```
C:\Users\Med Lab\Documents\Clientes\Second Brain\agencia\
```

**Una sola regla:** se edita en `motor\skills\`. Solo ahí.

---

## Mapa de la carpeta

| Carpeta / archivo | Qué es | ¿Se edita? |
|---|---|---|
| `MANUAL.md` | este archivo | sí |
| `ARQUITECTURA.md` | decisiones, reglas de negocio, modelo | sí |
| `motor\MANIFIESTO.md` | registro de los 48 módulos | sí |
| `motor\COMO-AGREGAR-MODULO.md` | cómo agregar uno nuevo | consulta |
| **`motor\skills\`** | **los 48 módulos. Aquí se trabaja** | **SÍ** |
| `motor\skills\_shared\` | lo que usan varios módulos | sí |
| `motor\sync.ps1` | empuja a Codex y Antigravity | ejecutar |
| `plantillas\_ESTRUCTURA\` | plantilla privada a copiar por cliente | sí |
| `02-proyectos\{cliente}\` | datos de cada cliente | sí |
| `motor\_biblioteca\` | respaldo histórico por origen | **NO** |
| `motor\_archivadas\` | módulos retirados | **NO** |
| `motor\_INVENTARIO.md` | historial de la consolidación | **NO** |

---

## Cómo usar los módulos

### En Cowork y Claude Desktop

**Se activan solos.** No hay que invocarlos por nombre. Basta pedir lo que
quieres en español normal:

| Dices esto | Se activa |
|---|---|
| "hazme unos banners para {cliente}" | `creative-marketing-engine` |
| "genera una imagen de…" | `higgsfield-generate` |
| "arma el sitio de {cliente}" | `sitios-web-med` |
| "necesito prompts de video para…" | `ai-video-director` |
| "haz el temario de contenido" | `content-blueprint` |
| "escribe el artículo y publícalo" | `article-developer` |
| "empieza el módulo 1" | `market-intelligence` |
| "construye la landing" | `landing-krafter` |
| "entrena mi Soul" | `higgsfield-soul-id` |

Si no se activa el que querías, pídelo por nombre: *"usa creative-marketing-engine"*.

### En Codex y Antigravity

Leen la carpeta directamente. Correr el sync una vez:

```powershell
cd "C:\Users\Med Lab\Documents\Clientes\Second Brain\agencia\motor"
.\sync.ps1                # simula, no copia
.\sync.ps1 -Aplicar       # copia de verdad
.\sync.ps1 -Empaquetar    # .zip para otra máquina
```

**Antes de correrlo con `-Aplicar`, revisa las rutas de destino** al inicio del
script. Corre solo una revisión de credenciales y se detiene si encuentra algo.

---

## El flujo completo de un cliente

```
1. market-intelligence      → avatar, dolores, keywords, pilares
2. oferta-irresistible      → la oferta
3. kopy-krafter             → voz de marca, hooks, biblioteca de copy
4. content-blueprint        → temario de contenido
        ↓
5. Llenar 02-proyectos\{cliente}\   ← design system, productos, personajes, escenarios
        ↓
6. Producir:
   creative-marketing-engine  → imágenes y anuncios
   ai-video-director          → video
   sitios-web-med             → sitio o landing
   article-developer          → artículos
```

Los pasos 1 a 4 se hacen **una vez por cliente**. Del 5 en adelante se repite
cada campaña.

**Cada módulo deja un `.md` en disco** que el siguiente lee. Por eso puedes cerrar
la sesión y retomar días después.

---

## Cliente nuevo — 4 pasos

**1.** Copiar la plantilla:

```
agencia\plantillas\_ESTRUCTURA\   →   02-proyectos\{nombre-cliente}\
```

**2.** Llenar `catalogo-creativos.md` (el índice) y estos cuatro:

```
design-system\design-system.md   colores, tipografías, tono, claims
productos\catalogo.md            + ficha y descriptor por producto
personajes\catalogo.md           + ficha por personaje, con permisos
escenarios\catalogo.md           contextos autorizados
```

**3.** Meter los `.md` de estrategia (market intelligence, oferta, kopy) en
`estrategia\`.

**4.** Meter las fotos reales en `productos\fotos\` y `personajes\fotos\`.

Ya con eso, cualquier módulo puede trabajar para ese cliente sin preguntarte nada.

---

## Los tres métodos que gobiernan todo

### 1. Image Prompting — el creativo es el prompt

**Tu método.** Codificar dentro de la pieza las señales que le dicen al algoritmo
de Meta o TikTok a quién mostrarla.

- **La persona que aparece ES el targeting.** Avatar real, no modelos 15 años
  más jóvenes. Ese es el error que más caro sale
- **Mínimo por pieza:** 3 señales visuales + 2 de copy + 1 de exclusión
- **Un creativo, un segmento**
- **Coherencia:** creativo, anuncio y landing con las mismas señales
- **La prueba:** *"si yo fuera Meta y solo viera esto, ¿a quién se lo mostraría?"*
  Respuesta vaga = reprueba

Se llama **image prompting** en imagen, **video prompting** en video y
**segmentación semántica** en landing. Es el mismo método.

Canónico: `motor\skills\_shared\image-prompting.md`

### 2. Anti-slop — que no parezca hecho por IA

No es solo estética: un creativo genérico es un prompt vacío para el algoritmo,
y eso **cuesta presupuesto del cliente**.

Lo más violado:

- **Prohibido el guion largo (—).** Verificable con búsqueda
- **Máximo 1 eyebrow por cada 3 secciones**
- **Nada de UI falsa hecha con divs**
- **Nada de datos genéricos** ("Juan Pérez", "Acme", 99.99%)
- **Revisar manos, dientes, ojos y texto en escena** antes de aprobar

### 3. Anti-convergencia — que no salgan todos iguales

Antes de construir, comparar con el trabajo anterior en seis ejes: paleta,
tipografía, estructura, efecto de firma, botones, esquinas.

**Web: diferir en ≥4 de 6. Creativos: ≥3 de 6.**

Sin esto, todo tu portafolio acaba pareciendo una sola plantilla.

---

## Los gates — no se entrega sin correrlos

Dos módulos traen compuerta obligatoria antes de entregar:

| Módulo | Gate |
|---|---|
| `sitios-web-med` | 16 checks: placeholders, guion largo, paleta, eyebrows, activos, head, viewport, movimiento, CTA, revelados, anti-convergencia, datos, UI falsa, layouts, móvil, accesibilidad |
| `creative-marketing-engine` | 16 checks: señales, prueba del algoritmo, densidad, avatar, escala, tells, guion largo, datos, claims, políticas, formatos, legibilidad, color, anti-convergencia, honestidad, registro |

Se entrega **la tabla llena**, con los hits encontrados y resueltos.

---

## Agregar un módulo nuevo

Tres pasos:

1. Crear `motor\skills\mi-modulo\SKILL.md`
2. Escribir el frontmatter — el `description` decide si se activa, es lo más
   importante del archivo
3. Anotar el renglón en `MANIFIESTO.md`

**Regla de tamaño:** si el `SKILL.md` pasa de ~150 líneas, partir el contenido a
`references\`. El SKILL.md queda como índice.

Detalle y guía para migrar GPTs: `motor\COMO-AGREGAR-MODULO.md`

---

## Reglas que no se rompen

1. **Se edita en `motor\skills\`.** `_biblioteca` es respaldo, no se toca
2. **Ningún módulo inventa datos del cliente.** Si no está en la ficha, pregunta
3. **Cero credenciales dentro de un skill.** Variables de entorno
4. **Un clip generado = 15 segundos máximo**
5. **Header y footer son globales** en WordPress. Una plantilla por página
6. **Al vault va lo que se lee, fuera lo que se ejecuta.** Nada de `node_modules`
   dentro del Segundo Cerebro

---

## Pendientes

- [ ] **Revocar la Application Password de WordPress** (acción tuya, es de hoy)
- [ ] Borrar a mano las carpetas vacías: `motor\00-cliente-setup` a
      `motor\05-publicacion`, y `_plantillas\` en la raíz. Son residuo de la
      primera versión, ya reemplazadas por `skills\` y `clientes\_ESTRUCTURA\`
- [ ] Llenar Tecmundo con la estructura nueva
- [ ] Probar generación real end-to-end con Higgsfield
- [ ] Generalizar los 3 módulos aún cableados a PHIX
- [ ] Traer los GPTs de ChatGPT que valgan la pena
- [ ] Revisar `github.com/higgsfield-ai/skills` cada tanto — se mueve rápido

---

## Si algo se rompe

| Síntoma | Qué hacer |
|---|---|
| No se activa el módulo que querías | Pídelo por nombre. Si sigue fallando, revisa su `description` |
| Se activan dos módulos parecidos | Revisa el manifiesto: puede haber duplicado |
| Editaste y no cambia nada en Cowork | Los instalados son enrutadores. Reinstala con `save_skill` |
| Perdiste una versión | Está en `motor\_biblioteca\`, agrupado por origen |
| No sabes qué hace un módulo | `MANIFIESTO.md`, tabla de su capa |
| No recuerdas por qué se decidió algo | `ARQUITECTURA.md` |

---

## Replicar en otra máquina

```powershell
cd "...\AGENC-IA\motor"
.\sync.ps1 -Empaquetar
```

Genera `agenc-ia-skills-{fecha}.zip`. En la máquina nueva se descomprime en:

- Codex → `.agents\skills\`
- Claude Code → `.claude\skills\`
- Antigravity → `.antigravity\skills\`
- Claude Desktop → se instalan desde la app, no lee carpetas

Y para todo el sistema, copiar la carpeta `AGENC-IA\` completa. Son 3.4 MB.
