iron-edge 1.0.0

package/squads/squad-copy/tasks/conduct-full-copy-review.md

@@ -0,0 +1,171 @@
+---
+task: conduct-full-copy-review
+responsavel: "@copy-editor"
+responsavel_type: Agent
+atomic_layer: Task
+elicit: false
+
+Entrada:
+  - campo: context
+    tipo: object
+    origem: "workflow ou manual"
+    obrigatorio: true
+
+Saida:
+  - campo: resultado
+    tipo: document
+    destino: "stakeholders"
+
+Checklist:
+  - "[ ] Validar inputs e pre-condicoes"
+  - "[ ] Executar steps conforme documentado"
+  - "[ ] Verificar criterios de qualidade"
+  - "[ ] Gerar output no formato especificado"
+---
+
+# Task: Conduct Full Copy Review (5-Pass)
+
+## Metadata
+- **Squad:** squad-copy
+- **Agent:** copy-editor (Chisel)
+- **Complexity:** COMPLEX
+- **Depends on:** copy completa de qualquer writer
+- **Feeds:** writer original, copy-strategist (Quill)
+
+## Objetivo
+Conduzir review completo de 5 passadas em qualquer peca de copy — executando todos os 5 passes sequencialmente para entregar copy pronta para publicacao.
+
+## Entrada
+- Copy para review completo
+- Copy brief original
+- Brand voice guidelines
+- Plataforma de publicacao
+
+## Passos
+
+### 1. Pass 1 — Strategic Review
+**Executa:** `edit-copy-strategic-review.md`
+- Alinhamento estrategico (objetivo, audiencia, awareness)
+- Estrutura e sequencia
+- One Big Idea
+- **Gate:** Se ❌ REESCREVER, retornar ao writer
+
+### 2. Pass 2 — Persuasion Review
+**Executa:** `edit-copy-persuasion-review.md`
+- Headline/hook power
+- Body persuasion
+- Proof layers
+- CTA optimization
+- Objection handling
+- **Gate:** Se score < 3.5/5, iterar com writer
+
+### 3. Pass 3 — Voice Compliance
+**Executa:** `edit-copy-voice-compliance.md`
+- Voice attributes present
+- Vocabulario check (always/never)
+- Tom adequado e consistente
+- Formatacao padrao
+- **Gate:** Se off-brand, ajustar e re-check
+
+### 4. Pass 4 — Clarity & Impact
+**Executa:** `edit-copy-clarity-impact.md`
+- Cut fluff (kill darlings)
+- Sharpen language
+- Optimize rhythm
+- Read aloud test
+- **Gate:** Se nao natural, mais polimento
+
+### 5. Pass 5 — Technical Check
+**Executa:** `edit-copy-technical-check.md`
+- Grammar/spelling
+- Links/references
+- Formatting/limits
+- Compliance/legal
+- Cross-platform
+- **Gate:** Zero erros = APPROVED
+
+### 6. Compilar Full Review Report
+```
+FULL COPY REVIEW REPORT
+
+Copy: [Nome da peca]
+Writer: [Agente]
+Editor: Chisel (Copy Editor)
+Date: [Data]
+
+═══════════════════════════════════════════
+
+PASS 1 — STRATEGIC REVIEW
+  Status: ✅/🔄/❌
+  Score: [X/5]
+  Notes: [Resumo]
+
+PASS 2 — PERSUASION REVIEW
+  Status: ✅/🔄/❌
+  Score: [X/5]
+  Notes: [Resumo]
+
+PASS 3 — VOICE COMPLIANCE
+  Status: ✅/🔄/❌
+  Score: [X/5]
+  Notes: [Resumo]
+
+PASS 4 — CLARITY & IMPACT
+  Status: ✅/🔄/❌
+  Score: [X/5]
+  Notes: [Resumo]
+
+PASS 5 — TECHNICAL CHECK
+  Status: ✅/🔄/❌
+  Errors found: [N]
+  Notes: [Resumo]
+
+═══════════════════════════════════════════
+
+OVERALL SCORE: [X/5]
+TOTAL EDITS: [N]
+
+VEREDICTO FINAL:
+  ✅ APPROVED — Ready for publication
+  🔄 REVISE — [Passes that need rework]
+  ❌ REWRITE — [Fundamental issues]
+
+KEY IMPROVEMENTS MADE:
+  1. [Melhoria mais significativa]
+  2. [Segunda]
+  3. [Terceira]
+
+LEARNINGS FOR WRITER:
+  1. [Padrao a melhorar]
+  2. [Forca a manter]
+```
+
+## Cross-Squad Handoff
+```yaml
+handoffs:
+  - to: copy-strategist (Quill)
+    delivers: Copy aprovada ou report de revisao
+    format: Full review report + copy final
+  - to: squad-design
+    delivers: Copy pronta para implementacao
+    format: Copy final aprovada + specs tecnicas
+```
+
+## Saida
+- Full copy review report
+- Copy final editada (se approved)
+- Before/after highlights
+- Learnings para writer
+
+## Validacao
+- [ ] 5 passes executados sequencialmente
+- [ ] Score por pass documentado
+- [ ] Overall score >= 4.0 para aprovacao
+- [ ] Zero erros tecnicos (Pass 5)
+- [ ] Veredicto final claro
+- [ ] Learnings para writer documentados
+- [ ] Copy final salva e versionada
+
+---
+
+*Task operada por: copy-editor (Chisel)*

