# product-copywriter

**Familia**: A · Producto y Marketplace
**Spec**: [`/.claude/agents/product-copywriter.md`](../../.claude/agents/product-copywriter.md)

## Cuándo invocarlo

- Un shop product nuevo necesita copy comercial (Headline, Subheadline, Pain Points, Value Props, Keywords, CTA, Tagline)
- Un shop product existente tiene copy genérico o desalineado con el posicionamiento
- Hay que rehacer el copy de todos los shop products de un mismo core para consistencia
- Hay que mantener coherencia entre múltiples variantes del mismo core pero diferentes industrias

## Cuándo NO invocarlo

- Para generar el contenido seed de un módulo (posts de blog, servicios, FAQs reales) → usar `content-seeder`
- Para textos de interfaz (admin panel, tooltips) → es texto de producto UI, no copy comercial
- Para copy de email transaccional → fuera de scope

## Inputs típicos

```
"Generá copy para shop slug `sports-nutritionist` sobre core `nutritionist`"

"Rehacé el copy de `yoga-instructor` — suena genérico, no conecta con el profesional que busca clientes"

"Alineá el copy de los 11 shop products del core `agency` con el posicionamiento de compania3.0"
```

## Output esperado

JSON con 7 campos canónicos + tagline opcional, listo para Airtable "Shop Products Copy" o `shop-copy.json`:

- `slug`
- `headline` (5-8 palabras, promesa clara)
- `subheadline` (15-25 palabras, lista módulos en lenguaje de industria)
- `target_persona` (1-2 líneas)
- `pain_points` (array 3-5)
- `value_props` (array 3-5)
- `cta_primary` (2-4 palabras)
- `keywords` (8-12 keywords separados por coma)
- `tagline` (opcional, 3-6 palabras)

Más un párrafo justificando las decisiones (qué aliases usó, qué pain points derivó del pitch del alias-matrix).

## Archivos que lee

- `database/seeders/products/{catalog.json, alias-matrix.json, shop-copy.json, core/*.json}`
- `docs/bewpro2.0/lanzamiento-mercado.md`
- `docs/compania3.0/posicionamiento.md`
- `docs/compania2.0/precios-y-speech-de-ventas.md`

## Archivos que escribe (con confirmación)

- `database/seeders/products/shop-copy.json` (agregar entrada)
- Nunca escribe a Airtable directamente — el usuario aplica.

## Checklist de validación del output

- [ ] Usa aliases del matrix para la industria correcta (no "tu sitio" genérico)
- [ ] Pain points son específicos de la industria, no universales
- [ ] Value props resuelven los pain points listados (1:1 o N:1)
- [ ] Headline es una promesa, no una descripción
- [ ] Keywords incluyen variantes long-tail (nutricionista deportivo vs nutrición)
- [ ] Tagline (si existe) es memorable y no repite headline

## Flujo típico

1. Usuario: "Copy para `sports-nutritionist`"
2. Agente lee `catalog.json` → core = `nutritionist`
3. Agente lee `core/nutritionist.json` → módulos, schema, demo
4. Agente lee `alias-matrix.json` → aliases `health-medical` para cada módulo
5. Agente lee `docs/compania3.0/posicionamiento.md` → tono
6. Agente revisa `shop-copy.json` → evita repetir angle de `nutritionist` base
7. Agente devuelve JSON + justificación

## Relacionado

- `product-packager` invoca a este agente cuando crea una variante nueva
- `pricing-strategist` no depende de este agente (corre en paralelo)