# Manifiesto de módulos — AGENC-IA

> **Registro único de la biblioteca.** Si una skill no está aquí, no existe para el sistema.
>
> Editar siempre en `skills/`. `_biblioteca/` es respaldo histórico y **no se edita**.
>
> Última actualización: 2026-07-30 · **42 módulos**

---

## Cómo leer este archivo

| Columna | Significado |
|---|---|
| **Capa** | Dónde entra en el flujo del motor (00–05) o `web` / `util` / `cliente` |
| **Estado** | 🟢 canónica · 🟡 funciona pero es deuda técnica · 🔴 pendiente de generalizar |
| **Formato** | `mod` = SKILL.md delgado + references/ · `mono` = monolítica |

---

## Capa 00 — Setup de cliente

| Módulo | Estado | Formato | Notas |
|---|---|---|---|
| `avatar-intelligence` | 🟡 | mono | Construye el avatar del cliente |

## Capa 01 — Estrategia

| Módulo | Estado | Formato | Notas |
|---|---|---|---|
| `market-intelligence` | 🟢 | mono | Módulo 1 AGENC-IA. Gana la versión de Skills IA (349 líneas) |
| `oferta-irresistible` | 🟢 | mono | Módulo 2. Con "PASO FINAL .md" que encadena el pipeline |
| `content-blueprint` | 🟢 | mono | Temario de contenido |
| `buscador-de-clientes` | 🟢 | mono | Prospección para motion design |
| `buscador-clientes-sitios-web` | 🟢 | mono | Prospección para web |

## Capa 02 — Guion y copy

| Módulo | Estado | Formato | Notas |
|---|---|---|---|
| `kopy-krafter` | 🟢 | mono | Módulo 3. Base de comunicación de marca |
| `landing-krafter` | 🟢 | mod | Módulo 6. Tiene `references/` |
| `article-krafter` | 🟡 | mono | Artículos SEO |
| `article-developer` | 🟢 | **mod** | Artículos + publicación WordPress + FAQ AEO + Schema. Con `references/entidades-y-eeat.md` |
| `serie-infinita` | 🟡 | mono | Series de contenido |

## Capa 03 — Imagen

| Módulo | Estado | Formato | Notas |
|---|---|---|---|
| `creative-marketing-engine` | 🟢 | **mod** | **Canónica de creativos y anuncios FB/IG.** Con **image prompting** (metodología Med Toledo) + capa anti-slop + gate de 16 checks. 5 references |
| `higgsfield-generate` | 🟢 | **mod** | **v0.12.0 oficial.** 323 líneas + 13 references. Plantilla de calidad del sistema. Incluye `rutas-cli-vs-mcp.md` propio |
| `higgsfield-soul-id` | 🟢 | mod | v0.12.0. Consistencia de personaje + guía de fotos |
| `higgsfield-product-photoshoot` | 🟢 | mono | v0.12.0. 10 modos de fotografía de producto |
| `higgsfield-marketplace-cards` | 🟢 | mono | v0.12.0. Cards de marketplace |
| `visual-reference-director` | 🔴 | mod | **El director creativo.** Cableada a PHIX — generalizar |
| `product-photo-remix` | 🔴 | mod | Cableada a PHIX — generalizar |
| `product-shot-krafter` | 🟡 | mono | Versión previa sin MCP |
| `thumbnail-prompt-maker` | 🟡 | mono | Miniaturas YouTube/TikTok |

## Capa 04 — Video

| Módulo | Estado | Formato | Notas |
|---|---|---|---|
| `ai-video-director` | 🟢 | mod | Prompts cinematográficos multiplataforma |
| `seedance-shotlist-director` | 🟢 | mono | Shotlist para Seedance |
| `seedance-clean` | 🟢 | mono | Limpieza de prompts Seedance |
| `video-prompt-krafter` | 🟡 | mono | Prompts de video |
| `cinemotion-general` | 🟡 | mono | Motion genérico |
| `cinemotion-product` | 🟡 | mono | Motion de producto |
| `cinemotion-real-estate` | 🟡 | mono | Motion inmobiliario |
| `fpv-video-kreator` | 🟡 | mono | FPV |
| `video-ranking` | 🟡 | mono | Ranking de videos |

