claude-plugins/crm-ops/skills/proposal-deck/SKILL.md

---
name: proposal-deck
description: Geracao de apresentacoes PPTX de propostas comerciais profissionais com branding Descomplicar. Integra dados do CRM, tabela de precos e template curado de 16 layouts.
---

# Skill /proposal-deck - Apresentacoes de Propostas Comerciais

Gera apresentacoes PPTX profissionais para propostas comerciais da Descomplicar, usando um template curado com 16 layouts e branding oficial.

## Triggers

- `/proposal-deck`
- "proposta", "apresentacao cliente", "deck proposta", "proposta comercial", "apresentacao proposta"

## Quando Usar

- Preparar apresentacao visual de proposta para reuniao com cliente
- Criar deck profissional para acompanhar orcamento/estimate
- Gerar proposta completa com branding para envio por email
- Complementar `/orcamento` com material visual

## Quando NAO Usar

- Para criar orcamento sem apresentacao (usar `/orcamento`)
- Para analise estrategica de lead (usar `/lead-approach`)
- Para operacoes CRM genericas (usar `/crm-ops`)
- Para apresentacoes sem contexto comercial (usar pptx-generator directamente)

---

## Template

**Localizacao:** `/media/ealmeida/Dados/Hub/90-Templates/Comercial/descomplicar-proposal-template.pptx`

### Layouts Disponiveis (16)

| # | Nome | Funcao | Quando usar |
|---|------|--------|-------------|
| 1 | capa | Titulo da proposta + subtitulo + ano | Sempre (obrigatorio) |
| 2 | divisor-seccao | Fundo escuro com titulo centrado | Entre seccoes principais |
| 3 | sobre-nos | Card texto + imagem lateral | Sempre (quem somos) |
| 4 | objectivos | Fundo escuro + objectivos + logo cliente | Sempre (o que vamos resolver) |
| 5 | processo-3-passos | 3 colunas douradas com texto | Explicar metodologia |
| 6 | fases-3-blocos | 3 blocos numerados verticais | Fases do projecto (3 items) |
| 7 | grid-4-cards | Grid 4 cards com icones | Valores, diferenciais, pilares (4 items) |
| 8 | beneficios-6 | 6 blocos com icones e setas | Beneficios (6 items) |
| 9 | pilares-engrenagens | 4 pilares em engrenagens | Solucao completa (4 pilares) |
| 10 | detalhe-servico | Titulo + features list + foto + CTA | Detalhe de um servico/pack |
| 11 | deliverables | 4 rows dourados com bullets | Lista deliverables/escopo |
| 12 | timeline-etapas | 5 etapas coloridas horizontais | Cronograma/fases com precos |
| 13 | pack-pricing | Checklist com preco e foto | Pack/avenca mensal |
| 14 | resumo-financeiro | Timeline com precos por fase | Resumo valores total |
| 15 | contacto | Foto gestor + dados | Sempre (obrigatorio) |
| 16 | encerramento | Lobo + branding nocturno | Sempre (obrigatorio) |

### Slides Obrigatorios

Toda proposta inclui **no minimo**: capa (1) + sobre-nos (3) + objectivos (4) + contacto (15) + encerramento (16).

---

## Scripts PPTX

**Base path:** `~/.claude/plugins/marketplaces/descomplicar-plugins/design-media/skills/pptx-generator/scripts/`

| Script | Funcao |
|--------|--------|
| `office/unpack.py` | Descompactar PPTX em XML editavel |
| `office/pack.py` | Recompactar XML em PPTX valido |
| `clean.py` | Limpar XMLs (namespaces, refs orfas) |
| `add_slide.py` | Adicionar slides ao XML |
| `office/validate.py` | Validar estrutura do PPTX |

---

## Protocolo

### Sintaxe

```
/proposal-deck [cliente] [tipo]
```

**Parametros:**
- `cliente` - Nome ou ID do cliente (opcional, sera solicitado se omitido)
- `tipo` - Complexidade da proposta (opcional): `minima`, `standard`, `completa`

### Fase 1: Recolha de Informacao

1. **Identificar cliente no CRM:**
   ```
   mcp__desk-crm-v3__search_customers query="[nome]" fields="company,vat"
   mcp__desk-crm-v3__get_customer customer_id=[id]
   ```