package/squads/squad-copy/tasks/conduct-voice-audit.md

@@ -0,0 +1,172 @@
+---
+task: conduct-voice-audit
+responsavel: "@brand-voice-writer"
+responsavel_type: Agent
+atomic_layer: Task
+elicit: false
+
+Entrada:
+  - campo: context
+    tipo: object
+    origem: "workflow ou manual"
+    obrigatorio: true
+
+Saida:
+  - campo: resultado
+    tipo: document
+    destino: "stakeholders"
+
+Checklist:
+  - "[ ] Validar inputs e pre-condicoes"
+  - "[ ] Executar steps conforme documentado"
+  - "[ ] Verificar criterios de qualidade"
+  - "[ ] Gerar output no formato especificado"
+---
+
+# Task: Conduct Voice Audit
+
+## Metadata
+- **Squad:** squad-copy
+- **Agent:** brand-voice-writer (Tone)
+- **Complexity:** STANDARD
+- **Depends on:** brand voice guidelines, copy existente
+- **Feeds:** copy-editor (Chisel), copy-strategist (Quill)
+
+## Objetivo
+Conduzir auditoria de voz em toda a copy existente — identificando inconsistencias, gaps e oportunidades de alinhamento para garantir que cada touchpoint soa como a mesma marca.
+
+## Entrada
+- Brand voice guidelines
+- Copy de todos os canais ativos
+- Lista de touchpoints da marca
+- Quem escreve (equipe, freelancers, AI)
+
+## Passos
+
+### 1. Inventariar Todos os Touchpoints
+**Mapa de touchpoints:**
+| Categoria | Touchpoints | Prioridade |
+|-----------|-------------|:----------:|
+| Website | Homepage, product, about, blog, pricing | Alta |
+| Email | Welcome, nurture, promo, transacional | Alta |
+| Social | Instagram, LinkedIn, Twitter, TikTok | Alta |
+| Ads | Google, Meta, LinkedIn, Display | Alta |
+| Product | Onboarding, UI copy, notifications | Media |
+| Sales | Proposals, decks, scripts | Media |
+| Support | Help center, chatbot, templates | Media |
+| Legal | Termos, privacidade, contratos | Baixa |
+| Internal | Cultura, recrutamento, training | Baixa |
+
+### 2. Coletar Amostras
+**Para cada touchpoint, coletar:**
+- 3-5 amostras de copy atual
+- Quem escreveu (se possivel)
+- Quando foi escrito
+- Performance data (se disponível)
+
+### 3. Avaliar com Voice Scorecard
+**Scorecard por amostra (1-5):**
+| Criterio | Peso | 1 (Off) | 3 (Parcial) | 5 (On-brand) |
+|----------|:----:|---------|-------------|--------------|
+| Voice attributes | 30% | Nao reflete nenhum atributo | Reflete 1-2 de 3-5 | Reflete todos |
+| Vocabulario | 20% | Usa never words | Mix de always/never | Usa always words |
+| Tom apropriado | 20% | Tom errado para contexto | Tom ok mas inconsistente | Tom perfeito para contexto |
+| Consistencia | 15% | Parece outra marca | Similar mas variavel | Inconfundivelmente a marca |
+| Expressoes assinatura | 15% | Nenhuma usada | Ocasionalmente | Naturalmente integradas |
+
+**Score = weighted average de todos os criterios**
+- 4.0-5.0: On-brand (manter)
+- 3.0-3.9: Parcial (ajustar)
+- 1.0-2.9: Off-brand (reescrever)
+
+### 4. Identificar Padroes
+**Analise de padroes:**
+
+**Inconsistencias mais comuns:**
+- Canal X soa formal, canal Y soa casual (sem razao)
+- Writers diferentes = voices diferentes
+- Copy antiga ≠ voice atual
+- AI-generated copy sem customizacao de voice
+- Legal/transacional completamente desconectado
+
+**Perguntas diagnosticas:**
+- Qual canal esta mais on-brand? (benchmark)
+- Qual canal esta mais off-brand? (prioridade)
+- Existe padrao por writer/equipe?
+- Copy mais recente e mais on-brand que antiga?
+- Quais touchpoints clientes veem PRIMEIRO?
+
+### 5. Recomendar Acoes
+**Priorizacao por impacto:**
+| Prioridade | Criterio | Acao |
+|:----------:|----------|------|
+| P0 | Alto trafego + off-brand | Reescrever imediatamente |
+| P1 | Alto trafego + parcial | Ajustar nos proximos 30 dias |
+| P2 | Medio trafego + off-brand | Reescrever em 60 dias |
+| P3 | Baixo trafego + parcial | Proxima atualizacao natural |
+| P4 | Baixo trafego + on-brand | Manter |
+
+**Recomendacoes sistemicas:**
+- Training para writers
+- Templates pre-aprovados
+- AI voice customization prompts
+- Review process (voice checkpoint)
+- Atualizacao de guidelines (se necessario)
+
+### 6. Criar Audit Report
+**Estrutura do report:**
+```
+1. EXECUTIVE SUMMARY
+   - Score geral da marca
+   - Top 3 gaps
+   - Top 3 prioridades
+
+2. SCORECARD POR CANAL
+   - Score de cada canal
+   - Exemplos bons e ruins
+
+3. PADROES IDENTIFICADOS
+   - Inconsistencias
+   - Root causes
+
+4. RECOMENDACOES
+   - Quick wins (P0-P1)
+   - Medium-term (P2-P3)
+   - Sistemicas (training, process)
+
+5. APPENDIX
+   - Amostras coletadas
+   - Scores detalhados
+```
+
+## Cross-Squad Handoff
+```yaml
+handoffs:
+  - to: copy-editor (Chisel)
+    delivers: Lista de copy para reescrita prioritaria
+    format: Amostras off-brand + voice guidelines
+  - to: copy-strategist (Quill)
+    delivers: Audit report para planejamento
+    format: Report completo + recomendacoes
+```
+
+## Saida
+- Voice audit report completo
+- Scorecard por canal
+- Lista de reescrita prioritizada (P0-P4)
+- Recomendacoes sistemicas
+- Benchmark de voice score atual
+
+## Validacao
+- [ ] Min 8 touchpoints auditados
+- [ ] 3-5 amostras por touchpoint
+- [ ] Scorecard aplicado a todas as amostras
+- [ ] Padroes de inconsistencia identificados
+- [ ] Recomendacoes priorizadas (P0-P4)
+- [ ] Report executivo criado
+- [ ] Quick wins identificados
+- [ ] Recomendacoes sistemicas incluidas
+
+---
+
+*Task operada por: brand-voice-writer (Tone)*

