feat: adiciona 12 plugins Descomplicar ao marketplace
Plugins: automacao, crm-ops, design-media, dev-tools, gestao, infraestrutura, marketing, negocio, perfex-dev, project-manager, wordpress + hello-plugin (existente). Totais: 83 skills, 44 agents, 12 datasets.json Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
445
negocio/skills/ecommerce/SKILL.md
Normal file
445
negocio/skills/ecommerce/SKILL.md
Normal file
@@ -0,0 +1,445 @@
|
||||
---
|
||||
name: ecommerce
|
||||
description: Skill especializada em estratégia e arquitectura de e-commerce, cobrindo
|
||||
desde a escolha de plataforma até optimização de conversão.
|
||||
author: Descomplicar® Crescimento Digital
|
||||
version: 2.0.0
|
||||
quality_score: 55
|
||||
user_invocable: true
|
||||
desk_task: null
|
||||
allowed-tools: Task
|
||||
---
|
||||
|
||||
# Skill /ecommerce - E-commerce Strategy & Architecture
|
||||
|
||||
Skill especializada em estratégia e arquitectura de e-commerce, cobrindo desde a escolha de plataforma até optimização de conversão.
|
||||
|
||||
## Sintaxe
|
||||
|
||||
```
|
||||
/ecommerce [operacao] [contexto]
|
||||
```
|
||||
|
||||
**Operações:**
|
||||
- `analise` - Análise de projecto e-commerce existente ou novo
|
||||
- `plataforma` - Recomendação de plataforma (WooCommerce vs Shopify vs custom)
|
||||
- `funil` - Análise e optimização do funil de conversão
|
||||
- `integracao` - Planeamento de integrações (ERP, pagamentos, logística)
|
||||
- `pricing` - Estratégia de preços e promoções
|
||||
|
||||
## Quando Usar
|
||||
|
||||
- Cliente quer abrir loja online
|
||||
- Optimizar conversão de e-commerce existente
|
||||
- Integração com ERP/facturação/logística
|
||||
- Migração entre plataformas
|
||||
- Estratégia omnichannel
|
||||
|
||||
---
|
||||
|
||||
## Protocolo de Execução
|
||||
|
||||
### 1. Discovery (SEMPRE começar aqui)
|
||||
|
||||
**Questões chave:**
|
||||
```
|
||||
Modelo de negócio:
|
||||
- [ ] B2C, B2B ou D2C?
|
||||
- [ ] Único vendedor ou marketplace?
|
||||
- [ ] Produtos físicos ou digitais?
|
||||
|
||||
Catálogo:
|
||||
- [ ] Quantos SKUs?
|
||||
- [ ] Variações por produto (tamanhos, cores)?
|
||||
- [ ] Stock centralizado ou múltiplos armazéns?
|
||||
|
||||
Volume esperado:
|
||||
- [ ] Ticket médio?
|
||||
- [ ] Pedidos/mês estimados?
|
||||
- [ ] Sazonalidade?
|
||||
|
||||
Integrações:
|
||||
- [ ] ERP existente (PHC, Primavera, SAP)?
|
||||
- [ ] Gateway pagamento preferido?
|
||||
- [ ] Transportadoras (CTT, DPD, GLS)?
|
||||
```
|
||||
|
||||
### 2. Escolha de Plataforma
|
||||
|
||||
**Matriz de Decisão:**
|
||||
|
||||
| Critério | WooCommerce | Shopify | Custom |
|
||||
|----------|-------------|---------|--------|
|
||||
| **Custo inicial** | 1.100€ (eCommerceWP) | ~200€/mês | 5.000€+ |
|
||||
| **Escalabilidade** | Até 5k pedidos/mês | Ilimitado | Ilimitado |
|
||||
| **Customização** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
|
||||
| **Integrações PT** | ⭐⭐⭐⭐ (MB, CTT, Moloni) | ⭐⭐ | ⭐⭐⭐⭐⭐ |
|
||||
| **Manutenção** | Média (WordPress) | Baixa (hosted) | Alta |
|
||||
| **Time to market** | 7-9 semanas | 4-6 semanas | 3-6 meses |
|
||||
|
||||
**Recomendação Descomplicar:**
|
||||
- **< 1.000 SKUs + orçamento < 3k** → eCommerceWP (WooCommerce)
|
||||
- **> 1.000 SKUs + escalabilidade prioritária** → Shopify Plus
|
||||
- **Processos únicos + integração ERP complexa** → Custom Laravel + Vue
|
||||
|
||||
### 3. Arquitectura Técnica
|
||||
|
||||
```
|
||||
┌─────────────┐
|
||||
│ FRONTEND │ CDN (Cloudflare)
|
||||
│ (Site) │ Cache (Varnish/Redis)
|
||||
└──────┬──────┘
|
||||
│
|
||||
┌──────▼──────┐
|
||||
│ API │ REST/GraphQL
|
||||
│ (Backend) │ Rate limiting
|
||||
└──────┬──────┘
|
||||
│
|
||||
┌──────▼──────────────────┐
|
||||
│ INTEGRAÇÕES │
|
||||
├─────────────────────────┤
|
||||
│ Pagamentos (Stripe/MB) │
|
||||
│ Facturação (Moloni) │
|
||||
│ Stock (ERP) │
|
||||
│ Envios (CTT/DPD) │
|
||||
│ Marketing (GA4/Meta) │
|
||||
└─────────────────────────┘
|
||||
```
|
||||
|
||||
### 4. Funil de Conversão
|
||||
|
||||
**Benchmarks e Optimizações:**
|
||||
|
||||
```
|
||||
🔍 VISITANTES (tráfego)
|
||||
│
|
||||
├─ Bounce Rate < 40% (target)
|
||||
│ ► Home clara e rápida (< 2s)
|
||||
│ ► Proposta de valor visível
|
||||
▼
|
||||
📦 PRODUTO (categoria/pesquisa)
|
||||
│
|
||||
├─ Add to Cart Rate > 8%
|
||||
│ ► Fotos profissionais (min 5 por produto)
|
||||
│ ► Descrições completas
|
||||
│ ► Reviews e avaliações
|
||||
│ ► Stock e prazo entrega visíveis
|
||||
▼
|
||||
🛒 CARRINHO
|
||||
│
|
||||
├─ Cart Abandonment < 70%
|
||||
│ ► Recuperação automática (CartRecovery)
|
||||
│ ► Custos envio antecipados
|
||||
│ ► Checkout em 1 página
|
||||
▼
|
||||
💳 CHECKOUT
|
||||
│
|
||||
├─ Completion Rate > 50%
|
||||
│ ► Guest checkout permitido
|
||||
│ ► MB Way + Multibanco + Cartão
|
||||
│ ► Campos mínimos
|
||||
▼
|
||||
✅ COMPRA
|
||||
│
|
||||
├─ Repeat Rate > 20%
|
||||
│ ► Email pós-compra (obrigado)
|
||||
│ ► Programa fidelização
|
||||
│ ► Recomendações personalizadas
|
||||
▼
|
||||
🔁 RECOMPRA
|
||||
```
|
||||
|
||||
**Triggers de Abandono (CartRecovery):**
|
||||
- Email 1h depois: "Esqueceu algo?"
|
||||
- Email 24h depois: "Ainda disponível" + urgência
|
||||
- Email 48h depois: Desconto 5-10%
|
||||
|
||||
---
|
||||
|
||||
## Integrações Essenciais
|
||||
|
||||
### Pagamentos (Portugal)
|
||||
|
||||
| Gateway | Custo | Tempo Integração | Usar Quando |
|
||||
|---------|-------|------------------|-------------|
|
||||
| **MB Way + Multibanco** | Gratuito (IFTHENPAY) | 2h | Obrigatório PT |
|
||||
| **Stripe** | 1.4% + 0.25€ | 4h | Cartões internacionais |
|
||||
| **PayPal** | 3.4% + 0.35€ | 1h | Compradores sem cartão |
|
||||
|
||||
### Facturação
|
||||
|
||||
| Sistema | Custo | Integração | Notas |
|
||||
|---------|-------|-----------|-------|
|
||||
| **Moloni** | 15€/mês | API (MCP disponível) | Recomendado Descomplicar |
|
||||
| **InvoiceXpress** | 20€/mês | API | Mais features |
|
||||
| **Manual** | Grátis | - | Só para < 10 pedidos/mês |
|
||||
|
||||
### Logística
|
||||
|
||||
| Transportadora | API | Tracking | Custo Setup |
|
||||
|----------------|-----|----------|-------------|
|
||||
| **CTT Expresso** | ✅ | ✅ | 0€ (conta empresa) |
|
||||
| **DPD Portugal** | ✅ | ✅ | 0€ |
|
||||
| **GLS** | ✅ | ✅ | 0€ |
|
||||
| **InPost** | ✅ | ✅ (lockers) | 0€ |
|
||||
|
||||
**Recomendação:** Múltiplas opções + cálculo automático no checkout.
|
||||
|
||||
### Marketing & Analytics
|
||||
|
||||
```javascript
|
||||
// Stack completo e-commerce
|
||||
Google Analytics 4 (obrigatório)
|
||||
Meta Pixel (Facebook/Instagram Ads)
|
||||
Google Tag Manager (gestão tags)
|
||||
Hotjar/Microsoft Clarity (heatmaps)
|
||||
Klaviyo/Mailchimp (email marketing)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Métricas Chave (KPIs)
|
||||
|
||||
### Conversão
|
||||
|
||||
| Métrica | Benchmark | Como Medir |
|
||||
|---------|-----------|------------|
|
||||
| **Conversion Rate** | 2-3% | Compras / Visitantes |
|
||||
| **Add to Cart Rate** | 8-12% | Adicionar carrinho / Views produto |
|
||||
| **Cart Abandonment** | 65-70% | Carrinhos abandonados / Total |
|
||||
| **Checkout Completion** | 50-60% | Compras / Início checkout |
|
||||
|
||||
### Receita
|
||||
|
||||
| Métrica | Fórmula | Target |
|
||||
|---------|---------|--------|
|
||||
| **AOV** (Avg Order Value) | Receita / Nº pedidos | Sector-dependent |
|
||||
| **CLV** (Customer Lifetime Value) | AOV × Compras médias × Margem | > 3× CAC |
|
||||
| **CAC** (Customer Acquisition Cost) | Investimento marketing / Novos clientes | < 1/3 CLV |
|
||||
| **Repeat Purchase Rate** | Clientes repetentes / Total clientes | > 20% |
|
||||
|
||||
### Operacional
|
||||
|
||||
```
|
||||
- Stock turnover: Vendas / Stock médio (> 6× ano)
|
||||
- Order fulfillment time: < 24h
|
||||
- Return rate: < 5%
|
||||
- Customer support tickets/order: < 10%
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Checklist Lançamento E-commerce
|
||||
|
||||
**Pré-Lançamento:**
|
||||
```
|
||||
[ ] Catálogo completo (fotos + descrições + preços)
|
||||
[ ] Stock actualizado e sincronizado
|
||||
[ ] Políticas publicadas (devolução, privacidade, T&C)
|
||||
[ ] Gateways pagamento testados (transações reais)
|
||||
[ ] Envios configurados e custos correctos
|
||||
[ ] Emails transaccionais personalizados
|
||||
[ ] SSL activo em todo o site
|
||||
[ ] Mobile responsive verificado
|
||||
```
|
||||
|
||||
**Marketing:**
|
||||
```
|
||||
[ ] Google Analytics 4 instalado e a rastrear
|
||||
[ ] Meta Pixel activo
|
||||
[ ] Google Merchant Center configurado
|
||||
[ ] SEO básico (títulos, meta descriptions, structured data)
|
||||
[ ] Sitemap XML enviado
|
||||
```
|
||||
|
||||
**Operacional:**
|
||||
```
|
||||
[ ] Teste end-to-end (compra completa)
|
||||
[ ] Processo de fulfillment documentado
|
||||
[ ] Equipa treinada (gestão pedidos + suporte)
|
||||
[ ] Plano de contingência (stock out, pagamentos falhados)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Integração com Descomplicar
|
||||
|
||||
### Pacote eCommerceWP
|
||||
|
||||
**Incluído (1.100€ setup + 349€/ano):**
|
||||
- WooCommerce configurado
|
||||
- MB Way + Multibanco (IFTHENPAY)
|
||||
- 3 gateways envio
|
||||
- Integração Moloni (facturação)
|
||||
- 50 produtos configurados
|
||||
- Google Analytics 4
|
||||
- Meta Pixel
|
||||
|
||||
**Add-ons Comuns:**
|
||||
```
|
||||
ShopBuilder: 5€/produto extra (> 50)
|
||||
CartRecovery: 190€ setup + 90€/ano
|
||||
Subscriptions: 150€ (produtos recorrentes)
|
||||
Marketplaces (Amazon/eBay): 300€ integração
|
||||
```
|
||||
|
||||
### Workflow Projecto
|
||||
|
||||
```
|
||||
1. Discovery (2-3h)
|
||||
- Questionário cliente
|
||||
- Análise concorrência
|
||||
- Proposta plataforma
|
||||
|
||||
2. Planeamento (1 semana)
|
||||
- Arquitectura técnica
|
||||
- Mapeamento integrações
|
||||
- Wireframes checkout
|
||||
|
||||
3. Desenvolvimento (4-6 semanas)
|
||||
- Setup plataforma
|
||||
- Design frontend
|
||||
- Configuração produtos
|
||||
- Testes pagamentos
|
||||
|
||||
4. Lançamento (1 semana)
|
||||
- Migração dados (se aplicável)
|
||||
- Testes finais
|
||||
- Formação cliente
|
||||
- Go-live
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Consultar Datasets Dify
|
||||
|
||||
**SEMPRE antes de propor solução:**
|
||||
|
||||
| Dataset | ID | Query Exemplo |
|
||||
|---------|----|--------------:|
|
||||
| **Marketing Digital** | `c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24` | "funil conversao ecommerce optimizacao" |
|
||||
| **Vendas** | `a7ba6005-517c-41ab-ac5e-da1c1a1c62ef` | "estrategia pricing loja online" |
|
||||
| **Desenvolvimento WebSites** | `c8489151-de94-42b2-8cee-c0b961cfac6d` | "woocommerce gateways pagamento portugal" |
|
||||
| **Serviços Descomplicar** | `bd65f36e-6004-4584-b478-129b2c21b4d2` | "pacote ecommerce funcionalidades" |
|
||||
|
||||
### Como Consultar
|
||||
|
||||
```javascript
|
||||
// Estratégia de conversão
|
||||
mcp__dify-kb__dify_kb_retrieve_segments({
|
||||
dataset_id: "c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24",
|
||||
query: "optimizar taxa conversao checkout abandono carrinho",
|
||||
retrieval_mode: "hybrid_search",
|
||||
top_k: 5
|
||||
});
|
||||
|
||||
// Pricing e margens
|
||||
mcp__dify-kb__dify_kb_retrieve_segments({
|
||||
dataset_id: "a7ba6005-517c-41ab-ac5e-da1c1a1c62ef",
|
||||
query: "estrategia precos markup ecommerce",
|
||||
retrieval_mode: "hybrid_search",
|
||||
top_k: 5
|
||||
});
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## MCPs Utilizados
|
||||
|
||||
```
|
||||
mcp__desk-crm-v3__get_projects # Verificar projectos e-commerce
|
||||
mcp__desk-crm-v3__create_estimate # Orçamento eCommerceWP
|
||||
mcp__dify-kb__dify_kb_retrieve_segments # Conhecimento estratégico
|
||||
mcp__moloni__* # Integração facturação
|
||||
mcp__web-fetch__* # Análise concorrência
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Exemplos de Uso
|
||||
|
||||
### 1. Novo Projecto E-commerce
|
||||
```
|
||||
/ecommerce analise
|
||||
→ Discovery interactivo
|
||||
→ Consulta Dify KB (benchmarks sector)
|
||||
→ Recomendação plataforma
|
||||
→ Proposta Descomplicar (orçamento)
|
||||
```
|
||||
|
||||
### 2. Optimização Conversão
|
||||
```
|
||||
/ecommerce funil
|
||||
→ Análise métricas actuais (GA4)
|
||||
→ Identificação bottlenecks
|
||||
→ Recomendações prioritizadas (quick wins)
|
||||
→ Plano implementação
|
||||
```
|
||||
|
||||
### 3. Integrações
|
||||
```
|
||||
/ecommerce integracao
|
||||
→ Levantamento sistemas existentes
|
||||
→ Mapeamento fluxos dados
|
||||
→ Proposta arquitectura
|
||||
→ Timeline e custos
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Agentes Recomendados
|
||||
|
||||
Para análises complexas, delegar a agentes:
|
||||
|
||||
```javascript
|
||||
// Estratégia marketing
|
||||
Task({
|
||||
subagent_type: "marketing-planning-expert",
|
||||
model: "sonnet",
|
||||
prompt: "Analisar funil e-commerce [URL]. Propor optimizações conversion rate."
|
||||
});
|
||||
|
||||
// Arquitectura técnica
|
||||
Task({
|
||||
subagent_type: "php-fullstack-engineer",
|
||||
model: "sonnet",
|
||||
prompt: "Integração WooCommerce → Moloni → CTT API. Arquitectura e fluxo."
|
||||
});
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Instrumentação Automática
|
||||
|
||||
Esta skill grava métricas automaticamente para análise PDCA.
|
||||
|
||||
### Baseline
|
||||
|
||||
| Métrica | Valor |
|
||||
|---------|-------|
|
||||
| Tempo baseline | 40 min |
|
||||
| Tempo target | 20 min |
|
||||
| Melhoria esperada | -50% |
|
||||
|
||||
### Query para Gravar (executar no final)
|
||||
|
||||
```sql
|
||||
INSERT INTO tblskill_agent_metrics (
|
||||
type, name, duration_ms, status, staff_id,
|
||||
kb_consulted, kb_cache_hit, tool_calls, project_id
|
||||
) VALUES (
|
||||
'skill', '/ecommerce', {DURACAO_MS}, '{STATUS}', 25,
|
||||
{KB_CONSULTADO}, {CACHE_HIT}, {TOOL_CALLS}, {PROJECT_ID}
|
||||
);
|
||||
```
|
||||
|
||||
### Ver Métricas
|
||||
|
||||
```bash
|
||||
/metrics /ecommerce
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**Versão**: 2.0.0 | **Data**: 2026-02-03 | **Autor**: Descomplicar®
|
||||
**Instrumentação**: Activa
|
||||
329
negocio/skills/interview/SKILL.md
Normal file
329
negocio/skills/interview/SKILL.md
Normal file
@@ -0,0 +1,329 @@
|
||||
---
|
||||
name: interview
|
||||
description: Technical interview preparation and candidate evaluation. Creates interview
|
||||
questions, evaluates responses, and provides feedback. Use when user mentions "interview",
|
||||
"entrevista", "candidate evaluation", "technical interview", "interview questions".
|
||||
author: Descomplicar® Crescimento Digital
|
||||
version: 1.0.0
|
||||
quality_score: 75
|
||||
user_invocable: true
|
||||
desk_task: 1473
|
||||
---
|
||||
|
||||
# /interview - Entrevista Estruturada de Requisitos
|
||||
|
||||
Skill para clarificar requisitos antes de iniciar trabalho. Reduz ambiguidade e evita retrabalho.
|
||||
|
||||
---
|
||||
|
||||
## QUANDO USAR
|
||||
|
||||
- Início de projecto novo
|
||||
- Tarefa complexa ou ambígua
|
||||
- Pedido do utilizador pouco claro
|
||||
- Antes de decisões arquitecturais
|
||||
|
||||
---
|
||||
|
||||
## EXECUÇÃO
|
||||
|
||||
### Fase 1: Contexto (OBRIGATÓRIO)
|
||||
|
||||
Perguntar usando `AskUserQuestion`:
|
||||
|
||||
```
|
||||
1. O QUÊ?
|
||||
- "Descreve o que queres alcançar em 1-2 frases"
|
||||
|
||||
2. PORQUÊ?
|
||||
- "Qual o problema que isto resolve?"
|
||||
- "O que acontece se não fizermos?"
|
||||
|
||||
3. PARA QUEM?
|
||||
- "Quem vai usar/beneficiar disto?"
|
||||
```
|
||||
|
||||
### Fase 2: Objectivos
|
||||
|
||||
```
|
||||
4. RESULTADO ESPERADO
|
||||
- "Como sabes que está feito?"
|
||||
- "O que muda quando terminar?"
|
||||
|
||||
5. PRIORIDADE
|
||||
- "É urgente ou importante?"
|
||||
- "Deadline real ou desejado?"
|
||||
```
|
||||
|
||||
### Fase 3: Restrições
|
||||
|
||||
```
|
||||
6. TECNOLOGIA
|
||||
- "Há tecnologias obrigatórias ou proibidas?"
|
||||
- "Integra com sistemas existentes?"
|
||||
|
||||
7. RECURSOS
|
||||
- "Quanto tempo podes dedicar?"
|
||||
- "Há dependências de terceiros?"
|
||||
|
||||
8. LIMITAÇÕES
|
||||
- "O que NÃO deve fazer?"
|
||||
- "Há riscos conhecidos?"
|
||||
```
|
||||
|
||||
### Fase 4: Validação
|
||||
|
||||
```
|
||||
9. CRITÉRIOS DE SUCESSO
|
||||
- "Como vamos validar que funciona?"
|
||||
- "Há testes ou cenários específicos?"
|
||||
|
||||
10. EXEMPLOS
|
||||
- "Tens exemplos do que queres?"
|
||||
- "Ou do que NÃO queres?"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## OUTPUT
|
||||
|
||||
Após recolher respostas, gerar documento com **BACKLOG CLARO**:
|
||||
|
||||
```markdown
|
||||
---
|
||||
title: "REQ - [Nome do Projecto/Tarefa]"
|
||||
date: YYYY-MM-DD
|
||||
type: requisitos
|
||||
status: draft
|
||||
tags: [requisitos, interview, backlog, PROJECTO]
|
||||
---
|
||||
|
||||
# Requisitos: [Nome]
|
||||
|
||||
## Contexto
|
||||
- **O quê:** [resposta]
|
||||
- **Porquê:** [resposta]
|
||||
- **Para quem:** [resposta]
|
||||
|
||||
## Objectivos
|
||||
- **Resultado esperado:** [resposta]
|
||||
- **Prioridade:** [Urgente/Importante/Normal]
|
||||
- **Deadline:** [data ou N/A]
|
||||
|
||||
## Restrições
|
||||
- **Tecnologia:** [resposta]
|
||||
- **Recursos:** [resposta]
|
||||
- **Limitações:** [resposta]
|
||||
|
||||
---
|
||||
|
||||
## BACKLOG
|
||||
|
||||
> Lista ordenada de tarefas antes de arrancar.
|
||||
|
||||
### Fase 1: Preparação
|
||||
- [ ] [tarefa preparatória 1]
|
||||
- [ ] [tarefa preparatória 2]
|
||||
|
||||
### Fase 2: Desenvolvimento
|
||||
- [ ] [tarefa core 1]
|
||||
- [ ] [tarefa core 2]
|
||||
- [ ] [tarefa core 3]
|
||||
|
||||
### Fase 3: Validação
|
||||
- [ ] [teste/validação 1]
|
||||
- [ ] [teste/validação 2]
|
||||
|
||||
### Fase 4: Entrega
|
||||
- [ ] [tarefa final 1]
|
||||
- [ ] [documentação se aplicável]
|
||||
|
||||
---
|
||||
|
||||
## Critérios de Sucesso
|
||||
- [ ] [critério 1]
|
||||
- [ ] [critério 2]
|
||||
- [ ] [critério 3]
|
||||
|
||||
## Riscos Identificados
|
||||
| Risco | Impacto | Mitigação |
|
||||
|-------|---------|-----------|
|
||||
| [risco] | [alto/médio/baixo] | [acção] |
|
||||
|
||||
## Decisões Tomadas
|
||||
| Decisão | Motivo | Alternativas Descartadas |
|
||||
|---------|--------|--------------------------|
|
||||
| [decisão] | [razão] | [alternativas] |
|
||||
|
||||
---
|
||||
*Gerado via `/interview` - YYYY-MM-DD*
|
||||
```
|
||||
|
||||
### Regras do Backlog
|
||||
|
||||
1. **Ordenação:** Tarefas na ordem de execução
|
||||
2. **Granularidade:** Cada tarefa = 1-4 horas max
|
||||
3. **Dependências:** Tarefas bloqueantes primeiro
|
||||
4. **Checkboxes:** Para tracking de progresso
|
||||
5. **Fases:** Agrupar por momento (preparação, dev, validação, entrega)
|
||||
|
||||
---
|
||||
|
||||
## MODO RÁPIDO
|
||||
|
||||
Se o utilizador pedir `/interview quick` ou a tarefa for simples:
|
||||
|
||||
Perguntar apenas:
|
||||
1. O quê?
|
||||
2. Resultado esperado?
|
||||
3. Restrições importantes?
|
||||
|
||||
Output: Lista bullet points, não documento completo.
|
||||
|
||||
---
|
||||
|
||||
## MODO TÉCNICO
|
||||
|
||||
Se o utilizador pedir `/interview tech` ou for projecto de código:
|
||||
|
||||
Adicionar:
|
||||
- Arquitectura preferida?
|
||||
- Padrões de código?
|
||||
- Testes necessários?
|
||||
- Documentação esperada?
|
||||
|
||||
---
|
||||
|
||||
## GUARDAR REQUISITOS
|
||||
|
||||
Após gerar documento:
|
||||
|
||||
1. **Se projecto tem pasta:** Guardar em `[pasta-projecto]/docs/REQ-[nome].md`
|
||||
2. **Se não:** Guardar em Obsidian vault `00-Inbox/REQ-[nome].md`
|
||||
3. **Memória:** Guardar resumo em Supabase para referência futura
|
||||
|
||||
```javascript
|
||||
await mcp__memory-supabase__save_memory({
|
||||
content: "Requisitos [nome]: [resumo 2-3 frases]",
|
||||
metadata: {
|
||||
type: "requisitos",
|
||||
project: "[nome]",
|
||||
date: "YYYY-MM-DD"
|
||||
}
|
||||
});
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ANTI-PATTERNS
|
||||
|
||||
**NÃO fazer:**
|
||||
- Assumir respostas
|
||||
- Saltar perguntas "óbvias"
|
||||
- Começar a implementar antes de terminar
|
||||
- Fazer todas as perguntas de uma vez (usar fases)
|
||||
|
||||
**FAZER:**
|
||||
- Adaptar perguntas ao contexto
|
||||
- Pedir exemplos concretos
|
||||
- Validar entendimento ("Então queres X, correcto?")
|
||||
- Identificar ambiguidades
|
||||
|
||||
---
|
||||
|
||||
## EXEMPLO DE USO
|
||||
|
||||
```
|
||||
Utilizador: /interview
|
||||
|
||||
Claude: Vou fazer algumas perguntas para clarificar os requisitos.
|
||||
|
||||
**Fase 1: Contexto**
|
||||
|
||||
[AskUserQuestion com 3 perguntas iniciais]
|
||||
|
||||
Utilizador: [respostas]
|
||||
|
||||
Claude: Entendido. Agora sobre objectivos...
|
||||
|
||||
**Fase 2: Objectivos**
|
||||
|
||||
[continua...]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## INTEGRAÇÃO
|
||||
|
||||
- **Antes de `/wp-dev`:** Usar `/interview tech` para requisitos WordPress
|
||||
- **Antes de projecto CRM:** Usar `/interview` para requisitos cliente
|
||||
- **Com `/desk`:** Associar requisitos a tarefa CRM
|
||||
|
||||
---
|
||||
|
||||
*Skill criada: 2026-01-27*
|
||||
*Versão: 1.0*
|
||||
|
||||
---
|
||||
|
||||
|
||||
## Quando NÃO Usar
|
||||
|
||||
- Para tarefas fora do domínio de especialização desta skill
|
||||
- Quando outra skill mais específica está disponível
|
||||
- Para operações que requerem aprovação manual obrigatória
|
||||
- Quando os requisitos não estão claramente definidos
|
||||
|
||||
|
||||
## Protocolo de Execução
|
||||
|
||||
1. **Análise Inicial**
|
||||
- Verificar requisitos e contexto
|
||||
- Identificar ferramentas necessárias
|
||||
|
||||
2. **Preparação**
|
||||
- Validar acesso a recursos
|
||||
- Preparar ambiente de trabalho
|
||||
|
||||
3. **Execução**
|
||||
- Executar operações de forma incremental
|
||||
- Validar cada passo antes de prosseguir
|
||||
|
||||
4. **Validação**
|
||||
- Verificar resultados obtidos
|
||||
- Confirmar sucesso da operação
|
||||
|
||||
5. **Conclusão**
|
||||
- Documentar alterações realizadas
|
||||
- Reportar status final e próximos passos
|
||||
|
||||
|
||||
## Exemplos de Uso
|
||||
|
||||
### Exemplo 1: Caso Básico
|
||||
```
|
||||
User: [requisição simples relacionada com interview]
|
||||
Skill: [execução directa com validação]
|
||||
Output: [resultado conciso e accionável]
|
||||
```
|
||||
|
||||
### Exemplo 2: Caso Complexo
|
||||
```
|
||||
User: [requisição multi-passo ou complexa]
|
||||
Skill:
|
||||
1. Análise dos requisitos
|
||||
2. Planeamento da abordagem
|
||||
3. Execução faseada
|
||||
4. Validação contínua
|
||||
Output: [resultado detalhado com próximos passos]
|
||||
```
|
||||
|
||||
### Exemplo 3: Caso com Dependências
|
||||
```
|
||||
User: [requisição que depende de outros sistemas]
|
||||
Skill:
|
||||
1. Verificar dependências disponíveis
|
||||
2. Coordenar com skills/MCPs necessários
|
||||
3. Executar workflow integrado
|
||||
Output: [resultado completo com referências]
|
||||
```
|
||||
522
negocio/skills/product/SKILL.md
Normal file
522
negocio/skills/product/SKILL.md
Normal file
@@ -0,0 +1,522 @@
|
||||
---
|
||||
name: product
|
||||
description: Skill especializada em gestão de produto, desde discovery até execução,
|
||||
usando frameworks como RICE, MoSCoW e Jobs-to-be-Done.
|
||||
author: Descomplicar® Crescimento Digital
|
||||
version: 2.0.0
|
||||
quality_score: 55
|
||||
user_invocable: true
|
||||
desk_task: null
|
||||
allowed-tools: Read, Task
|
||||
---
|
||||
|
||||
# Skill /product - Product Management & Planning
|
||||
|
||||
Skill especializada em gestão de produto, desde discovery até execução, usando frameworks como RICE, MoSCoW e Jobs-to-be-Done.
|
||||
|
||||
## Sintaxe
|
||||
|
||||
```
|
||||
/product [operacao] [contexto]
|
||||
```
|
||||
|
||||
**Operações:**
|
||||
- `discovery` - Problem space, jobs-to-be-done, validation
|
||||
- `prioritize` - RICE scoring, MoSCoW, value/effort matrix
|
||||
- `roadmap` - Planeamento quadrimestral, epics, milestones
|
||||
- `backlog` - User stories, acceptance criteria, refinement
|
||||
- `sprint` - Sprint planning, capacity, DoD
|
||||
|
||||
## Quando Usar
|
||||
|
||||
- Planear novo produto ou feature
|
||||
- Priorizar backlog com múltiplas requests
|
||||
- Criar roadmap trimestral/anual
|
||||
- Refinar user stories
|
||||
- Optimizar processo de produto
|
||||
|
||||
---
|
||||
|
||||
## Protocolo de Execução
|
||||
|
||||
### 1. Product Discovery
|
||||
|
||||
**Problem Space (não Solution Space):**
|
||||
|
||||
```markdown
|
||||
## Jobs to be Done (JTBD)
|
||||
|
||||
When [situação]
|
||||
I want to [motivação]
|
||||
So I can [outcome desejado]
|
||||
|
||||
### Exemplo:
|
||||
When I need to share a report with my team
|
||||
I want to export to PDF with custom branding
|
||||
So I can present professional documents to stakeholders
|
||||
```
|
||||
|
||||
**Pain Points Discovery:**
|
||||
|
||||
```
|
||||
Perguntas a fazer:
|
||||
1. O que frustra o utilizador actualmente?
|
||||
2. Que workarounds usa hoje?
|
||||
3. Quanto tempo/dinheiro perde com o problema?
|
||||
4. Qual a frequência do problema?
|
||||
5. O que tentou fazer para resolver?
|
||||
|
||||
Evidência:
|
||||
- [ ] 5+ entrevistas com users
|
||||
- [ ] Analytics de uso (onde abandonam?)
|
||||
- [ ] Tickets de suporte relacionados
|
||||
- [ ] Pesquisa concorrência (como resolvem?)
|
||||
```
|
||||
|
||||
**Validation Framework:**
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────┐
|
||||
│ DESIRABILITY (Users querem?) │
|
||||
├─────────────────────────────────────────────────┤
|
||||
│ ☐ Problem interviews (10+) │
|
||||
│ ☐ Solution interviews (5+) │
|
||||
│ ☐ Survey (50+ respostas) │
|
||||
│ ☐ Prototype test (usability) │
|
||||
│ Evidence: X% users pagaria, Y% usaria diário │
|
||||
└─────────────────────────────────────────────────┘
|
||||
|
||||
┌─────────────────────────────────────────────────┐
|
||||
│ VIABILITY (Negócio faz sentido?) │
|
||||
├─────────────────────────────────────────────────┤
|
||||
│ ☐ Market size (TAM/SAM/SOM) │
|
||||
│ ☐ Revenue model claro │
|
||||
│ ☐ Unit economics positivos │
|
||||
│ ☐ Payback period aceitável │
|
||||
│ Target: ROI > 3x em 12 meses │
|
||||
└─────────────────────────────────────────────────┘
|
||||
|
||||
┌─────────────────────────────────────────────────┐
|
||||
│ FEASIBILITY (Conseguimos construir?) │
|
||||
├─────────────────────────────────────────────────┤
|
||||
│ ☐ Technical spike completo │
|
||||
│ ☐ Dependencies mapeadas │
|
||||
│ ☐ Resources disponíveis │
|
||||
│ ☐ Timeline realista │
|
||||
│ Risk assessment: Alto/Médio/Baixo │
|
||||
└─────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 2. Prioritization Frameworks
|
||||
|
||||
**A. RICE Score (Recomendado)**
|
||||
|
||||
```
|
||||
Reach × Impact × Confidence
|
||||
Score = ─────────────────────────────
|
||||
Effort
|
||||
|
||||
Reach: Quantos users impactados por período
|
||||
- Ex: 1000 users/quarter, 500 users/month
|
||||
|
||||
Impact: Quanto impacto por user
|
||||
- 3 = Massive impact
|
||||
- 2 = High impact
|
||||
- 1 = Medium impact
|
||||
- 0.5 = Low impact
|
||||
- 0.25 = Minimal impact
|
||||
|
||||
Confidence: Certeza das estimativas
|
||||
- 100% = Dados sólidos
|
||||
- 80% = Boas evidências
|
||||
- 50% = Suposições educadas
|
||||
|
||||
Effort: Person-months para entregar
|
||||
- Ex: 2 person-months, 0.5 person-month
|
||||
```
|
||||
|
||||
**Exemplo Prático:**
|
||||
|
||||
| Feature | Reach | Impact | Confidence | Effort | RICE | Prioridade |
|
||||
|---------|-------|--------|------------|--------|------|------------|
|
||||
| Export PDF | 800/q | 2 | 80% | 1 | 1280 | 🟢 Alta |
|
||||
| Dark mode | 400/q | 0.5 | 100% | 0.5 | 400 | 🟡 Média |
|
||||
| API v2 | 200/q | 3 | 50% | 3 | 100 | 🔴 Baixa |
|
||||
| Search filters | 1000/q | 1 | 80% | 0.5 | 1600 | 🟢 Alta |
|
||||
|
||||
**B. MoSCoW Method**
|
||||
|
||||
```
|
||||
MUST have: Crítico para launch (MVP)
|
||||
- Sem isso, produto não funciona
|
||||
- Legal/compliance obrigatório
|
||||
- Blocker absoluto
|
||||
|
||||
SHOULD have: Importante mas não crítico
|
||||
- Melhora significativamente a experiência
|
||||
- Workaround existe
|
||||
- Pode ser adiado 1 sprint
|
||||
|
||||
COULD have: Nice to have
|
||||
- Pequena melhoria
|
||||
- Se sobrar tempo
|
||||
- Low effort/low impact
|
||||
|
||||
WON'T have (agora): Fora de scope
|
||||
- Para próxima versão
|
||||
- Não alinhado com objectivo actual
|
||||
```
|
||||
|
||||
**C. Value vs Effort Matrix**
|
||||
|
||||
```
|
||||
│ HIGH VALUE
|
||||
│
|
||||
II │ I
|
||||
Quick │ Big
|
||||
Wins │ Bets
|
||||
(DO) │ (PLAN)
|
||||
─────────┼─────────
|
||||
III │ IV
|
||||
Fill │ Money
|
||||
Ins │ Pit
|
||||
(LATER) │ (AVOID)
|
||||
│
|
||||
│ LOW VALUE
|
||||
LOW EFFORT → HIGH EFFORT
|
||||
```
|
||||
|
||||
### 3. Roadmap Planning
|
||||
|
||||
**Template Quadrimestral:**
|
||||
|
||||
```markdown
|
||||
# Product Roadmap Q1-Q3 2026
|
||||
|
||||
## Q1 (Jan-Abr): Foundation
|
||||
**Theme:** Stabilize core + basic integrations
|
||||
**Goal:** 100 active users, NPS > 40
|
||||
|
||||
### Epic 1: Core Functionality Polish
|
||||
- [ ] Performance optimization (< 2s load)
|
||||
- [ ] Mobile responsive
|
||||
- [ ] Error handling robusto
|
||||
|
||||
### Epic 2: Basic Integrations
|
||||
- [ ] Slack notifications
|
||||
- [ ] Google Calendar sync
|
||||
- [ ] Email templates
|
||||
|
||||
**Milestone:** MVP Launch (31 Mar)
|
||||
**Success Metrics:**
|
||||
- 50 signups/week
|
||||
- 40% activation rate
|
||||
- < 10% churn
|
||||
|
||||
---
|
||||
|
||||
## Q2 (Mai-Ago): Growth
|
||||
**Theme:** Expand features + virality
|
||||
**Goal:** 500 active users, NPS > 50
|
||||
|
||||
### Epic 3: Collaboration Features
|
||||
- [ ] Team workspaces
|
||||
- [ ] Comments & mentions
|
||||
- [ ] Activity feed
|
||||
|
||||
### Epic 4: Growth Loops
|
||||
- [ ] Invite system (referral)
|
||||
- [ ] Public templates gallery
|
||||
- [ ] Embeddable widgets
|
||||
|
||||
**Milestone:** Product-Market Fit (31 Ago)
|
||||
**Success Metrics:**
|
||||
- 1000 signups total
|
||||
- 50% M1 retention
|
||||
- NRR > 100%
|
||||
|
||||
---
|
||||
|
||||
## Q3 (Set-Dez): Scale
|
||||
**Theme:** Enterprise readiness
|
||||
**Goal:** 2000 active users, ARR > 100k€
|
||||
|
||||
### Epic 5: Enterprise Features
|
||||
- [ ] SSO/SAML
|
||||
- [ ] Advanced permissions
|
||||
- [ ] Audit logs
|
||||
- [ ] Custom branding
|
||||
|
||||
### Epic 6: API & Integrations
|
||||
- [ ] Public API v1
|
||||
- [ ] Zapier integration
|
||||
- [ ] Webhooks
|
||||
|
||||
**Milestone:** Enterprise Ready (31 Dez)
|
||||
**Success Metrics:**
|
||||
- 5 enterprise clients (>100€/mês)
|
||||
- API adoption > 20%
|
||||
- Support tickets < 5/100 users
|
||||
```
|
||||
|
||||
### 4. User Stories & Acceptance Criteria
|
||||
|
||||
**Template:**
|
||||
|
||||
```markdown
|
||||
## US-123: Export dashboard to PDF
|
||||
|
||||
### User Story
|
||||
Como [Product Manager]
|
||||
Quero [exportar dashboard para PDF com branding personalizado]
|
||||
Para que [possa partilhar relatórios profissionais com stakeholders externos]
|
||||
|
||||
### Context
|
||||
- Users pedem isto em 60% dos support tickets
|
||||
- Concorrentes já têm (Competitor A, B)
|
||||
- Workaround actual: screenshots (não profissional)
|
||||
|
||||
### Acceptance Criteria
|
||||
Given [estou no dashboard com dados carregados]
|
||||
When [clico em "Export PDF"]
|
||||
Then [sistema gera PDF em < 5s com:
|
||||
- Logo da empresa
|
||||
- Data do relatório
|
||||
- Todos os gráficos (vectorial)
|
||||
- Tabela de dados resumida
|
||||
- Footer com marca d'água Descomplicar]
|
||||
|
||||
And [recebo notificação quando PDF pronto]
|
||||
And [posso fazer download ou enviar por email]
|
||||
|
||||
### Edge Cases
|
||||
- [ ] Dashboard sem dados → mostrar "No data" no PDF
|
||||
- [ ] Dashboard com 100+ items → paginar automaticamente
|
||||
- [ ] Logo não carregado → usar placeholder
|
||||
|
||||
### Definition of Done
|
||||
- [ ] Código completo e reviewed
|
||||
- [ ] Testes unitários (> 80% coverage)
|
||||
- [ ] Testes E2E (happy path + edge cases)
|
||||
- [ ] Documentação API actualizada
|
||||
- [ ] Changelog entry
|
||||
- [ ] Deployed to staging
|
||||
- [ ] QA sign-off
|
||||
- [ ] Product Manager review
|
||||
|
||||
### Effort Estimate
|
||||
Story Points: 5 (Fibonacci: 1, 2, 3, 5, 8, 13)
|
||||
Dev: 2 days
|
||||
QA: 0.5 days
|
||||
Total: 2.5 days
|
||||
```
|
||||
|
||||
### 5. Sprint Planning
|
||||
|
||||
**Template Sprint (2 semanas):**
|
||||
|
||||
```markdown
|
||||
# Sprint 23 (3-14 Fev 2026)
|
||||
|
||||
## Sprint Goal
|
||||
"Users podem exportar dashboards profissionais e partilhar com stakeholders"
|
||||
|
||||
## Team Capacity
|
||||
- 3 developers × 8 days = 24 person-days
|
||||
- Velocity média: 25 story points/sprint
|
||||
- Buffer para bugs/support: 20% → 20 SP disponíveis
|
||||
|
||||
## Committed Stories
|
||||
|
||||
### 🎯 Must Have (MVP sprint)
|
||||
- [ ] US-123: Export PDF (5 SP) - @dev1
|
||||
- [ ] US-124: Email sharing (3 SP) - @dev2
|
||||
- [ ] US-125: Custom branding settings (3 SP) - @dev3
|
||||
|
||||
### 🚀 Should Have (se tempo)
|
||||
- [ ] US-126: Schedule exports (5 SP)
|
||||
- [ ] US-127: Export templates (3 SP)
|
||||
|
||||
### 🐛 Bugs Críticos
|
||||
- [ ] BUG-45: Login timeout (2 SP) - @dev1
|
||||
|
||||
**Total Committed:** 13 SP
|
||||
**Stretch Goals:** 8 SP
|
||||
**Total Possível:** 21 SP
|
||||
|
||||
## Definition of Done (Sprint)
|
||||
- [ ] Todas as US committed DONE
|
||||
- [ ] Zero bugs críticos open
|
||||
- [ ] Test coverage > 80%
|
||||
- [ ] Docs actualizadas
|
||||
- [ ] Demo preparada para stakeholders
|
||||
- [ ] Retrospective completa
|
||||
|
||||
## Ceremonies
|
||||
- Planning: Seg 3 Fev, 10h-12h
|
||||
- Daily: 9h30 (15 min)
|
||||
- Refinement: Qua 7 Fev, 14h-16h
|
||||
- Review: Sex 14 Fev, 14h-15h
|
||||
- Retrospective: Sex 14 Fev, 15h-16h
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Métricas de Produto
|
||||
|
||||
### Acquisition (AARRR Pirate Metrics)
|
||||
|
||||
| Fase | Métrica | Target |
|
||||
|------|---------|--------|
|
||||
| **Acquisition** | Signups/semana | +20%/mês |
|
||||
| **Activation** | Setup completo | > 40% |
|
||||
| **Retention** | D7 retention | > 30% |
|
||||
| **Revenue** | Conversion free→paid | > 3% |
|
||||
| **Referral** | NPS | > 40 |
|
||||
|
||||
### Product Health
|
||||
|
||||
```
|
||||
Engagement:
|
||||
- DAU/MAU ratio (stickiness): > 20%
|
||||
- Session duration: Sector-dependent
|
||||
- Features usado/session: > 3
|
||||
|
||||
Adoption:
|
||||
- Time to first value: < 10 min
|
||||
- Feature adoption (30 dias): > 30%
|
||||
- Power users (5+ dias/semana): > 10%
|
||||
|
||||
Quality:
|
||||
- Error rate: < 1%
|
||||
- Support tickets/100 users: < 5
|
||||
- CSAT: > 4/5
|
||||
```
|
||||
|
||||
### Outcomes vs Outputs
|
||||
|
||||
```
|
||||
❌ ERRADO (Output-driven):
|
||||
"Lançar 10 features este trimestre"
|
||||
|
||||
✅ CERTO (Outcome-driven):
|
||||
"Aumentar retention D30 de 20% para 35% (via engagement features)"
|
||||
|
||||
Medir:
|
||||
- North Star Metric (ex: DAU/MAU)
|
||||
- Leading indicators (ex: time-to-value)
|
||||
- Lagging indicators (ex: churn)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Consultar Datasets Dify
|
||||
|
||||
**SEMPRE antes de decidir features:**
|
||||
|
||||
| Dataset | ID | Query Exemplo |
|
||||
|---------|----|--------------:|
|
||||
| **Gestão de Processos** | `cae2a27e-f5bc-4d75-8a7a-9f83064f2512` | "product discovery user interviews" |
|
||||
| **Estratégia** | `7d1d1d21-bc05-43d8-ab8f-6b7b90dafc28` | "roadmap planning okr metrics" |
|
||||
| **Gestão de Projectos** | `b10a9418-bcb4-4e4c-b1f8-e64c88bedc04` | "sprint planning scrum velocity" |
|
||||
|
||||
### Como Consultar
|
||||
|
||||
```javascript
|
||||
// Product discovery best practices
|
||||
mcp__dify-kb__dify_kb_retrieve_segments({
|
||||
dataset_id: "cae2a27e-f5bc-4d75-8a7a-9f83064f2512",
|
||||
query: "product discovery validation framework jobs to be done",
|
||||
retrieval_mode: "hybrid_search",
|
||||
top_k: 5
|
||||
});
|
||||
|
||||
// Prioritização e roadmaps
|
||||
mcp__dify-kb__dify_kb_retrieve_segments({
|
||||
dataset_id: "7d1d1d21-bc05-43d8-ab8f-6b7b90dafc28",
|
||||
query: "priorizar features rice moscow roadmap",
|
||||
retrieval_mode: "hybrid_search",
|
||||
top_k: 5
|
||||
});
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## MCPs Utilizados
|
||||
|
||||
```
|
||||
mcp__desk-crm-v3__* # Gestão projectos e tarefas
|
||||
mcp__dify-kb__dify_kb_retrieve_segments # Conhecimento metodologias
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Exemplos de Uso
|
||||
|
||||
### 1. Discovery Nova Feature
|
||||
```
|
||||
/product discovery
|
||||
→ Problem space exploration
|
||||
→ Jobs-to-be-done framework
|
||||
→ Validation checklist (desirability/viability/feasibility)
|
||||
→ Decision: Build / No Build
|
||||
```
|
||||
|
||||
### 2. Prioritização Backlog
|
||||
```
|
||||
/product prioritize
|
||||
→ Lista features candidatas
|
||||
→ RICE scoring interactivo
|
||||
→ Ranking final
|
||||
→ Export para Desk CRM
|
||||
```
|
||||
|
||||
### 3. Roadmap Trimestral
|
||||
```
|
||||
/product roadmap
|
||||
→ Objectivos Q1/Q2/Q3
|
||||
→ Epics e milestones
|
||||
→ Success metrics
|
||||
→ Output Markdown para Obsidian
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Agentes Recomendados
|
||||
|
||||
```javascript
|
||||
// Planeamento produto
|
||||
Task({
|
||||
subagent_type: "software-project-planner",
|
||||
model: "sonnet",
|
||||
prompt: "Create product roadmap Q1 2026. Focus: B2B SaaS collaboration tool."
|
||||
});
|
||||
|
||||
// Research & validation
|
||||
Task({
|
||||
subagent_type: "research-analyst",
|
||||
model: "sonnet",
|
||||
prompt: "Analyse competitor features. Product: [X]. Competitors: [A, B, C]."
|
||||
});
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Instrumentação Automática
|
||||
|
||||
### Query para Gravar (executar no final)
|
||||
|
||||
```sql
|
||||
INSERT INTO tblskill_agent_metrics (
|
||||
type, name, duration_ms, status, staff_id,
|
||||
kb_consulted, kb_cache_hit, tool_calls, project_id
|
||||
) VALUES (
|
||||
'skill', '/product', {DURACAO_MS}, '{STATUS}', 25,
|
||||
{KB_CONSULTADO}, {CACHE_HIT}, {TOOL_CALLS}, {PROJECT_ID}
|
||||
);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**Versão**: 2.0.0 | **Data**: 2026-02-03 | **Autor**: Descomplicar®
|
||||
**Instrumentação**: Activa
|
||||
512
negocio/skills/research/SKILL.md
Normal file
512
negocio/skills/research/SKILL.md
Normal file
@@ -0,0 +1,512 @@
|
||||
---
|
||||
name: research
|
||||
description: Skill especializada em pesquisa profunda e análise competitiva, usando
|
||||
frameworks como SWOT, Porter's Five Forces e PESTEL.
|
||||
author: Descomplicar® Crescimento Digital
|
||||
version: 2.0.0
|
||||
quality_score: 55
|
||||
user_invocable: true
|
||||
desk_task: null
|
||||
allowed-tools: Task, WebFetch
|
||||
---
|
||||
|
||||
# Skill /research - Research & Competitive Analysis
|
||||
|
||||
Skill especializada em pesquisa profunda e análise competitiva, usando frameworks como SWOT, Porter's Five Forces e PESTEL.
|
||||
|
||||
## Sintaxe
|
||||
|
||||
```
|
||||
/research [operacao] [contexto]
|
||||
```
|
||||
|
||||
**Operações:**
|
||||
- `swot` - Análise SWOT (Strengths, Weaknesses, Opportunities, Threats)
|
||||
- `competitive` - Competitive analysis de concorrentes
|
||||
- `market` - Market research e sizing (TAM/SAM/SOM)
|
||||
- `pestel` - Análise macro-ambiental (Political, Economic, Social, Tech, Environmental, Legal)
|
||||
- `porter` - Porter's Five Forces (rivalidade, fornecedores, clientes, entrantes, substitutos)
|
||||
- `due-diligence` - Due diligence completa (M&A, partnership, investment)
|
||||
|
||||
## Quando Usar
|
||||
|
||||
- Análise de mercado para novo produto
|
||||
- Competitive intelligence de concorrentes
|
||||
- Due diligence para aquisição/parceria
|
||||
- Decisão estratégica (entrar num mercado, pivot)
|
||||
- Pitch deck para investidores
|
||||
|
||||
---
|
||||
|
||||
## Protocolo de Execução
|
||||
|
||||
### 1. Definir Scope (SEMPRE começar aqui)
|
||||
|
||||
**Research Brief Template:**
|
||||
|
||||
```markdown
|
||||
# Research Brief: [Título]
|
||||
|
||||
## Pergunta Central
|
||||
[O que queremos descobrir? Ex: "Viabilidade de entrar no mercado PT de e-learning corporativo"]
|
||||
|
||||
## Stakeholders
|
||||
- Decision maker: [Nome, Cargo]
|
||||
- Beneficiários: [Quem usa a research?]
|
||||
- Approval: [Quem aprova?]
|
||||
|
||||
## Timeline
|
||||
- Início: [Data]
|
||||
- Entrega: [Data]
|
||||
- Urgência: Alta / Média / Baixa
|
||||
|
||||
## Âmbito
|
||||
**In scope:**
|
||||
- [X]
|
||||
- [Y]
|
||||
|
||||
**Out of scope:**
|
||||
- [A]
|
||||
- [B]
|
||||
|
||||
## Fontes a Consultar
|
||||
- [ ] Fontes primárias (entrevistas, surveys)
|
||||
- [ ] Fontes secundárias (relatórios, artigos)
|
||||
- [ ] Dados internos (analytics, CRM)
|
||||
- [ ] Dados públicos (websites, LinkedIn)
|
||||
|
||||
## Output Esperado
|
||||
- Formato: Brief (1 pág) / Report (5-10 pág) / Deep Dive (20+ pág)
|
||||
- Entrega: PDF / Apresentação / Dashboard
|
||||
```
|
||||
|
||||
### 2. Recolha de Dados
|
||||
|
||||
**Fontes Primárias (dados originais):**
|
||||
|
||||
```
|
||||
ENTREVISTAS
|
||||
- Stakeholders internos (5-10)
|
||||
- Clientes actuais (10-20)
|
||||
- Prospects (5-10)
|
||||
- Experts da indústria (3-5)
|
||||
|
||||
Template perguntas:
|
||||
1. Maior desafio no [área]?
|
||||
2. Soluções actuais? Satisfação?
|
||||
3. O que faria a solução ideal?
|
||||
4. Quanto vale resolver este problema?
|
||||
5. Quem decide compra? Processo?
|
||||
|
||||
SURVEYS
|
||||
- Amostra: 50-200 respostas (statistical significance)
|
||||
- Duração: < 5 minutos
|
||||
- Incentivo: Sorteio / Report grátis
|
||||
- Plataforma: Typeform / Google Forms
|
||||
```
|
||||
|
||||
**Fontes Secundárias (dados existentes):**
|
||||
|
||||
```
|
||||
RELATÓRIOS INDÚSTRIA
|
||||
- Gartner, Forrester, IDC (paywalled)
|
||||
- Statista, eMarketer (público)
|
||||
- CB Insights (funding, trends)
|
||||
|
||||
DADOS PÚBLICOS
|
||||
- Websites concorrentes (WebFetch)
|
||||
- LinkedIn (empresa, equipa, vagas)
|
||||
- Crunchbase (funding, investors)
|
||||
- G2, Capterra, Trustpilot (reviews)
|
||||
- Google Trends (interesse ao longo tempo)
|
||||
- SimilarWeb (tráfego, sources)
|
||||
|
||||
DADOS INTERNOS
|
||||
- Google Analytics (comportamento users)
|
||||
- Desk CRM (deals ganhos/perdidos)
|
||||
- Support tickets (pain points)
|
||||
- Sales calls recordings (objecções)
|
||||
```
|
||||
|
||||
### 3. Frameworks de Análise
|
||||
|
||||
**A. SWOT Analysis**
|
||||
|
||||
```
|
||||
┌─────────────────────────┬─────────────────────────┐
|
||||
│ STRENGTHS │ WEAKNESSES │
|
||||
│ (Interno +) │ (Interno -) │
|
||||
├─────────────────────────┼─────────────────────────┤
|
||||
│ O que fazemos bem? │ Onde falhamos? │
|
||||
│ Recursos únicos? │ Recursos que faltam? │
|
||||
│ Vantagens competitivas? │ Desvantagens vs compe? │
|
||||
│ │ │
|
||||
│ Ex: │ Ex: │
|
||||
│ • Equipa experiente │ • Marca desconhecida │
|
||||
│ • Tech stack moderna │ • Budget marketing │
|
||||
│ • Clientes satisfeitos │ • Sem sales team │
|
||||
└─────────────────────────┴─────────────────────────┘
|
||||
|
||||
┌─────────────────────────┬─────────────────────────┐
|
||||
│ OPPORTUNITIES │ THREATS │
|
||||
│ (Externo +) │ (Externo -) │
|
||||
├─────────────────────────┼─────────────────────────┤
|
||||
│ Tendências a favor? │ Riscos externos? │
|
||||
│ Gaps no mercado? │ Concorrência? │
|
||||
│ Mudanças regulação? │ Mudanças tecnológicas? │
|
||||
│ │ │
|
||||
│ Ex: │ Ex: │
|
||||
│ • GDPR → procura │ • Big tech entra │
|
||||
│ • Remote work trend │ • Recessão económica │
|
||||
│ • Incentivos PT2030 │ • Open source gratuito │
|
||||
└─────────────────────────┴─────────────────────────┘
|
||||
```
|
||||
|
||||
**Próximos Passos (Estratégias):**
|
||||
```
|
||||
SO (Strengths + Opportunities): Crescimento agressivo
|
||||
ST (Strengths + Threats): Defesa activa
|
||||
WO (Weaknesses + Opportunities): Melhorar para aproveitar
|
||||
WT (Weaknesses + Threats): Dano mínimo / Pivot
|
||||
```
|
||||
|
||||
**B. Porter's Five Forces**
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────┐
|
||||
│ 1. RIVALIDADE ENTRE CONCORRENTES │
|
||||
├─────────────────────────────────────────────────┤
|
||||
│ □ Quantos concorrentes directos? │
|
||||
│ □ Crescimento do mercado? │
|
||||
│ □ Diferenciação possível? │
|
||||
│ □ Switching costs? │
|
||||
│ □ Guerras de preços? │
|
||||
│ │
|
||||
│ Intensidade: ALTA / MÉDIA / BAIXA │
|
||||
└─────────────────────────────────────────────────┘
|
||||
|
||||
┌─────────────────────────────────────────────────┐
|
||||
│ 2. PODER DE NEGOCIAÇÃO DOS FORNECEDORES │
|
||||
├─────────────────────────────────────────────────┤
|
||||
│ □ Poucos fornecedores alternativos? │
|
||||
│ □ Custos de mudança elevados? │
|
||||
│ □ Fornecedor pode integrar verticalmente? │
|
||||
│ │
|
||||
│ Poder: ALTO / MÉDIO / BAIXO │
|
||||
└─────────────────────────────────────────────────┘
|
||||
|
||||
┌─────────────────────────────────────────────────┐
|
||||
│ 3. PODER DE NEGOCIAÇÃO DOS CLIENTES │
|
||||
├─────────────────────────────────────────────────┤
|
||||
│ □ Poucos clientes (concentração)? │
|
||||
│ □ Produto/serviço commoditizado? │
|
||||
│ □ Switching costs baixos? │
|
||||
│ □ Transparência de preços? │
|
||||
│ │
|
||||
│ Poder: ALTO / MÉDIO / BAIXO │
|
||||
└─────────────────────────────────────────────────┘
|
||||
|
||||
┌─────────────────────────────────────────────────┐
|
||||
│ 4. AMEAÇA DE NOVOS ENTRANTES │
|
||||
├─────────────────────────────────────────────────┤
|
||||
│ □ Barreiras à entrada (capital, regulação)? │
|
||||
│ □ Economias de escala necessárias? │
|
||||
│ □ Lealdade à marca existente? │
|
||||
│ □ Acesso a canais de distribuição? │
|
||||
│ │
|
||||
│ Ameaça: ALTA / MÉDIA / BAIXA │
|
||||
└─────────────────────────────────────────────────┘
|
||||
|
||||
┌─────────────────────────────────────────────────┐
|
||||
│ 5. AMEAÇA DE PRODUTOS SUBSTITUTOS │
|
||||
├─────────────────────────────────────────────────┤
|
||||
│ □ Alternativas com melhor price/performance? │
|
||||
│ □ Switching costs baixos para substituto? │
|
||||
│ □ Tendências favor do substituto? │
|
||||
│ │
|
||||
│ Ameaça: ALTA / MÉDIA / BAIXA │
|
||||
└─────────────────────────────────────────────────┘
|
||||
|
||||
CONCLUSÃO:
|
||||
Atractividade da indústria: ALTA / MÉDIA / BAIXA
|
||||
Estratégia recomendada: [...]
|
||||
```
|
||||
|
||||
**C. PESTEL Analysis**
|
||||
|
||||
```
|
||||
POLITICAL (Regulação, Estabilidade)
|
||||
• Regulação GDPR/privacy → [impacto]
|
||||
• Incentivos fiscais I&D → [oportunidade]
|
||||
• Estabilidade governo PT → [risco]
|
||||
|
||||
ECONOMIC (Inflação, Crescimento, Câmbio)
|
||||
• Taxa de juro → [impacto custos financiamento]
|
||||
• Crescimento PIB PT → [procura]
|
||||
• Taxa de desemprego → [talento disponível]
|
||||
|
||||
SOCIAL (Demografia, Tendências, Valores)
|
||||
• Remote work trend → [oportunidade]
|
||||
• Envelhecimento população → [target]
|
||||
• Adopção tecnologia SMBs → [timing]
|
||||
|
||||
TECHNOLOGICAL (Inovação, Disrupção)
|
||||
• AI/ML acessível → [competitive advantage]
|
||||
• Cloud computing → [custos infra]
|
||||
• Open source → [ameaça]
|
||||
|
||||
ENVIRONMENTAL (Sustentabilidade, Clima)
|
||||
• Pressão ESG → [requisito]
|
||||
• Carbon neutrality → [diferenciador]
|
||||
• Green tech → [nicho]
|
||||
|
||||
LEGAL (Legislação, Compliance)
|
||||
• Lei do trabalho remoto → [oportunidade]
|
||||
• Regulação sector X → [barreira entrada]
|
||||
• IP/patents → [protecção]
|
||||
```
|
||||
|
||||
**D. Competitive Analysis Template**
|
||||
|
||||
```markdown
|
||||
# Competitive Analysis: [Concorrente X]
|
||||
|
||||
## Overview
|
||||
- **Website:** [URL]
|
||||
- **Fundação:** [Ano]
|
||||
- **HQ:** [Localização]
|
||||
- **Tamanho:** [Nº employees] - via LinkedIn
|
||||
- **Funding:** [Total raised] - via Crunchbase
|
||||
- **Investors:** [Lista] - via Crunchbase
|
||||
- **Status:** Activo / Estável / Crescendo / Declinando
|
||||
|
||||
## Produto/Serviço
|
||||
**Oferta principal:**
|
||||
- [Produto A]
|
||||
- [Produto B]
|
||||
|
||||
**Pricing:**
|
||||
| Plano | Preço | Features-chave |
|
||||
|-------|-------|----------------|
|
||||
| Free | 0€ | [features] |
|
||||
| Pro | 29€/mês | [features] |
|
||||
| Enterprise | Custom | [features] |
|
||||
|
||||
**Diferenciadores:**
|
||||
- [O que eles fazem bem único]
|
||||
|
||||
**Tech Stack:** (via BuiltWith/Wappalyzer)
|
||||
- Frontend: [React / Vue / etc]
|
||||
- Backend: [Node / Python / etc]
|
||||
- Hosting: [AWS / Vercel / etc]
|
||||
|
||||
## Go-to-Market
|
||||
**Target:** [ICP - Ideal Customer Profile]
|
||||
**Channels:**
|
||||
- SEO: [Organic traffic estimate] - SimilarWeb
|
||||
- PPC: [Ads visíveis] - SpyFu
|
||||
- Content: [Blog posts/mês]
|
||||
- Social: [Followers, engagement]
|
||||
|
||||
**Messaging:**
|
||||
- Headline: "[copiar da homepage]"
|
||||
- Value prop: "[resumir em 1 frase]"
|
||||
|
||||
## Customer Feedback (G2/Capterra/Trustpilot)
|
||||
**Rating:** 4.2/5 (123 reviews)
|
||||
|
||||
**Top Positives:**
|
||||
- [Feature A] mentioned in 60% reviews
|
||||
- [Aspecto B] praised
|
||||
|
||||
**Top Complaints:**
|
||||
- [Bug/limitation C] em 40% reviews
|
||||
- [Pricing] considerado caro
|
||||
|
||||
## Strengths vs Us
|
||||
- ✅ [Vantagem deles]
|
||||
- ✅ [Vantagem deles]
|
||||
|
||||
## Weaknesses vs Us
|
||||
- ❌ [Desvantagem deles]
|
||||
- ❌ [Gap que exploramos]
|
||||
|
||||
## Oportunidades de Diferenciação
|
||||
1. [Feature X que eles não têm]
|
||||
2. [Segmento Y que ignoram]
|
||||
3. [Pricing model Z mais justo]
|
||||
|
||||
## Threat Level
|
||||
🔴 HIGH / 🟡 MEDIUM / 🟢 LOW
|
||||
|
||||
**Reasoning:** [...]
|
||||
```
|
||||
|
||||
### 4. Market Sizing (TAM/SAM/SOM)
|
||||
|
||||
```
|
||||
TAM (Total Addressable Market)
|
||||
"Se tivéssemos 100% do mercado..."
|
||||
Exemplo: Todas as PMEs em Portugal = 1.2M empresas × 500€/ano = 600M€
|
||||
|
||||
SAM (Serviceable Available Market)
|
||||
"Mercado que conseguimos servir realisticamente..."
|
||||
Exemplo: PMEs 10-50 employees em PT = 80k empresas × 500€ = 40M€
|
||||
|
||||
SOM (Serviceable Obtainable Market)
|
||||
"Quota que conseguimos capturar em 3 anos..."
|
||||
Exemplo: 2% do SAM = 800 empresas × 500€ = 400k€
|
||||
|
||||
Validação:
|
||||
□ Bottom-up (clientes × preço)
|
||||
□ Top-down (% de mercado total)
|
||||
□ Value theory (quanto vale resolver problema)
|
||||
```
|
||||
|
||||
### 5. Synthesis & Reporting
|
||||
|
||||
**Executive Summary (1 página):**
|
||||
|
||||
```markdown
|
||||
# Executive Summary: [Título Research]
|
||||
|
||||
## Key Question
|
||||
[Pergunta central]
|
||||
|
||||
## Conclusion (TL;DR)
|
||||
[Recomendação clara: GO / NO-GO / WAIT / PIVOT]
|
||||
|
||||
## Key Findings (Top 3)
|
||||
1. [Finding mais importante]
|
||||
2. [Finding #2]
|
||||
3. [Finding #3]
|
||||
|
||||
## Risks & Mitigations
|
||||
| Risco | Probabilidade | Impacto | Mitigação |
|
||||
|-------|---------------|---------|-----------|
|
||||
| [Risco A] | Alta | Alto | [Como mitigar] |
|
||||
|
||||
## Next Steps
|
||||
1. [Acção imediata]
|
||||
2. [Acção follow-up]
|
||||
3. [Decision point]
|
||||
|
||||
## Resources Needed
|
||||
- Budget: [X]€
|
||||
- Time: [Y] semanas
|
||||
- Team: [Z] pessoas
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Consultar Datasets Dify
|
||||
|
||||
**SEMPRE antes de análise estratégica:**
|
||||
|
||||
| Dataset | ID | Query Exemplo |
|
||||
|---------|----|--------------:|
|
||||
| **Estratégia** | `7d1d1d21-bc05-43d8-ab8f-6b7b90dafc28` | "analise swot porter five forces" |
|
||||
| **Marketing Digital** | `c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24` | "competitive analysis research metodologia" |
|
||||
| **Gestão** | `22799925-8dc5-4a1f-92b9-233468a5048b` | "due diligence checklist decisao" |
|
||||
|
||||
### Como Consultar
|
||||
|
||||
```javascript
|
||||
// Frameworks estratégicos
|
||||
mcp__dify-kb__dify_kb_retrieve_segments({
|
||||
dataset_id: "7d1d1d21-bc05-43d8-ab8f-6b7b90dafc28",
|
||||
query: "swot porter pestel analise estrategica",
|
||||
retrieval_mode: "hybrid_search",
|
||||
top_k: 5
|
||||
});
|
||||
|
||||
// Metodologias research
|
||||
mcp__dify-kb__dify_kb_retrieve_segments({
|
||||
dataset_id: "c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24",
|
||||
query: "research metodologia fontes validacao",
|
||||
retrieval_mode: "hybrid_search",
|
||||
top_k: 5
|
||||
});
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## MCPs Utilizados
|
||||
|
||||
```
|
||||
mcp__web-fetch__* # Análise websites concorrentes
|
||||
mcp__dify-kb__dify_kb_retrieve_segments # Frameworks estratégicos
|
||||
mcp__google-workspace__* # Docs para reports
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Exemplos de Uso
|
||||
|
||||
### 1. Competitive Analysis
|
||||
```
|
||||
/research competitive "Concorrente X"
|
||||
→ Recolha dados (website, reviews, funding)
|
||||
→ Framework análise (SWOT vs nós)
|
||||
→ Report estruturado
|
||||
→ Export para Google Docs
|
||||
```
|
||||
|
||||
### 2. Market Entry Decision
|
||||
```
|
||||
/research swot + pestel + porter
|
||||
→ Análise multi-framework
|
||||
→ Consultadify KB (best practices)
|
||||
→ Risk assessment
|
||||
→ Recomendação GO/NO-GO
|
||||
```
|
||||
|
||||
### 3. Due Diligence Rápida
|
||||
```
|
||||
/research due-diligence "Empresa Y"
|
||||
→ Levantamento financeiro, equipa, produto
|
||||
→ Red flags check
|
||||
→ Valuation estimate
|
||||
→ Report executivo
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Agentes Recomendados
|
||||
|
||||
```javascript
|
||||
// Research profundo
|
||||
Task({
|
||||
subagent_type: "research-analyst",
|
||||
model: "sonnet",
|
||||
prompt: "Full competitive analysis. Sector: [X]. Competitors: [A, B, C]."
|
||||
});
|
||||
|
||||
// Estratégia go-to-market
|
||||
Task({
|
||||
subagent_type: "marketing-planning-expert",
|
||||
model: "sonnet",
|
||||
prompt: "Market entry strategy. Target: [segment]. Research findings: [...]"
|
||||
});
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Instrumentação Automática
|
||||
|
||||
### Query para Gravar (executar no final)
|
||||
|
||||
```sql
|
||||
INSERT INTO tblskill_agent_metrics (
|
||||
type, name, duration_ms, status, staff_id,
|
||||
kb_consulted, kb_cache_hit, tool_calls, project_id
|
||||
) VALUES (
|
||||
'skill', '/research', {DURACAO_MS}, '{STATUS}', 25,
|
||||
{KB_CONSULTADO}, {CACHE_HIT}, {TOOL_CALLS}, {PROJECT_ID}
|
||||
);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**Versão**: 2.0.0 | **Data**: 2026-02-03 | **Autor**: Descomplicar®
|
||||
**Instrumentação**: Activa
|
||||
537
negocio/skills/saas/SKILL.md
Normal file
537
negocio/skills/saas/SKILL.md
Normal file
@@ -0,0 +1,537 @@
|
||||
---
|
||||
name: saas
|
||||
description: Skill especializada em arquitectura e desenvolvimento de produtos SaaS
|
||||
(Software as a Service), cobrindo multi-tenancy, billing, onboarding e métricas.
|
||||
author: Descomplicar® Crescimento Digital
|
||||
version: 2.0.0
|
||||
quality_score: 55
|
||||
user_invocable: true
|
||||
desk_task: null
|
||||
allowed-tools: Task
|
||||
---
|
||||
|
||||
# Skill /saas - SaaS Architecture & Strategy
|
||||
|
||||
Skill especializada em arquitectura e desenvolvimento de produtos SaaS (Software as a Service), cobrindo multi-tenancy, billing, onboarding e métricas.
|
||||
|
||||
## Sintaxe
|
||||
|
||||
```
|
||||
/saas [operacao] [contexto]
|
||||
```
|
||||
|
||||
**Operações:**
|
||||
- `arquitectura` - Design multi-tenant, isolamento dados, escalabilidade
|
||||
- `pricing` - Modelos de preços e packaging de features
|
||||
- `onboarding` - Flow de activação e time-to-value
|
||||
- `billing` - Integração Stripe, trial, upgrades/downgrades
|
||||
- `metricas` - Dashboard MRR, churn, LTV, CAC
|
||||
|
||||
## Quando Usar
|
||||
|
||||
- Planear novo produto SaaS
|
||||
- Migrar aplicação tradicional para SaaS
|
||||
- Optimizar onboarding ou reduzir churn
|
||||
- Implementar billing e subscriptions
|
||||
- Arquitectura multi-tenant
|
||||
|
||||
---
|
||||
|
||||
## Protocolo de Execução
|
||||
|
||||
### 1. Discovery de Produto
|
||||
|
||||
**Questões chave:**
|
||||
```
|
||||
Modelo de negócio:
|
||||
- [ ] B2B, B2C ou B2B2C?
|
||||
- [ ] Self-service ou sales-led?
|
||||
- [ ] PLG (product-led growth)?
|
||||
|
||||
Utilizadores:
|
||||
- [ ] Quantos users por tenant?
|
||||
- [ ] Diferentes roles/permissões?
|
||||
- [ ] Colaboração entre users?
|
||||
|
||||
Dados:
|
||||
- [ ] Volume de dados por tenant?
|
||||
- [ ] Regulamentações (GDPR, HIPAA)?
|
||||
- [ ] Backup e disaster recovery?
|
||||
|
||||
Integrações:
|
||||
- [ ] APIs third-party necessárias?
|
||||
- [ ] SSO/SAML enterprise?
|
||||
- [ ] Webhooks para partners?
|
||||
```
|
||||
|
||||
### 2. Arquitectura Multi-tenant
|
||||
|
||||
**Estratégias de Isolamento:**
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────┐
|
||||
│ 1. DATABASE PER TENANT (Isolamento Máximo) │
|
||||
├─────────────────────────────────────────────────┤
|
||||
│ Prós: Segurança total, restore independente │
|
||||
│ Contras: Custo, complexidade gestão │
|
||||
│ Usar quando: Enterprise, regulamentações │
|
||||
│ Exemplo: AWS RDS + Aurora Serverless │
|
||||
└─────────────────────────────────────────────────┘
|
||||
|
||||
┌─────────────────────────────────────────────────┐
|
||||
│ 2. SCHEMA PER TENANT (Equilíbrio) │
|
||||
├─────────────────────────────────────────────────┤
|
||||
│ Prós: Bom isolamento, gestão simplificada │
|
||||
│ Contras: Limites BD (PostgreSQL ~10k schemas) │
|
||||
│ Usar quando: B2B médio porte │
|
||||
│ Exemplo: PostgreSQL schemas dinâmicos │
|
||||
└─────────────────────────────────────────────────┘
|
||||
|
||||
┌─────────────────────────────────────────────────┐
|
||||
│ 3. SHARED DB + ROW-LEVEL SECURITY (Económico) │
|
||||
├─────────────────────────────────────────────────┤
|
||||
│ Prós: Mais barato, fácil escalar │
|
||||
│ Contras: tenant_id em tudo, RLS obrigatório │
|
||||
│ Usar quando: B2C, SMB self-service │
|
||||
│ Exemplo: PostgreSQL RLS policies │
|
||||
└─────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
**Implementação Row-Level Security (PostgreSQL):**
|
||||
|
||||
```sql
|
||||
-- 1. Adicionar tenant_id a todas as tabelas
|
||||
ALTER TABLE users ADD COLUMN tenant_id UUID NOT NULL;
|
||||
ALTER TABLE projects ADD COLUMN tenant_id UUID NOT NULL;
|
||||
ALTER TABLE documents ADD COLUMN tenant_id UUID NOT NULL;
|
||||
|
||||
-- 2. Activar RLS
|
||||
ALTER TABLE users ENABLE ROW LEVEL SECURITY;
|
||||
ALTER TABLE projects ENABLE ROW LEVEL SECURITY;
|
||||
ALTER TABLE documents ENABLE ROW LEVEL SECURITY;
|
||||
|
||||
-- 3. Criar policy de isolamento
|
||||
CREATE POLICY tenant_isolation ON users
|
||||
USING (tenant_id = current_setting('app.tenant_id')::uuid);
|
||||
|
||||
CREATE POLICY tenant_isolation ON projects
|
||||
USING (tenant_id = current_setting('app.tenant_id')::uuid);
|
||||
|
||||
-- 4. No início de cada request (backend)
|
||||
-- SET app.tenant_id = 'uuid-do-tenant-autenticado';
|
||||
```
|
||||
|
||||
**Checklist Segurança Multi-tenant:**
|
||||
```
|
||||
[ ] tenant_id em TODAS as tabelas
|
||||
[ ] RLS policies activas
|
||||
[ ] Indexes em tenant_id (performance)
|
||||
[ ] Validação tenant_id no auth middleware
|
||||
[ ] Logs de acesso cross-tenant
|
||||
[ ] Testes de isolamento (tenant A não vê tenant B)
|
||||
```
|
||||
|
||||
### 3. Modelos de Pricing
|
||||
|
||||
| Modelo | Descrição | Exemplo | Quando Usar |
|
||||
|--------|-----------|---------|-------------|
|
||||
| **Flat Rate** | Preço fixo mensal | 29€/mês | Simplicidade, previsibilidade |
|
||||
| **Per Seat** | Por utilizador | 10€/user/mês | B2B, equipas |
|
||||
| **Usage Based** | Pay-as-you-go | 0.01€/API call | Variação alta de uso |
|
||||
| **Tiered** | Planos com limites | Free/Pro/Enterprise | Upsell natural |
|
||||
| **Hybrid** | Base + usage | 20€ + 0.001€/email | Receita previsível + escala |
|
||||
|
||||
**Recomendação Descomplicar:**
|
||||
```
|
||||
B2B (equipas 5-50 users): PER SEAT
|
||||
B2C (individual): TIERED
|
||||
API/Infra (desenvolvedores): USAGE BASED
|
||||
SaaS tradicional: HYBRID (base + usage caps)
|
||||
```
|
||||
|
||||
**Exemplo de Tiers:**
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────┐
|
||||
│ FREE 0€/mês │
|
||||
├─────────────────────────────────────────────────┤
|
||||
│ ✓ 1 user │
|
||||
│ ✓ 100 records/mês │
|
||||
│ ✓ 1 GB storage │
|
||||
│ ✗ Integrações │
|
||||
│ ✗ API access │
|
||||
│ ✗ Suporte prioritário │
|
||||
└─────────────────────────────────────────────────┘
|
||||
|
||||
┌─────────────────────────────────────────────────┐
|
||||
│ PRO 29€/mês │
|
||||
├─────────────────────────────────────────────────┤
|
||||
│ ✓ 5 users │
|
||||
│ ✓ 10.000 records/mês │
|
||||
│ ✓ 50 GB storage │
|
||||
│ ✓ Integrações básicas │
|
||||
│ ✓ API access (10k calls/mês) │
|
||||
│ ✓ Email support (24h) │
|
||||
└─────────────────────────────────────────────────┘
|
||||
|
||||
┌─────────────────────────────────────────────────┐
|
||||
│ ENTERPRISE Custom │
|
||||
├─────────────────────────────────────────────────┤
|
||||
│ ✓ Users ilimitados │
|
||||
│ ✓ Records ilimitados │
|
||||
│ ✓ Storage dedicado │
|
||||
│ ✓ Todas as integrações │
|
||||
│ ✓ API ilimitado │
|
||||
│ ✓ Suporte 24/7 + Account Manager │
|
||||
│ ✓ SSO/SAML │
|
||||
│ ✓ SLA 99.9% │
|
||||
└─────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 4. Stack Técnica Recomendada
|
||||
|
||||
**Frontend:**
|
||||
```
|
||||
Framework: Next.js 14+ (App Router)
|
||||
Styling: Tailwind CSS + shadcn/ui
|
||||
State: Zustand / Jotai
|
||||
Forms: React Hook Form + Zod
|
||||
```
|
||||
|
||||
**Backend:**
|
||||
```
|
||||
API: Next.js API Routes / tRPC
|
||||
Database: PostgreSQL (Supabase / Railway)
|
||||
ORM: Prisma
|
||||
Queue: BullMQ / Inngest (background jobs)
|
||||
Cache: Redis (Upstash)
|
||||
```
|
||||
|
||||
**Auth & Billing:**
|
||||
```
|
||||
Auth: Clerk / Auth0 / NextAuth.js
|
||||
Billing: Stripe Billing (subscriptions)
|
||||
Email: Resend / SendGrid
|
||||
Analytics: PostHog / Mixpanel
|
||||
```
|
||||
|
||||
**Hosting:**
|
||||
```
|
||||
Frontend: Vercel
|
||||
Backend: Railway / Fly.io
|
||||
Database: Supabase / Neon
|
||||
CDN: Cloudflare
|
||||
```
|
||||
|
||||
### 5. Onboarding Flow (Time-to-Value)
|
||||
|
||||
**Objectivo:** Levar user de signup a "aha moment" em < 5 minutos.
|
||||
|
||||
```
|
||||
┌────────────────────────────────────────────────┐
|
||||
│ 1. SIGNUP │
|
||||
│ Email + Password (ou OAuth Google) │
|
||||
│ ↓ < 30 segundos │
|
||||
├────────────────────────────────────────────────┤
|
||||
│ 2. WELCOME │
|
||||
│ Vídeo 30s: "O que vais conseguir" │
|
||||
│ ↓ Skip disponível │
|
||||
├────────────────────────────────────────────────┤
|
||||
│ 3. QUICK SETUP │
|
||||
│ 3-5 campos essenciais (restantes opcional) │
|
||||
│ Progress bar: "2/3 completo" │
|
||||
│ ↓ < 2 minutos │
|
||||
├────────────────────────────────────────────────┤
|
||||
│ 4. FIRST ACTION │
|
||||
│ Criar primeiro [projecto/documento/etc] │
|
||||
│ Usar template pré-preenchido │
|
||||
│ ↓ < 2 minutos │
|
||||
├────────────────────────────────────────────────┤
|
||||
│ 5. AHA MOMENT │
|
||||
│ Ver resultado imediato (export, share, etc) │
|
||||
│ Celebrar: "Parabéns! Criaste o teu 1º X" │
|
||||
│ ↓ │
|
||||
├────────────────────────────────────────────────┤
|
||||
│ 6. NEXT STEPS │
|
||||
│ Checklist guiada: "3 passos para dominar" │
|
||||
│ Invite team, integração, etc │
|
||||
└────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
**Métricas de Onboarding:**
|
||||
```
|
||||
- Signup → Email verified: > 80%
|
||||
- Email verified → Setup complete: > 60%
|
||||
- Setup → First action: > 70%
|
||||
- First action → Aha moment: > 90%
|
||||
- Activation rate (signup → aha): > 40%
|
||||
```
|
||||
|
||||
### 6. Billing com Stripe
|
||||
|
||||
**Setup Básico:**
|
||||
|
||||
```typescript
|
||||
// 1. Criar produtos e preços no Stripe Dashboard
|
||||
// Free: price_free (0€)
|
||||
// Pro: price_pro (29€/mês)
|
||||
// Enterprise: price_enterprise (custom)
|
||||
|
||||
// 2. Criar subscription no signup
|
||||
import Stripe from 'stripe';
|
||||
const stripe = new Stripe(process.env.STRIPE_SECRET_KEY);
|
||||
|
||||
const subscription = await stripe.subscriptions.create({
|
||||
customer: customerId,
|
||||
items: [{ price: 'price_free' }],
|
||||
trial_period_days: 14, // Trial 14 dias
|
||||
payment_behavior: 'default_incomplete',
|
||||
expand: ['latest_invoice.payment_intent']
|
||||
});
|
||||
|
||||
// 3. Webhooks para sincronizar estado
|
||||
// - customer.subscription.created
|
||||
// - customer.subscription.updated
|
||||
// - customer.subscription.deleted
|
||||
// - invoice.payment_succeeded
|
||||
// - invoice.payment_failed
|
||||
|
||||
// 4. Verificar feature access
|
||||
const canUseFeature = (user: User, feature: string) => {
|
||||
if (user.subscription.status !== 'active') return false;
|
||||
return PLAN_FEATURES[user.subscription.plan].includes(feature);
|
||||
};
|
||||
```
|
||||
|
||||
**Trial → Paid Conversion:**
|
||||
```
|
||||
Trial 14 dias (sem cartão)
|
||||
│
|
||||
├─ Dia 7: Email "Metade do trial"
|
||||
├─ Dia 12: Email "2 dias restantes + valor criado"
|
||||
├─ Dia 14: Soft paywall (pedir cartão)
|
||||
│
|
||||
▼
|
||||
Converteu? → Pro (29€/mês)
|
||||
Não converteu? → Free (downgrade features)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Métricas SaaS (KPIs)
|
||||
|
||||
### Receita
|
||||
|
||||
| Métrica | Fórmula | Target |
|
||||
|---------|---------|--------|
|
||||
| **MRR** | Monthly Recurring Revenue | Crescimento mês/mês |
|
||||
| **ARR** | MRR × 12 | > 100k€ para sustainable |
|
||||
| **ARPU** | MRR / Total customers | Sector-dependent |
|
||||
| **NRR** | (MRR início + expansion - churn - contraction) / MRR início | > 100% |
|
||||
|
||||
### Crescimento
|
||||
|
||||
| Métrica | Fórmula | Target |
|
||||
|---------|---------|--------|
|
||||
| **New MRR** | Novos clientes × preço médio | +20%/mês (early) |
|
||||
| **Expansion MRR** | Upsells + Add-ons | > 10% do MRR |
|
||||
| **Churn MRR** | Cancelamentos valor | < 5%/mês |
|
||||
|
||||
### Aquisição
|
||||
|
||||
| Métrica | Fórmula | Target |
|
||||
|---------|---------|--------|
|
||||
| **CAC** | Custo marketing+sales / Novos clientes | < 1/3 LTV |
|
||||
| **LTV** | ARPU × (1 / Churn Rate) - CAC | > 3× CAC |
|
||||
| **Payback Period** | CAC / ARPU | < 12 meses |
|
||||
|
||||
### Produto
|
||||
|
||||
| Métrica | Target |
|
||||
|---------|--------|
|
||||
| **Activation Rate** | > 40% (signup → aha moment) |
|
||||
| **DAU/MAU** | > 20% (stickiness) |
|
||||
| **Time to Value** | < 10 minutos |
|
||||
| **Feature Adoption** | > 30% users usam feature nova (30 dias) |
|
||||
|
||||
### Retenção
|
||||
|
||||
| Métrica | Fórmula | Target |
|
||||
|---------|---------|--------|
|
||||
| **Logo Churn** | Clientes cancelaram / Total | < 5%/mês |
|
||||
| **Revenue Churn** | MRR perdido / MRR total | < 5%/mês |
|
||||
| **Cohort Retention** | Clientes mês X activos em X+6 | > 50% |
|
||||
|
||||
---
|
||||
|
||||
## Feature Flags por Plano
|
||||
|
||||
```typescript
|
||||
// config/features.ts
|
||||
export const PLAN_FEATURES = {
|
||||
free: [
|
||||
'basic_dashboard',
|
||||
'limited_records',
|
||||
'email_support'
|
||||
],
|
||||
pro: [
|
||||
'basic_dashboard',
|
||||
'unlimited_records',
|
||||
'api_access',
|
||||
'integrations_basic',
|
||||
'priority_support',
|
||||
'export_csv'
|
||||
],
|
||||
enterprise: [
|
||||
'*', // todas as features
|
||||
'sso_saml',
|
||||
'audit_logs',
|
||||
'custom_domain',
|
||||
'dedicated_support',
|
||||
'sla_guarantee'
|
||||
]
|
||||
};
|
||||
|
||||
// middleware verificação
|
||||
export function requireFeature(feature: string) {
|
||||
return async (req, res, next) => {
|
||||
const user = req.user;
|
||||
const plan = user.subscription.plan;
|
||||
|
||||
if (!PLAN_FEATURES[plan].includes(feature) &&
|
||||
!PLAN_FEATURES[plan].includes('*')) {
|
||||
return res.status(403).json({
|
||||
error: 'Upgrade required',
|
||||
feature: feature,
|
||||
current_plan: plan,
|
||||
upgrade_to: 'pro'
|
||||
});
|
||||
}
|
||||
|
||||
next();
|
||||
};
|
||||
}
|
||||
|
||||
// Uso no route
|
||||
app.get('/api/export',
|
||||
requireAuth,
|
||||
requireFeature('export_csv'),
|
||||
async (req, res) => {
|
||||
// ...
|
||||
}
|
||||
);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Consultar Datasets Dify
|
||||
|
||||
**SEMPRE antes de arquitectar solução:**
|
||||
|
||||
| Dataset | ID | Query Exemplo |
|
||||
|---------|----|--------------:|
|
||||
| **Estratégia** | `7d1d1d21-bc05-43d8-ab8f-6b7b90dafc28` | "saas pricing modelo subscription" |
|
||||
| **Gestão** | `22799925-8dc5-4a1f-92b9-233468a5048b` | "metricas saas mrr churn ltv" |
|
||||
| **Desenvolvimento Software** | `52c29c6b-7f76-42fe-ad4b-0bf8ff05cc73` | "arquitectura multitenancy postgresql" |
|
||||
|
||||
### Como Consultar
|
||||
|
||||
```javascript
|
||||
// Modelos de pricing
|
||||
mcp__dify-kb__dify_kb_retrieve_segments({
|
||||
dataset_id: "7d1d1d21-bc05-43d8-ab8f-6b7b90dafc28",
|
||||
query: "saas pricing tiers feature packaging",
|
||||
retrieval_mode: "hybrid_search",
|
||||
top_k: 5
|
||||
});
|
||||
|
||||
// Métricas e KPIs
|
||||
mcp__dify-kb__dify_kb_retrieve_segments({
|
||||
dataset_id: "22799925-8dc5-4a1f-92b9-233468a5048b",
|
||||
query: "metricas saas cohort retention churn",
|
||||
retrieval_mode: "hybrid_search",
|
||||
top_k: 5
|
||||
});
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## MCPs Utilizados
|
||||
|
||||
```
|
||||
mcp__desk-crm-v3__* # Gestão projectos SaaS
|
||||
mcp__dify-kb__dify_kb_retrieve_segments # Conhecimento estratégico
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Exemplos de Uso
|
||||
|
||||
### 1. Planeamento Novo SaaS
|
||||
```
|
||||
/saas arquitectura
|
||||
→ Discovery interactivo
|
||||
→ Consulta Dify KB (best practices)
|
||||
→ Recomendação multi-tenancy
|
||||
→ Stack técnica
|
||||
→ Roadmap MVP
|
||||
```
|
||||
|
||||
### 2. Optimização Pricing
|
||||
```
|
||||
/saas pricing
|
||||
→ Análise competidores
|
||||
→ Modelação LTV/CAC
|
||||
→ Proposta tiers
|
||||
→ Feature packaging
|
||||
```
|
||||
|
||||
### 3. Dashboard Métricas
|
||||
```
|
||||
/saas metricas
|
||||
→ Definir KPIs prioritários
|
||||
→ Queries SQL para MRR/Churn
|
||||
→ Setup PostHog/Mixpanel
|
||||
→ Dashboards Grafana
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Agentes Recomendados
|
||||
|
||||
```javascript
|
||||
// Arquitectura técnica
|
||||
Task({
|
||||
subagent_type: "software-architect",
|
||||
model: "sonnet",
|
||||
prompt: "Design multi-tenant SaaS architecture. PostgreSQL RLS + Next.js."
|
||||
});
|
||||
|
||||
// Estratégia produto
|
||||
Task({
|
||||
subagent_type: "software-project-planner",
|
||||
model: "sonnet",
|
||||
prompt: "SaaS onboarding flow. Time-to-value < 5min. B2B productivity tool."
|
||||
});
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Instrumentação Automática
|
||||
|
||||
### Query para Gravar (executar no final)
|
||||
|
||||
```sql
|
||||
INSERT INTO tblskill_agent_metrics (
|
||||
type, name, duration_ms, status, staff_id,
|
||||
kb_consulted, kb_cache_hit, tool_calls, project_id
|
||||
) VALUES (
|
||||
'skill', '/saas', {DURACAO_MS}, '{STATUS}', 25,
|
||||
{KB_CONSULTADO}, {CACHE_HIT}, {TOOL_CALLS}, {PROJECT_ID}
|
||||
);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**Versão**: 2.0.0 | **Data**: 2026-02-03 | **Autor**: Descomplicar®
|
||||
**Instrumentação**: Activa
|
||||
Reference in New Issue
Block a user