## Capa 05 — Publicación

| Módulo | Estado | Formato | Notas |
|---|---|---|---|
| `social-planner-publisher` | 🔴 | mono | Cableada a PHIX — generalizar. **Maneja tokens correctamente** (variables de entorno) |

> `seo-aeo-publisher` fue **archivada** el 2026-07-30 → `_archivadas/`.
> La reemplazan `content-blueprint` (temario) + `article-developer` (artículo,
> FAQ AEO, Schema y publicación). Sus dos piezas únicas — mapeo de entidades
> semánticas y citaciones E-E-A-T — se rescataron a
> `article-developer/references/entidades-y-eeat.md`.

## Web (fuera del motor de contenido)

| Módulo | Estado | Formato | Notas |
|---|---|---|---|
| `sitios-web-med` | 🟢 | **mod** | **Canónica de web.** Fusión de `sitios-web-html-med` (tu flujo y stacks) + la capa anti-slop de `design-taste-frontend`. 97 líneas + 7 references |
| `sitios-web-html-med` | ⬜ | mono | Superada por `sitios-web-med`. Conservada como referencia del flujo original |
| `higgsfield-websites` | 🟢 | **mod** | v0.12.0. **27 references.** Stack propio de Higgsfield (React 19 + Cloudflare), pero sus references de SEO/GEO y craft de diseño son agnósticas y valiosas |
| `webkreator-medtoledo` | 🟡 | mod | WordPress/Oxygen |
| `webkreator-design-system` | 🟡 | mono | Design system para web |

> **Minas de oro dentro de `higgsfield-websites/references/`** — sirven aunque no
> uses su plataforma:
>
> - `design-taste-frontend.md` — el playbook anti-"AI slop". Justo la capa de craft
>   que faltaba de `pro-ads-studio`
> - `wow-maker.md` + `wow-catalog.md` — toolkit de qué hace que un sitio impacte
> - `seo.md` — meta tags, Schema, técnico, GEO para motores de IA, entidades
> - `design-recipe.md`, `app-layouts.md`, `reference-boards.md`, `review-rubric.md`
> - `image-to-code.md` — captura → código
> - `scroll-scrub*.md` (4 archivos) — animación por scroll

## Otros de Higgsfield

| Módulo | Estado | Formato | Notas |
|---|---|---|---|
| `higgsfield-video-explainer` | 🟢 | mod | v0.12.0. Videos explicativos, 281 líneas |
| `higgsfield-game-generation` | 🟢 | mod | v0.12.0. 14 references. Juegos 2D/3D, multiplayer, Meshy |

## Utilidades

| Módulo | Estado | Formato | Notas |
|---|---|---|---|
| `master-prompt-builder` | 🟢 | mono | Perfil permanente del usuario |
| `project-setup` | 🟢 | mono | Contexto de proyecto en .md |
| `ebook-designer` | 🟢 | mono | Documentos → eBook con diseño |

## Cliente-específicas

> No genéricas. Viven aquí pero no se sincronizan a todas las plataformas.

| Módulo | Cliente |
|---|---|
| `cliente-tecmundo-articulos` | Tecmundo |
| `cliente-tecmundo-banners` | Tecmundo |
| `cliente-nodo-flyers` | Nodo Inmobiliario |
| `cliente-evangelismo-predicaciones` | Evangelismo Digital |

## Compartidos — `_shared/`

| Archivo | Usado por |
|---|---|
| `hook-library-pro.md` | `kopy-krafter`, `landing-krafter`, `article-krafter` |
| **`image-prompting.md`** | `creative-marketing-engine`, `ai-video-director`, `landing-krafter` |
| `higgsfield-COOKBOOK.md` | referencia de recetas de Higgsfield |

### Image Prompting — método propio, un solo canónico

**Metodología Med Toledo.** Codificar dentro de la pieza las señales que le dicen
al algoritmo de Meta o TikTok a quién mostrarla. El creativo es un prompt
dirigido a la IA de la plataforma publicitaria.

| Skill | Formato | Nombre que usa |
|---|---|---|
| `creative-marketing-engine` | imagen, banners, anuncios | Image prompting |
| `ai-video-director` | video, reels | Video prompting |
| `landing-krafter` | landing pages | Segmentación semántica |