2. **Verificar orcamentos existentes:**
   ```
   mcp__desk-crm-v3__get_estimates status="draft" client_id=[id]
   ```

3. **Consultar tabela de precos** (complementar ao CRM):
   - Ficheiro: `/media/ealmeida/Dados/GDrive/Cloud/Descomplicar/Servicos/tabela-geral.csv`
   - CRM (fonte de verdade): `mcp__desk-crm-v3__price_management action="get_pricing_insights"`

4. **Solicitar dados em falta** (se nao disponiveis no CRM):

| Campo | Obrigatorio | Default |
|-------|:-----------:|---------|
| Nome do cliente | Sim | — |
| Sector/industria | Sim | — |
| Objectivos | Sim | — |
| Servicos a propor | Sim | — |
| Precos | Sim | CRM |
| Prazo estimado | Nao | "a definir" |
| Gestor de conta | Nao | Emanuel Almeida |

### Fase 2: Seleccao de Layouts

Seleccionar layouts com base na complexidade e servicos propostos.

#### Proposta Minima (8 slides)
Para projectos simples, orcamentos rapidos.

| Ordem | Layout | Conteudo |
|:-----:|--------|----------|
| 1 | capa | "Proposta [Servico]" + nome cliente + ano |
| 2 | sobre-nos | Apresentacao Descomplicar |
| 3 | objectivos | 3-5 objectivos do cliente |
| 4 | processo-3-passos | Metodologia de trabalho |
| 5 | deliverables | O que esta incluido |
| 6 | pack-pricing | Preco + o que inclui |
| 7 | contacto | Dados do gestor |
| 8 | encerramento | Branding Descomplicar |

#### Proposta Standard (12 slides)
Para projectos de media complexidade (websites, marketing).

| Ordem | Layout | Conteudo |
|:-----:|--------|----------|
| 1 | capa | Titulo + cliente + ano |
| 2 | sobre-nos | Apresentacao Descomplicar |
| 3 | divisor-seccao | "Desafio" |
| 4 | objectivos | Objectivos do cliente |
| 5 | processo-3-passos | Metodologia |
| 6 | fases-3-blocos | Fases do projecto |
| 7 | divisor-seccao | "Solucao" |
| 8 | beneficios-6 | Beneficios da solucao |
| 9 | deliverables | Escopo detalhado |
| 10 | timeline-etapas | Cronograma com precos |
| 11 | contacto | Dados do gestor |
| 12 | encerramento | Branding Descomplicar |

#### Proposta Completa (16 slides)
Para projectos complexos, concursos, clientes enterprise.

Usa todos os 16 layouts na ordem numerica original.

### Fase 3: Geracao do PPTX

**Directorio de trabalho:** `~/.claude-work/proposal-[cliente-slug]/`

```bash
# 1. Criar directorio e copiar template
mkdir -p ~/.claude-work/proposal-[slug]/
cp "/media/ealmeida/Dados/Hub/90-Templates/Comercial/descomplicar-proposal-template.pptx" \
   ~/.claude-work/proposal-[slug]/template.pptx

# 2. Descompactar template
python3 ~/.claude/plugins/marketplaces/descomplicar-plugins/design-media/skills/pptx-generator/scripts/office/unpack.py \
  ~/.claude-work/proposal-[slug]/template.pptx \
  ~/.claude-work/proposal-[slug]/unpacked/

# 3. Editar slides XML (ver seccao "Edicao de Conteudo XML")

# 4. Remover slides nao necessarios de presentation.xml
#    (alterar rIdX refs e apagar ficheiros slideN.xml correspondentes)

# 5. Limpar XMLs
python3 ~/.claude/plugins/marketplaces/descomplicar-plugins/design-media/skills/pptx-generator/scripts/clean.py \
  ~/.claude-work/proposal-[slug]/unpacked/

# 6. Recompactar
python3 ~/.claude/plugins/marketplaces/descomplicar-plugins/design-media/skills/pptx-generator/scripts/office/pack.py \
  ~/.claude-work/proposal-[slug]/unpacked/ \
  ~/.claude-work/proposal-[slug]/proposta-[slug].pptx \
  --original ~/.claude-work/proposal-[slug]/template.pptx
```

### Edicao de Conteudo XML