package/squads/squad-copy/tasks/coordinate-multi-channel-copy.md

@@ -0,0 +1,100 @@
+---
+task: coordinate-multi-channel-copy
+responsavel: "@copy-strategist"
+responsavel_type: Agent
+atomic_layer: Task
+elicit: false
+
+Entrada:
+  - campo: context
+    tipo: object
+    origem: "workflow ou manual"
+    obrigatorio: true
+
+Saida:
+  - campo: resultado
+    tipo: document
+    destino: "stakeholders"
+
+Checklist:
+  - "[ ] Validar inputs e pre-condicoes"
+  - "[ ] Executar steps conforme documentado"
+  - "[ ] Verificar criterios de qualidade"
+  - "[ ] Gerar output no formato especificado"
+---
+
+# Task: Coordinate Multi-Channel Copy
+
+## Metadata
+- **Squad:** squad-copy
+- **Agent:** copy-strategist (Quill)
+- **Complexity:** STANDARD
+- **Depends on:** approved copy brief, core message
+- **Feeds:** all writers, copy-editor, brand-system
+
+## Objetivo
+Adapt a single core message into channel-specific copy versions while maintaining message consistency. Ensure format, tone, and length are calibrated per channel.
+
+## Entrada
+- Core message / copy brief
+- Target channels list
+- Brand voice guidelines
+- Channel-specific constraints (character limits, format rules)
+
+## Passos
+
+### 1. Channel Adaptation Rules
+
+| Channel | Length | Tone | Format Notes |
+|---------|--------|------|-------------|
+| Email | 50-125 words body | Personal, conversational | Subject line <60 chars, preview text <90 chars, single CTA |
+| Social — Instagram | 125-150 words caption | Casual, visual-first | First line is hook, line breaks for readability, 3-5 hashtags |
+| Social — LinkedIn | 150-300 words | Professional, authoritative | Hook in first 2 lines (before "see more"), no hashtag spam |
+| Social — Twitter/X | <280 chars | Punchy, direct | One idea per tweet, thread for complex topics |
+| Web — Landing page | Scannable, H2/H3 structure | Benefit-driven, action-oriented | Above fold: headline + subhead + CTA, progressive disclosure below |
+| Web — Blog | 800-2000 words | Educational, authoritative | SEO-optimized, internal links, structured with H2/H3 |
+| Ads — Google Search | 30+90 chars (headline+desc) | Direct, benefit-focused | Include keyword in headline, CTA in description |
+| Ads — Meta (Facebook/IG) | Primary text <125 chars visible | Conversational, scroll-stopping | Hook in first line, social proof if possible |
+| Ads — Display | Minimal text | Bold, single message | 1 headline + 1 CTA, no paragraphs |
+
+### 2. Tone Calibration
+
+| Context | Tone Setting | Examples |
+|---------|-------------|----------|
+| Formal | Email proposals, whitepapers, investor comms | "We are pleased to present...", data-driven |
+| Conversational | Social media, chat, casual email | "Here's the thing...", contractions OK |
+| Authoritative | Blog, case studies, thought leadership | "Research shows...", expert positioning |
+| Urgent | Promotions, limited offers, re-engagement | "Last chance...", action-oriented |
+
+### 3. Consistency Tracking
+- **Core message unchanged:** The central idea/benefit must be identical across all channels
+- **Only format adapts:** Length, tone register, and structure change — not the message
+- **Proof points consistent:** Same data/testimonials referenced (adapted for format)
+- **CTA aligned:** All channels drive toward the same desired action
+- **Cross-check matrix:** Compare each version against the core brief to verify alignment
+
+### 4. Version Control
+- **Naming convention:** `{campaign}_{channel}_{version}_{date}`
+  - Example: `spring-launch_email_v2_2026-03-15`
+  - Example: `spring-launch_ig-caption_v1_2026-03-15`
+- **Version log:** Track all versions with author, date, status (draft/review/approved/live)
+- **Change tracking:** Document what changed between versions and why
+- **Archive policy:** Keep all versions; mark superseded versions as archived
+
+## Saida
+- Channel-specific copy versions (one per target channel)
+- Consistency cross-check matrix
+- Version log with naming convention applied
+- Tone calibration notes per channel
+
+## Validacao
+- [ ] All target channels have a dedicated copy version
+- [ ] Core message consistent across all versions
+- [ ] Channel-specific length and format constraints met
+- [ ] Tone calibrated per channel context
+- [ ] Version control naming convention applied
+- [ ] Cross-check matrix completed showing consistency
+
+---
+
+*Task operada por: copy-strategist (Quill)*