**Son el mismo método.** La definición vive sólo en `_shared/image-prompting.md`;
los tres skills apuntan ahí. Si el método se refina, se toca un archivo.

> **⚠️ Dos colisiones de nombre, documentadas a propósito:**
>
> 1. **Con la industria** — "image/video prompting" suele significar *escribir
>    prompts para generar* imágenes o video. Aquí es **targeting**, no generación.
> 2. **Interna** — el módulo `video-prompt-krafter` genera prompts de
>    **producción** (toma, lente, cámara). Nombre parecido, función opuesta.
>
> La desambiguación está escrita en los tres skills y en el canónico. Se decidió
> conservar el término por ser propio del autor.

---

## Origen oficial de los módulos Higgsfield

**Repo:** `github.com/higgsfield-ai/skills` — público, MIT, **v0.12.0**

```bash
# actualizar
cd /tmp && git clone --depth 1 https://github.com/higgsfield-ai/skills.git
# o instalar directo en un agente
npx skills add higgsfield-ai/skills
```

> **Hallazgo del 2026-07-30:** las copias que venían de PHIX eran **v0.3.0** —
> nueve versiones atrás. Actualizadas a v0.12.0. La v0.3 quedó respaldada en
> `_biblioteca/12-higgsfield-v0.3-anterior/`.
>
> **Revisar este repo cada tanto.** Se mueve rápido: entre v0.3 y v0.12
> aparecieron tres skills nuevas.

### Sobre `pro-ads-studio` (el del video)

**No existe.** Higgsfield publicó solo el `SKILL.md` de 38 líneas como adjunto del
blog; sus 8 `references/` nunca se publicaron y **no están en el repo oficial**.
Es una pieza de marketing, no un skill funcional.

Lo que sí quedó de ese hilo: el **playbook de negocio** del artículo (fórmula de
oferta, correo frío, back-office, sitio, prospección) — guardado aparte.

---

## Reemplazos y decisiones

| Se quedó | Descartó a | Por qué |
|---|---|---|
| `market-intelligence` (Skills IA) | versión agencia-plugin | 349 vs 249 líneas |
| `kopy-krafter` (Skills IA) | versión agencia-plugin | agrega el "PASO FINAL .md" que encadena el pipeline |
| `oferta-irresistible` (Skills IA) | versión agencia-plugin | mismo paso final |
| `webkreator-medtoledo` (Skills IA) | versión codex | 425 vs 119 (la de codex era stub) |
| `sitios-web-html-med` | `web-design-med` | versión nueva, más completa y con stack claro |
| `creative-marketing-engine` | `motor-de-creativos` | versión nueva y pulida |

`landing-krafter` y `thumbnail-prompt-maker` eran idénticos en ambos orígenes — sin conflicto.

---

## Regla de seguridad

> **Ningún módulo lleva credenciales escritas.** Usuario, contraseña, token o API key
> van en variables de entorno. Si no están definidas, el módulo las pide al usuario.

Auditoría del 2026-07-30 sobre los 42 módulos: **una sola exposición encontrada**,
en `seo-aeo-publisher` (contraseña de aplicación de WordPress en texto plano).
Retirada de las 3 copias. **Pendiente que Med la revoque en WordPress.**

`social-planner-publisher` es el buen ejemplo: dice explícitamente *"never store
tokens in the skill or repo"* y usa `GHL_TOKEN` / `GHL_LOCATION_ID`.

**Antes de sincronizar a otra plataforma, correr esta revisión.**

---

## Pendientes de la biblioteca

- [ ] **Revocar la Application Password de WordPress** (acción de Med, no del sistema)
- [ ] Generalizar los 3 módulos 🔴 cableados a PHIX
- [ ] Migrar los 🟡 monolíticos a formato `mod` cuando se toquen
- [ ] Traer las 29 skills de Claude Desktop
- [ ] Traer los GPTs de ChatGPT que valgan la pena (44 pendientes de revisar)
- [ ] Recuperar las 4 sueltas de `.opencode/` (son `.md` sin carpeta)
- [ ] `higgsfield-pro-ads-studio`: solo tenemos el índice, faltan sus 8 `references/`
- [ ] Script de sincronización a Claude, Codex y Antigravity