Cada slide e um ficheiro `ppt/slides/slideN.xml`. Localizar placeholders pelo texto visivel e substituir:

| Placeholder | Substituir por | Exemplo |
|-------------|----------------|---------|
| `[TITULO_PROPOSTA]` | Nome do servico proposto | "Website Corporativo" |
| `[SUBTITULO]` | Nome do cliente | "Para Empresa XYZ" |
| `[ANO]` | Ano corrente | "2026" |
| `[OBJECTIVO_N]` | Objectivo N do cliente | "Aumentar presenca online" |
| `[FASE_N_TITULO]` | Titulo da fase N | "Fase 1: Descoberta" |
| `[FASE_N_DESC]` | Descricao da fase N | "Analise de requisitos..." |
| `[DELIVERABLE_N]` | Item do escopo | "Website responsivo" |
| `[PRECO]` | Valor formatado | "1.200 EUR" |
| `[PRECO_TOTAL]` | Valor total | "2.500 EUR + IVA" |
| `[TIMELINE_N]` | Etapa do cronograma | "Semana 1-2" |
| `[GESTOR_NOME]` | Nome do gestor | "Emanuel Almeida" |
| `[GESTOR_EMAIL]` | Email do gestor | "emanuel@descomplicar.pt" |
| `[GESTOR_TEL]` | Telefone | "911 510 005" |

**Tecnica XML:** Localizar `<a:t>` tags dentro de `<a:r>` runs. Substituir texto preservando formatacao:

```python
# Exemplo: substituir texto num slide
import re

def replace_placeholder(xml_content, placeholder, value):
    """Substituir placeholder preservando formatacao XML."""
    # Placeholders podem estar fragmentados em multiplos <a:t> tags
    # Usar regex para localizar e substituir
    return xml_content.replace(placeholder, value)
```

**Regra critica:** Nunca alterar atributos de formatacao (`<a:rPr>`, `<a:pPr>`). Apenas substituir conteudo textual dentro de `<a:t>`.

### Fase 4: Entrega

1. **Guardar PPTX final:**
   ```
   Hub/03-Propostas/[cliente]/proposta-[servico]-[data].pptx
   ```

2. **Upload para Google Drive** (opcional):
   ```
   mcp__google-workspace__drive_upload_file
     file_path="~/.claude-work/proposal-[slug]/proposta-[slug].pptx"
     folder_id="[pasta-cliente-drive]"
   ```

3. **Registar no CRM** (se nao existir estimate):
   ```
   mcp__desk-crm-v3__create_estimate
     client_id=[id]
     date=[hoje]
     expiry_date=[hoje + 30 dias]
     items=[items]
   ```

4. **Limpar temporarios:**
   ```bash
   rm -rf ~/.claude-work/proposal-[slug]/
   ```

---

## Exemplos de Propostas Tipicas

### Website Corporativo (CorporateWP)

**Tipo:** Standard (12 slides)
**Servico:** CorporateWP
**Slides seleccionados:** capa, sobre-nos, divisor, objectivos, processo-3-passos, fases-3-blocos, divisor, beneficios-6, deliverables, timeline-etapas, contacto, encerramento

**Conteudo tipico:**
- **Objectivos:** Presenca profissional online, geracao de leads, credibilidade digital
- **3 Passos:** Descoberta -> Desenvolvimento -> Lancamento
- **3 Fases:** Analise e Conteudo (S1-2) -> Design e Desenvolvimento (S3-5) -> Testes e Lancamento (S6)
- **6 Beneficios:** Design responsivo, SEO optimizado, painel intuitivo, SSL incluido, suporte dedicado, performance rapida
- **Deliverables:** Website responsivo, 5-8 paginas, formularios, integracao redes sociais, Google Analytics, formacao
- **Timeline:** 4-6 semanas, 900 EUR + IVA, anuidade 299 EUR

### Marketing 360

**Tipo:** Completa (16 slides)
**Servico:** Marketing Digital 360
**Slides seleccionados:** todos os 16