package/squads/squad-copy/tasks/craft-cta-variations.md

@@ -0,0 +1,160 @@
+---
+task: craft-cta-variations
+responsavel: "@conversion-writer"
+responsavel_type: Agent
+atomic_layer: Task
+elicit: false
+
+Entrada:
+  - campo: context
+    tipo: object
+    origem: "workflow ou manual"
+    obrigatorio: true
+
+Saida:
+  - campo: resultado
+    tipo: document
+    destino: "stakeholders"
+
+Checklist:
+  - "[ ] Validar inputs e pre-condicoes"
+  - "[ ] Executar steps conforme documentado"
+  - "[ ] Verificar criterios de qualidade"
+  - "[ ] Gerar output no formato especificado"
+---
+
+# Task: Craft CTA Variations
+
+## Metadata
+- **Squad:** squad-copy
+- **Agent:** conversion-writer (Spark)
+- **Complexity:** STANDARD
+- **Depends on:** copy brief, oferta, awareness level
+- **Feeds:** todos os writers, squad-design
+
+## Objetivo
+Criar CTAs que convertem — botoes, links e micro-copy que transformam interesse em acao. O CTA e o momento da verdade: toda a copy existe para levar ate ele.
+
+## Entrada
+- Acao desejada (compra, signup, download, contato)
+- Awareness level da audiencia
+- Contexto (LP, email, ad, in-app)
+- Nivel de commitment pedido (alto, medio, baixo)
+
+## Passos
+
+### 1. Framework de CTA por Commitment Level
+| Commitment | Exemplo | Friction | Copy Approach |
+|-----------|---------|----------|---------------|
+| Micro | "Ver demo", "Ler mais" | Baixo | Curiosidade, zero risco |
+| Baixo | "Trial gratis", "Download PDF" | Baixo-Medio | Beneficio gratis |
+| Medio | "Agendar call", "Comecar trial" | Medio | Valor + facilidade |
+| Alto | "Comprar agora", "Assinar plano" | Alto | Valor total + garantia |
+
+### 2. Formulas de CTA Comprovadas
+**Formula 1: Acao + Beneficio**
+- "Comecar a [resultado]" → "Comecar a Vender Mais"
+- "Receber [beneficio]" → "Receber Meu Plano Personalizado"
+
+**Formula 2: Primeira Pessoa**
+- "Eu quero [beneficio]" → "Eu Quero Mais Clientes"
+- "Sim, [beneficio]!" → "Sim, Quero Meu Desconto!"
+
+**Formula 3: Acao + Eliminacao de Objecao**
+- "[Acao] — sem [objecao]" → "Comecar — Sem Cartao de Credito"
+- "[Acao] gratis" → "Testar Gratis por 14 Dias"
+
+**Formula 4: Urgencia + Acao**
+- "[Acao] antes de [deadline]" → "Garantir Antes de Acabar"
+- "Ultimas vagas — [acao]" → "Ultimas Vagas — Inscrever"
+
+**Formula 5: Social + Acao**
+- "Juntar-se a [N]+ [audiencia]" → "Juntar-se a 10,000+ Marketers"
+- "[Acao] como [referencia]" → "Crescer Como as Maiores Marcas"
+
+### 3. Micro-Copy ao Redor do CTA
+**Acima do CTA (pre-CTA):**
+- Recapitulacao de valor: "Acesso completo ao [produto] + [bonus]"
+- Social proof: "Join 10,000+ professionals"
+- Urgencia: "Oferta valida ate [data]"
+
+**Abaixo do CTA (friction reducers):**
+- "Sem cartao de credito necessario"
+- "Cancele a qualquer momento"
+- "Setup em menos de 2 minutos"
+- "Garantia de [X] dias"
+- "Seus dados estao seguros 🔒"
+
+**Ao lado do CTA (alternativa):**
+- "Ainda tem duvidas? Fale com a gente"
+- "Prefere ver uma demo primeiro?"
+- "Compare nossos planos →"
+
+### 4. CTA por Canal
+| Canal | Formato | Exemplos |
+|-------|---------|----------|
+| Landing Page | Botao grande + micro-copy | "Comecar Meu Trial Gratis" + "Setup em 2 min" |
+| Email | Botao + link texto | "Garantir Minha Vaga" + "Ou clique aqui se preferir" |
+| Social Ad | Botao preset + copy | "Learn More", "Sign Up", "Shop Now" |
+| Blog | Inline CTA ou banner | "Quer [resultado]? [Acao]" |
+| Pop-up | CTA + anti-CTA | "Sim, quero!" / "Nao, prefiro continuar sem [beneficio]" |
+| In-app | Contextual micro-CTA | "Upgrade para desbloquear [feature]" |
+
+### 5. Anti-CTA (Confirmshaming Done Right)
+**Anti-CTA etico:**
+- Reformula a rejeicao como perda de oportunidade
+- NAO humilha ou manipula
+- Exemplos bons: "Nao, obrigado, prefiro o plano gratuito"
+- Exemplos ruins: "Nao, eu odeio economizar dinheiro" ← NUNCA
+
+### 6. CTA Testing Matrix
+**Para cada ponto de conversao, gerar:**
+- 3-5 variantes de copy
+- 2 variantes de cor/design (briefar designer)
+- 2 variantes de posicao na pagina
+- 1 variante de micro-copy
+
+**Documentar:**
+```
+CTA-001:
+  Location: Hero section LP
+  Copy: "Comecar Meu Trial Gratis"
+  Micro-copy: "Setup em 2 minutos. Sem cartao."
+  Variants:
+    - A: "Comecar Meu Trial Gratis"
+    - B: "Quero Testar Agora"
+    - C: "Sim, Quero Comecar!"
+  Winner: TBD
+  Lift: TBD
+```
+
+## Cross-Squad Handoff
+```yaml
+handoffs:
+  - to: squad-design
+    delivers: CTAs com micro-copy para implementacao
+    format: CTA por location + variantes A/B
+  - to: squad-growth
+    delivers: CTAs para tracking de conversao
+    format: CTA IDs + variantes + metricas-alvo
+```
+
+## Saida
+- CTA variations por ponto de conversao (3-5 cada)
+- Micro-copy library (pre-CTA + friction reducers)
+- CTA testing matrix
+- Anti-CTA copy (quando aplicavel)
+
+## Validacao
+- [ ] CTAs especificos (nao "Clique Aqui")
+- [ ] Beneficio claro no CTA text
+- [ ] Friction reducers presentes
+- [ ] Min 3 variantes por ponto de conversao
+- [ ] Micro-copy acima e abaixo do CTA
+- [ ] Consistencia de tom com brand voice
+- [ ] Anti-CTA etico (sem confirmshaming abusivo)
+- [ ] Testing matrix documentada
+
+---
+
+*Task operada por: conversion-writer (Spark)*