**Conteudo tipico:**
- **Objectivos:** Aumentar visibilidade, gerar leads qualificados, ROI mensuravel, posicionamento digital
- **4 Pilares (engrenagens):** SEO, Redes Sociais, Publicidade Online, Email Marketing
- **Processo:** Auditoria -> Estrategia -> Execucao
- **6 Beneficios:** Mais trafego, leads qualificados, brand awareness, ROI mensuravel, relatorios mensais, equipa dedicada
- **Deliverables:** Auditoria inicial, plano estrategico, gestao redes sociais, campanhas Ads, relatorios mensais, reunioes quinzenais
- **Timeline:** Ongoing, setup 500-1500 EUR, mensalidade 300-800 EUR

### SEO / Optimizacao

**Tipo:** Standard (12 slides)
**Servico:** Pack SEO
**Slides seleccionados:** capa, sobre-nos, divisor, objectivos, processo-3-passos, grid-4-cards, divisor, detalhe-servico, deliverables, pack-pricing, contacto, encerramento

**Conteudo tipico:**
- **Objectivos:** Melhorar posicionamento Google, aumentar trafego organico, ultrapassar concorrencia
- **3 Passos:** Auditoria Tecnica -> Optimizacao On-Page -> Link Building
- **4 Cards:** Pesquisa Keywords, SEO Tecnico, Conteudo Optimizado, Relatorios Mensais
- **Deliverables:** Auditoria inicial, optimizacao 10-20 paginas, blog mensal, relatorio posicoes, Google Search Console
- **Pricing:** Mensalidade 300-600 EUR conforme pack

---

## MCPs Utilizados

```
mcp__desk-crm-v3__search_customers   - Pesquisar cliente
mcp__desk-crm-v3__get_customer       - Obter detalhes cliente
mcp__desk-crm-v3__get_estimates      - Verificar orcamentos existentes
mcp__desk-crm-v3__create_estimate    - Registar estimate no CRM
mcp__desk-crm-v3__price_management   - Consultar precos oficiais
mcp__google-workspace__drive_upload_file - Upload para Google Drive
mcp__mcp-time__current_time          - Data/hora actual
```

---

## Checklist de Execucao

- [ ] Cliente identificado no CRM
- [ ] Dados recolhidos (objectivos, servicos, precos)
- [ ] Tipo de proposta seleccionado (minima/standard/completa)
- [ ] Layouts seleccionados e conteudo definido
- [ ] Template copiado para ~/.claude-work/
- [ ] PPTX descompactado
- [ ] Slides editados com dados do cliente
- [ ] Slides desnecessarios removidos
- [ ] XMLs limpos (clean.py)
- [ ] PPTX recompactado e validado
- [ ] Ficheiro guardado em Hub/03-Propostas/[cliente]/
- [ ] Temporarios limpos
- [ ] Estimate registado no CRM (se aplicavel)

---

## Anti-Patterns

| Fazer | NAO Fazer |
|-------|-----------|
| Personalizar cada slide com dados reais do cliente | Usar placeholders genericos ou "Lorem ipsum" |
| Consultar CRM para precos actualizados | Inventar precos de memoria |
| Seleccionar layouts relevantes para o servico | Incluir todos os 16 slides quando 8 bastam |
| Manter branding Descomplicar (cores, fontes, logo) | Alterar formatacao XML (cores, tamanhos, posicoes) |
| Guardar em Hub/03-Propostas/ com nome descritivo | Deixar ficheiros em ~/.claude-work/ |
| Usar slug sem espacos no nome do ficheiro | Espacos ou caracteres especiais no nome |
| Verificar PPTX abre correctamente apos geracao | Entregar sem validar |
| Adaptar objectivos ao sector do cliente | Copiar objectivos genericos entre propostas |
| Incluir dados de contacto do gestor real | Dados de contacto ficticios |

---

## Procedimentos Relacionados

- `PROC-Catalogo-Codificacao-Produtos.md` - Codificacao e catalogo de produtos
- `PROC-CRM-Operacoes.md` - Operacoes CRM padrao

---

## Changelog

### v1.0.0 (2026-03-06)
- Versao inicial da skill /proposal-deck
- 16 layouts mapeados do template PPTX curado
- 3 niveis de complexidade: minima (8), standard (12), completa (16)
- Integracao CRM (cliente, estimates, precos)
- Workflow completo: recolha -> seleccao -> geracao -> entrega
- Exemplos para website, marketing 360, SEO
- Anti-patterns documentados

---

**Versao**: 1.0.0 | **Data**: 2026-03-06 | **Template**: descomplicar-proposal-template.pptx