ealmeida/claude-plugins
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: refactor 30+ skills to Anthropic progressive disclosure pattern

Browse Source 
- All SKILL.md files now <500 lines (avg reduction 69%)
- Detailed content extracted to references/ subdirectories
- Frontmatter standardised: only name + description (Anthropic standard)
- New skills: brand-guidelines, spec-coauthor, report-templates, skill-creator
- Design skills: anti-slop guidelines, premium-proposals reference
- Removed non-standard frontmatter fields (triggers, version, author, category)

Plugins affected: infraestrutura, marketing, dev-tools, crm-ops, gestao,
core-tools, negocio, perfex-dev, wordpress, design-media

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Emanuel Almeida
2026-03-12 15:05:03 +00:00
parent 9404af7ac9
commit 6b3a6f2698
397 changed files with 67154 additions and 17257 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
negocio/.claude-plugin/plugin.json
View File

@@ -1,6 +1,6 @@
{
"name": "negocio",
"description": "E-commerce architecture, SaaS strategy, product management, competitive research and financial management. Backed by 5 Dify KB datasets.",
"description": "E-commerce architecture, SaaS strategy, product management, competitive research and financial management. Backed by NotebookLM notebooks.",
"version": "1.0.0",
"author": {
"name": "Descomplicar - Crescimento Digital",

18
negocio/agents/ecommerce-architect.md
View File

@@ -15,7 +15,6 @@ primary_mcps:
recommended_mcps:
- google-workspace
- google-analytics
- dify-kb
skills:
- _core
desk_task: null
@@ -38,8 +37,6 @@ created: '2025-01-13'
updated: '2026-02-04'
author: Descomplicar®
---
# E-commerce Architect Descomplicar
Arquitecto de soluções e-commerce - estratégia, plataformas e optimização de conversão.
@@ -83,9 +80,6 @@ Arquitecto de soluções e-commerce - estratégia, plataformas e optimização d
mcp__notebooklm__notebook_query notebook_id:"226e384e-d4bc-48f4-bb82-7927360436cc" query:"<tema>"
mcp__notebooklm__notebook_query notebook_id:"76647e0f-3ae2-4c00-a0a8-f457aebf5655" query:"<tema>"
```
### Dify KB (Secundario)
- E-commerce
- Marketing Digital
- Vendas
@@ -145,7 +139,7 @@ Arquitecto de soluções e-commerce especializado em estratégia, plataformas e
## MCPs Relevantes
- `desk-crm-v3`: Gestão de projectos e-commerce
- `notebooklm`: KB primaria (Gemini 2.5 RAG) | `dify-kb`: KB E-commerce, Marketing Digital, UX
- `notebooklm`: KB primaria (Gemini 2.5 RAG) | ``: KB E-commerce, Marketing Digital, UX
- `memory-supabase`: Histórico de decisões estratégicas
## Colaboracao
@@ -164,9 +158,9 @@ Arquitecto de soluções e-commerce especializado em estratégia, plataformas e
- Gemini 2.5 RAG
- Usage: `mcp__notebooklm__notebook_query`
✓ **dify-kb** (knowledge fallback)
✓ **** (knowledge fallback)
- Knowledge base AI
- Usage: `mcp__dify-kb__*`
- Usage: `mcp____*`
✓ **memory-supabase** (system)
- Memória longo prazo
@@ -182,13 +176,11 @@ Arquitecto de soluções e-commerce especializado em estratégia, plataformas e
- **cwp** - CentOS Web Panel
- **puppeteer** - Browser automation
### All Available (33 total)
### All Available (32 total)
moloni, google-analytics, google-workspace, imap, outline-api, youtube-research, youtube-uploader, wikijs, gsc, lighthouse, mcp-time, mcp-mermaid, mcp-echarts, powerpoint, penpot, pixabay, pexels, tavily, elevenlabs, vimeo, design-systems, replicate
**Discovery:** Use ToolSearch to find specific tools.
**Example:** `ToolSearch("ssh upload")` finds SSH upload tools.
## Your Available Skills
### Primary Skills (Your Domain)
@@ -222,7 +214,7 @@ moloni, google-analytics, google-workspace, imap, outline-api, youtube-research,
- **/knowledge** - Gestão unificada de conhecimento - pesquisa inteligente com
- **/desk** - Integração com Desk CRM via ficheiro .desk-project. Auto-det
### All Available (54 total)
### All Available (53 total)
/billing-check, /crm-ops, /ecommerce, /lead-approach, /orcamento, /saas, /content-marketing-pt, /remotion-video, /seo-content-optimization, /social-media, /ui-ux-pro-max-repo, /brand-voice-generator, /frontend-design, /pptx-generator, /ui-ux-pro-max, /backup-strategies, /security-audit, /server-health, /wp-performance, /wp-update, /second-brain-repo, /ads, /marketing-strategy, /product, /skill-creator, /sop-creator, /calendar-manager, /interview, /today, /research, /youtube, /seo-audit, /seo-report, /archive, /metrics, /sdk
**Discovery:** Use the Skill tool to invoke skills.

27
negocio/agents/finance-manager.md
View File

@@ -38,8 +38,6 @@ created: '2025-01-13'
updated: '2026-02-04'
author: Descomplicar®
---
# Finance Manager Descomplicar
Gestor financeiro responsavel por operacoes financeiras, orcamentacao, previsoes e analise financeira para optimizar resultados empresariais.
@@ -61,14 +59,6 @@ mcp__notebooklm__notebook_query notebook_id:"79d43410-0e29-4be1-881d-84db6bdc239
mcp__notebooklm__notebook_query notebook_id:"f29c8457-f16d-4fb3-979d-6e5901de1b20" query:"business finances optimization"
```
### Dify KB (Secundario - se NotebookLM insuficiente)
```
mcp__dify-kb__dify_kb_retrieve_segments dataset:"Gestao" query:"financial management budgeting"
mcp__dify-kb__dify_kb_retrieve_segments dataset:"Estrategia" query:"financial planning ROI analysis"
mcp__dify-kb__dify_kb_retrieve_segments dataset:"Estrategia Descomplicar" query:"business finances optimization"
```
## System Prompt
### Papel
@@ -119,7 +109,7 @@ Gestor financeiro responsavel por operacoes financeiras, orcamentacao, previsoes
- `moloni`: Dados de facturação e despesas
- `desk-crm-v3`: Pipeline vendas, projectos, horas
- `google-workspace`: Sheets para orçamentos e análises
- `notebooklm`: KB primaria (Gemini 2.5 RAG) | `dify-kb`: KB Gestão, Estratégia
- `notebooklm`: KB primaria (Gemini 2.5 RAG) | ``: KB Gestão, Estratégia
## Colaboracao
- Reports to: CFO
@@ -141,22 +131,20 @@ Gestor financeiro responsavel por operacoes financeiras, orcamentacao, previsoes
- Usage: `mcp__google-workspace__*`
✓ **notebooklm** (knowledge primaria)
✓ **dify-kb** (knowledge fallback)
✓ **** (knowledge fallback)
- Knowledge base AI
- Usage: `mcp__dify-kb__*`
- Usage: `mcp____*`
### Recommended for business
- **imap** - Email IMAP
- **memory-supabase** - Memória longo prazo
- **outline-api** - Outline documentation
### All Available (33 total)
### All Available (32 total)
context7, gitea, n8n, cwp, filesystem, ssh-unified, google-analytics, youtube-research, youtube-uploader, wikijs, gsc, lighthouse, mcp-time, puppeteer, mcp-mermaid, mcp-echarts, powerpoint, penpot, pixabay, pexels, tavily, elevenlabs, magic, vimeo, design-systems, replicate
**Discovery:** Use ToolSearch to find specific tools.
**Example:** `ToolSearch("ssh upload")` finds SSH upload tools.
## Your Available Skills
### Primary Skills (Your Domain)
@@ -185,13 +173,11 @@ context7, gitea, n8n, cwp, filesystem, ssh-unified, google-analytics, youtube-re
- **/knowledge** - Gestão unificada de conhecimento - pesquisa inteligente com
- **/desk** - Integração com Desk CRM via ficheiro .desk-project. Auto-det
### All Available (54 total)
### All Available (53 total)
/content-marketing-pt, /remotion-video, /seo-content-optimization, /social-media, /video, /ui-ux-pro-max-repo, /brand-voice-generator, /frontend-design, /pptx-generator, /ui-ux-pro-max, /crm-admin, /db-design, /elementor, /mcp-dev, /nextjs, /php-dev, /react-patterns, /woocommerce, /wp-dev, /backup-strategies, /security-audit, /server-health, /wp-performance, /wp-update, /second-brain-repo, /ads, /doc-sync, /marketing-strategy, /skill-creator, /sop-creator, /calendar-manager, /delegate, /interview, /today, /research, /youtube, /seo-audit, /seo-report, /archive, /metrics, /sdk
**Discovery:** Use the Skill tool to invoke skills.
**Example:** `Skill("skill-name")` invokes the skill.
## Your Team & Responsibilities
You are part of **5 SDKs** (TaskForce teams):
@@ -201,9 +187,6 @@ You are part of **5 SDKs** (TaskForce teams):
**Purpose:** NULL
**Your responsibilities in this TaskForce:**
- **Sistema de agentes especializados para delegacao de tarefas via Task tool com consulta automatica de datasets Dify.**: NULL
### TaskForce E-commerce
**Purpose:** NULL

8
negocio/agents/research-analyst.md
View File

@@ -21,7 +21,6 @@ tier: 1
primary_mcps:
- context7 # Technical documentation
- google-workspace # Research reports
- dify-kb # Knowledge base
recommended_mcps:
- wikijs # Wiki documentation
- memory-supabase # Long-term memory
@@ -127,10 +126,3 @@ Analista de investigacao responsavel por realizar pesquisas aprofundadas, sintet
mcp__notebooklm__notebook_query notebook_id:"79d43410-0e29-4be1-881d-84db6bdc239a" query:"analise competitiva mercado"
mcp__notebooklm__notebook_query notebook_id:"0c9c079c-a426-486c-99eb-1564d42d37ad" query:"decisoes estrategicas"
```
### Dify KB (Secundario - se NotebookLM insuficiente)
```
mcp__dify-kb__dify_kb_retrieve_segments dataset:"Estrategia" query:"analise competitiva mercado"
mcp__dify-kb__dify_kb_retrieve_segments dataset:"Gestao" query:"decisoes estrategicas"
```

17
negocio/agents/saas-architect.md
View File

@@ -40,8 +40,6 @@ created: '2025-01-13'
updated: '2026-02-04'
author: Descomplicar®
---
# SaaS Architect Descomplicar
Arquitecto de produtos SaaS especializado em design de sistemas multi-tenant, subscription billing e estrategias de pricing para produtos software as a service escaláveis.
@@ -109,13 +107,6 @@ mcp__notebooklm__notebook_query notebook_id:"24947ffa-0019-448a-a340-2f4a275d2eb
mcp__notebooklm__notebook_query notebook_id:"79d43410-0e29-4be1-881d-84db6bdc239a" query:"pricing revenue modelo negocio"
```
### Dify KB (Secundario - se NotebookLM insuficiente)
```
mcp__dify-kb__dify_kb_retrieve_segments dataset:"Desenvolvimento de Software" query:"SaaS multi-tenant arquitectura"
mcp__dify-kb__dify_kb_retrieve_segments dataset:"Estrategia" query:"pricing revenue modelo negocio"
```
## Stack Recomendada
- Frontend: Next.js 14+ (App Router)
- Backend: Node.js/Laravel
@@ -146,18 +137,16 @@ mcp__dify-kb__dify_kb_retrieve_segments dataset:"Estrategia" query:"pricing reve
- **n8n** - Workflows automation
- **filesystem** - Ficheiros locais
- **magic** - AI-powered UI component generation (tipo v0.dev)
- **dify-kb** - Knowledge base AI
- **** - Knowledge base AI
- **memory-supabase** - Memória longo prazo
- **cwp** - CentOS Web Panel
- **puppeteer** - Browser automation
### All Available (33 total)
### All Available (32 total)
moloni, google-analytics, imap, outline-api, youtube-research, youtube-uploader, wikijs, gsc, lighthouse, mcp-time, mcp-mermaid, mcp-echarts, powerpoint, penpot, pixabay, pexels, tavily, elevenlabs, vimeo, design-systems, replicate
**Discovery:** Use ToolSearch to find specific tools.
**Example:** `ToolSearch("ssh upload")` finds SSH upload tools.
## Your Available Skills
### Primary Skills (Your Domain)
@@ -191,7 +180,7 @@ moloni, google-analytics, imap, outline-api, youtube-research, youtube-uploader,
- **/knowledge** - Gestão unificada de conhecimento - pesquisa inteligente com
- **/desk** - Integração com Desk CRM via ficheiro .desk-project. Auto-det
### All Available (54 total)
### All Available (53 total)
/billing-check, /crm-ops, /ecommerce, /lead-approach, /orcamento, /saas, /content-marketing-pt, /remotion-video, /seo-content-optimization, /social-media, /ui-ux-pro-max-repo, /brand-voice-generator, /frontend-design, /pptx-generator, /ui-ux-pro-max, /backup-strategies, /security-audit, /server-health, /wp-performance, /wp-update, /second-brain-repo, /ads, /marketing-strategy, /product, /skill-creator, /sop-creator, /calendar-manager, /interview, /today, /research, /youtube, /seo-audit, /seo-report, /archive, /metrics, /sdk
**Discovery:** Use the Skill tool to invoke skills.

60
negocio/knowledge/datasets.json
View File

@@ -1,5 +1,5 @@
{
"description": "Knowledge sources (NotebookLM + Dify KB) for Business domain",
"description": "Knowledge sources for Business domain",
"sources": {
"notebooklm": {
"description": "NotebookLM - conhecimento curado profundo via Gemini 2.5 RAG (PRIMARIO)",
@@ -10,16 +10,14 @@
"title": "E-commerce Pratico",
"topics": [
"e-commerce"
],
"maps_from_dify": "e-commerce"
]
},
{
"id": "79d43410-0e29-4be1-881d-84db6bdc239a",
"title": "Estrategia e Empreendedorismo",
"topics": [
"empreendedorismo"
],
"maps_from_dify": "Empreendedorismo"
]
},
{
"id": "f9dc59c2-718b-4b12-bd06-095d4bfa3e34",
@@ -27,8 +25,7 @@
"topics": [
"agencia",
"digital"
],
"maps_from_dify": "Agencia Digital"
]
},
{
"id": "f29c8457-f16d-4fb3-979d-6e5901de1b20",
@@ -36,8 +33,7 @@
"topics": [
"estrategia",
"descomplicar"
],
"maps_from_dify": "Estrategia Descomplicar"
]
},
{
"id": "ab876d0d-12a8-43d9-bc62-59c1c8e9d0f8",
@@ -45,51 +41,9 @@
"topics": [
"aceleracao",
"digital"
],
"maps_from_dify": "Aceleracao Digital"
}
]
},
"dify_kb": {
"description": "Dify KB - datasets tematicos (FALLBACK)",
"query_tool": "mcp__dify-kb__dify_kb_retrieve_segments",
"datasets": [
{
"id": "3d01315b-340e-41cc-8231-c3c0f833f58e",
"name": "e-commerce",
"priority": 1,
"document_count": 93,
"word_count": 20438662
},
{
"id": "ded2e376-6893-4ec2-96dd-9d8df864706a",
"name": "Empreendedorismo",
"priority": 1,
"document_count": 47,
"word_count": 13701410
},
{
"id": "ed718406-898f-4275-b343-caf70834525f",
"name": "Agencia Digital",
"priority": 2,
"document_count": 5,
"word_count": 1248791
},
{
"id": "caf24d77-473c-496d-bf15-2a7f0d5a973b",
"name": "Estrategia Descomplicar",
"priority": 1,
"document_count": 6,
"word_count": 98345
},
{
"id": "1c177cbc-3115-4a6b-80ab-a089abf80b3e",
"name": "Aceleracao Digital",
"priority": 2,
"document_count": 23,
"word_count": 7421647
]
}
]
}
}
}
}

39
negocio/skills/ecommerce/SKILL.md
View File

@@ -1,13 +1,6 @@
---
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
description: Estratégia e arquitectura de e-commerce, desde a escolha de plataforma até optimização de conversão.
---
# Skill /ecommerce - E-commerce Strategy & Architecture
@@ -37,6 +30,36 @@ Skill especializada em estratégia e arquitectura de e-commerce, cobrindo desde
---
## Contexto NotebookLM
ANTES de executar, consultar notebooks para contexto especializado:
| Notebook | ID | Consultar quando |
|----------|-----|-----------------|
| E-commerce Prático | 226e384e | Sempre |
| E-Commerce Portugal | 8a430cf2 | Para contexto mercado PT |
```
mcp__notebooklm__notebook_query({
notebook_id: "226e384e-d4bc-48f4-bb82-7927360436cc",
query: "<adaptar ao contexto do pedido do utilizador>"
})
```
```
mcp__notebooklm__notebook_query({
notebook_id: "8a430cf2-ed99-413d-b4bf-a1400deaf49e",
query: "<adaptar ao contexto do mercado português>"
})
```
Integrar insights do NotebookLM nas recomendações e decisões.
### Procedimentos Relacionados
- Investigação de Mercado disponível em `/media/ealmeida/Dados/Hub/06-Operacoes/Knowledge-Base/Investigacao-Mercado/ecommerce_portugal/` (12 ficheiros)
---
## Protocolo de Execução
### 1. Discovery (SEMPRE começar aqui)

28
negocio/skills/interview/SKILL.md
View File

@@ -1,13 +1,6 @@
---
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
description: Preparação de entrevistas técnicas e avaliação de candidatos. Cria perguntas, avalia respostas e fornece feedback.
---
# /interview - Entrevista Estruturada de Requisitos
@@ -16,6 +9,25 @@ Skill para clarificar requisitos antes de iniciar trabalho. Reduz ambiguidade e
---
## Contexto NotebookLM
ANTES de executar, consultar notebooks para contexto especializado:
| Notebook | ID | Consultar quando |
|----------|-----|-----------------|
| Estratégia e Empreendedorismo | 79d43410 | Para contexto negócio |
```
mcp__notebooklm__notebook_query({
notebook_id: "79d43410-0e29-4be1-881d-84db6bdc239a",
query: "<adaptar ao contexto do pedido do utilizador>"
})
```
Integrar insights do NotebookLM nas recomendações e decisões.
---
## QUANDO USAR
- Início de projecto novo

494
negocio/skills/product/SKILL.md
View File

@@ -1,18 +1,11 @@
---
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
description: Gestao de produto desde discovery ate execucao, usando frameworks como RICE, MoSCoW e Jobs-to-be-Done.
---
# 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.
Skill especializada em gestao de produto, desde discovery ate execucao.
## Sintaxe
@@ -20,7 +13,7 @@ Skill especializada em gestão de produto, desde discovery até execução, usan
/product [operacao] [contexto]
```
**Operações:**
**Operacoes:**
- `discovery` - Problem space, jobs-to-be-done, validation
- `prioritize` - RICE scoring, MoSCoW, value/effort matrix
- `roadmap` - Planeamento quadrimestral, epics, milestones
@@ -30,454 +23,114 @@ Skill especializada em gestão de produto, desde discovery até execução, usan
## Quando Usar
- Planear novo produto ou feature
- Priorizar backlog com múltiplas requests
- Priorizar backlog com multiplas requests
- Criar roadmap trimestral/anual
- Refinar user stories
- Optimizar processo de produto
---
## Protocolo de Execução
## Contexto NotebookLM
ANTES de executar, consultar notebooks:
```
mcp__notebooklm__notebook_query({
notebook_id: "79d43410-0e29-4be1-881d-84db6bdc239a",
query: "<adaptar ao contexto do pedido do utilizador>"
})
```
---
## Protocolo de Execucao
### 1. Product Discovery
**Problem Space (não Solution Space):**
**Jobs to be Done (JTBD):**
```markdown
## Jobs to be Done (JTBD)
When [situação]
I want to [motivação]
```
When [situacao]
I want to [motivacao]
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:**
**Validation Framework resumo:**
- **Desirability:** Users querem? (interviews, surveys, prototype tests)
- **Viability:** Negocio faz sentido? (TAM/SAM/SOM, unit economics, ROI > 3x)
- **Feasibility:** Conseguimos construir? (spike, dependencies, timeline)
Detalhes completos: [references/metricas-produto.md](references/metricas-produto.md)
### 2. Prioritization
**RICE Score (recomendado):**
```
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?)
Score = (Reach x Impact x Confidence) / Effort
```
**Validation Framework:**
Tambem disponivel: MoSCoW, Value vs Effort Matrix.
```
┌─────────────────────────────────────────────────┐
│ 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
```
Detalhes e exemplos: [references/prioritization-frameworks.md](references/prioritization-frameworks.md)
### 3. Roadmap Planning
**Template Quadrimestral:**
Template quadrimestral com themes, epics, milestones e success metrics.
```markdown
# Product Roadmap Q1-Q3 2026
Templates completos: [references/roadmap-sprint-templates.md](references/roadmap-sprint-templates.md)
## Q1 (Jan-Abr): Foundation
**Theme:** Stabilize core + basic integrations
**Goal:** 100 active users, NPS > 40
### 4. User Stories
### Epic 1: Core Functionality Polish
- [ ] Performance optimization (< 2s load)
- [ ] Mobile responsive
- [ ] Error handling robusto
```
Como [role]
Quero [accao]
Para que [beneficio]
### 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
Given [contexto]
When [accao]
Then [resultado esperado]
```
### 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
```
Template completo com edge cases e DoD: [references/roadmap-sprint-templates.md](references/roadmap-sprint-templates.md)
### 5. Sprint Planning
**Template Sprint (2 semanas):**
Template de sprint (2 semanas) com capacity, committed stories, stretch goals e ceremonies.
```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
```
Template: [references/roadmap-sprint-templates.md](references/roadmap-sprint-templates.md)
---
## Métricas de Produto
## Metricas de Produto
### Acquisition (AARRR Pirate Metrics)
### AARRR Pirate Metrics
| Fase | Métrica | Target |
| Fase | Metrica | 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
```
| Acquisition | Signups/semana | +20%/mes |
| Activation | Setup completo | > 40% |
| Retention | D7 retention | > 30% |
| Revenue | Conversion free->paid | > 3% |
| Referral | NPS | > 40 |
### 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)
ERRADO: "Lancar 10 features este trimestre"
CERTO: "Aumentar retention D30 de 20% para 35%"
```
---
## 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__notebooklm__notebook_query, 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
```
Metricas detalhadas: [references/metricas-produto.md](references/metricas-produto.md)
---
## 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
/product discovery -> Problem space + JTBD + validation + decision Build/No Build
/product prioritize -> Lista features + RICE scoring + ranking + export Desk
/product roadmap -> Objectivos Q1/Q2/Q3 + epics + milestones + success metrics
```
---
@@ -502,21 +155,10 @@ Task({
---
## Instrumentação Automática
## Conteudo Detalhado
### 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
| Referencia | Conteudo |
|------------|----------|
| [references/prioritization-frameworks.md](references/prioritization-frameworks.md) | RICE scoring, MoSCoW, Value vs Effort matrix |
| [references/roadmap-sprint-templates.md](references/roadmap-sprint-templates.md) | Templates roadmap, user stories, sprint planning |
| [references/metricas-produto.md](references/metricas-produto.md) | AARRR, product health, validation framework, pain points |

83
negocio/skills/product/references/metricas-produto.md Normal file
View File

@@ -0,0 +1,83 @@
# Product - Metricas de Produto
## AARRR Pirate Metrics
| Fase | Metrica | Target |
|------|---------|--------|
| **Acquisition** | Signups/semana | +20%/mes |
| **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):
"Lancar 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)
```
## Discovery - Pain Points
```
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 frequencia do problema?
5. O que tentou fazer para resolver?
Evidencia:
- [ ] 5+ entrevistas com users
- [ ] Analytics de uso (onde abandonam?)
- [ ] Tickets de suporte relacionados
- [ ] Pesquisa concorrencia (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 diario
### Viability (Negocio faz sentido?)
- Market size (TAM/SAM/SOM)
- Revenue model claro
- Unit economics positivos
- Payback period aceitavel
- Target: ROI > 3x em 12 meses
### Feasibility (Conseguimos construir?)
- Technical spike completo
- Dependencies mapeadas
- Resources disponiveis
- Timeline realista
- Risk assessment: Alto/Medio/Baixo

78
negocio/skills/product/references/prioritization-frameworks.md Normal file
View File

@@ -0,0 +1,78 @@
# Product - Frameworks de Priorizacao
## A. RICE Score (Recomendado)
```
Reach x Impact x Confidence
Score = ----------------------------
Effort
Reach: Quantos users impactados por periodo
- 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 solidos
- 80% = Boas evidencias
- 50% = Suposicoes educadas
Effort: Person-months para entregar
- Ex: 2 person-months, 0.5 person-month
```
Exemplo Pratico:
| 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 | Media |
| API v2 | 200/q | 3 | 50% | 3 | 100 | Baixa |
| Search filters | 1000/q | 1 | 80% | 0.5 | 1600 | Alta |
## B. MoSCoW Method
```
MUST have: Critico para launch (MVP)
- Sem isso, produto nao funciona
- Legal/compliance obrigatorio
- Blocker absoluto
SHOULD have: Importante mas nao critico
- Melhora significativamente a experiencia
- 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 proxima versao
- Nao 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
```

162
negocio/skills/product/references/roadmap-sprint-templates.md Normal file
View File

@@ -0,0 +1,162 @@
# Product - Templates de Roadmap e Sprint
## Template Roadmap 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 > 100kEUR
### 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)
```
## Template User Story
```markdown
## US-123: Export dashboard to PDF
### User Story
Como [Product Manager]
Quero [exportar dashboard para PDF com branding personalizado]
Para que [possa partilhar relatorios profissionais com stakeholders externos]
### Context
- Users pedem isto em 60% dos support tickets
- Concorrentes ja tem (Competitor A, B)
- Workaround actual: screenshots (nao 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 relatorio
- Todos os graficos (vectorial)
- Tabela de dados resumida
- Footer com marca d'agua]
And [recebo notificacao 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 nao carregado -> usar placeholder
### Definition of Done
- [ ] Codigo completo e reviewed
- [ ] Testes unitarios (> 80% coverage)
- [ ] Testes E2E (happy path + edge cases)
- [ ] Documentacao 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
```
## 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 x 8 days = 24 person-days
- Velocity media: 25 story points/sprint
- Buffer para bugs/support: 20% -> 20 SP disponiveis
## 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 Criticos
- [ ] BUG-45: Login timeout (2 SP) - @dev1
**Total Committed:** 13 SP
**Stretch Goals:** 8 SP
## Definition of Done (Sprint)
- [ ] Todas as US committed DONE
- [ ] Zero bugs criticos 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
```

508
negocio/skills/research/SKILL.md
View File

@@ -1,18 +1,11 @@
---
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
description: Pesquisa profunda e analise competitiva usando frameworks como SWOT, Porter's Five Forces e PESTEL.
---
# Skill /research - Research & Competitive Analysis
# Skill /research - Research e Competitive Analysis
Skill especializada em pesquisa profunda e análise competitiva, usando frameworks como SWOT, Porter's Five Forces e PESTEL.
Skill especializada em pesquisa profunda e analise competitiva, usando frameworks como SWOT, Porter's Five Forces e PESTEL.
## Sintaxe
@@ -20,422 +13,79 @@ Skill especializada em pesquisa profunda e análise competitiva, usando framewor
/research [operacao] [contexto]
```
**Operações:**
- `swot` - Análise SWOT (Strengths, Weaknesses, Opportunities, Threats)
**Operacoes:**
- `swot` - Analise 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)
- `pestel` - Analise macro-ambiental (Political, Economic, Social, Tech, Environmental, Legal)
- `porter` - Porter's Five Forces
- `due-diligence` - Due diligence completa (M&A, partnership, investment)
## Quando Usar
- Análise de mercado para novo produto
- Analise de mercado para novo produto
- Competitive intelligence de concorrentes
- Due diligence para aquisição/parceria
- Decisão estratégica (entrar num mercado, pivot)
- Due diligence para aquisicao/parceria
- Decisao estrategica (entrar num mercado, pivot)
- Pitch deck para investidores
---
## Protocolo de Execução
## Contexto NotebookLM
### 1. Definir Scope (SEMPRE começar aqui)
ANTES de executar, consultar notebooks para contexto especializado:
**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):**
| Notebook | ID | Consultar quando |
|----------|-----|-----------------|
| Estrategia e Empreendedorismo | 79d43410 | Para contexto estrategico |
```
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
mcp__notebooklm__notebook_query({
notebook_id: "79d43410-0e29-4be1-881d-84db6bdc239a",
query: "<adaptar ao contexto do pedido do utilizador>"
})
```
---
## Consultar Datasets Dify
## Protocolo de Execucao
**SEMPRE antes de análise estratégica:**
### 1. Definir Scope (SEMPRE comecar aqui)
| 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" |
Usar Research Brief Template em: `references/recolha-dados-templates.md`
### Como Consultar
### 2. Recolha de Dados
```javascript
// Frameworks estratégicos
mcp__notebooklm__notebook_query, 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
});
Fontes primarias (entrevistas, surveys) e secundarias (relatorios, dados publicos, dados internos) detalhadas em: `references/recolha-dados-templates.md`
// 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
});
```
### 3. Frameworks de Analise
Templates completos para SWOT, Porter's Five Forces, PESTEL e Competitive Analysis em: `references/frameworks-analise.md`
**Resumo dos frameworks:**
| Framework | Quando usar | Foco |
|-----------|-------------|------|
| SWOT | Qualquer analise estrategica | Interno (S/W) + Externo (O/T) |
| Porter | Avaliar atractividade industria | 5 forcas competitivas |
| PESTEL | Analise macro-ambiental | 6 factores externos |
| Competitive | Analisar concorrentes | Produto, pricing, GTM, feedback |
### 4. Market Sizing (TAM/SAM/SOM)
Template em: `references/recolha-dados-templates.md` (seccao Market Sizing)
### 5. Synthesis e Reporting
Executive Summary template em: `references/recolha-dados-templates.md` (seccao Executive Summary)
---
## MCPs Utilizados
```
mcp__web-fetch__* # Análise websites concorrentes
mcp__dify-kb__dify_kb_retrieve_segments # Frameworks estratégicos
mcp__web-fetch__* # Analise websites concorrentes
mcp__notebooklm__notebook_query # Frameworks estrategicos
mcp__google-workspace__* # Docs para reports
```
@@ -446,67 +96,33 @@ mcp__google-workspace__* # Docs para reports
### 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
-> Recolha dados (website, reviews, funding)
-> Framework analise (SWOT vs nos)
-> 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
-> Analise multi-framework
-> Consulta NotebookLM (best practices)
-> Risk assessment
-> Recomendacao GO/NO-GO
```
### 3. Due Diligence Rápida
### 3. Due Diligence Rapida
```
/research due-diligence "Empresa Y"
→ Levantamento financeiro, equipa, produto
→ Red flags check
→ Valuation estimate
→ Report executivo
-> Levantamento financeiro, equipa, produto
-> Red flags check
-> Valuation estimate
-> Report executivo
```
---
## Agentes Recomendados
## References
```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
- `references/frameworks-analise.md` - Templates SWOT, Porter, PESTEL, Competitive Analysis
- `references/recolha-dados-templates.md` - Fontes dados, Research Brief, TAM/SAM/SOM, Executive Summary

223
negocio/skills/research/references/frameworks-analise.md Normal file
View File

@@ -0,0 +1,223 @@
# Frameworks de Analise Estrategica
Templates completos para SWOT, Porter's Five Forces, PESTEL e Competitive Analysis.
---
## A. SWOT Analysis
```
+-------------------------+-------------------------+
| STRENGTHS | WEAKNESSES |
| (Interno +) | (Interno -) |
+-------------------------+-------------------------+
| O que fazemos bem? | Onde falhamos? |
| Recursos unicos? | 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 -) |
+-------------------------+-------------------------+
| Tendencias a favor? | Riscos externos? |
| Gaps no mercado? | Concorrencia? |
| Mudancas regulacao? | Mudancas tecnologicas? |
| | |
| Ex: | Ex: |
| - GDPR -> procura | - Big tech entra |
| - Remote work trend | - Recessao economica |
| - Incentivos PT2030 | - Open source gratuito |
+-------------------------+-------------------------+
```
**Proximos Passos (Estrategias):**
```
SO (Strengths + Opportunities): Crescimento agressivo
ST (Strengths + Threats): Defesa activa
WO (Weaknesses + Opportunities): Melhorar para aproveitar
WT (Weaknesses + Threats): Dano minimo / Pivot
```
---
## B. Porter's Five Forces
```
+---------------------------------------------------+
| 1. RIVALIDADE ENTRE CONCORRENTES |
+---------------------------------------------------+
| [ ] Quantos concorrentes directos? |
| [ ] Crescimento do mercado? |
| [ ] Diferenciacao possivel? |
| [ ] Switching costs? |
| [ ] Guerras de precos? |
| |
| Intensidade: ALTA / MEDIA / BAIXA |
+---------------------------------------------------+
+---------------------------------------------------+
| 2. PODER DE NEGOCIACAO DOS FORNECEDORES |
+---------------------------------------------------+
| [ ] Poucos fornecedores alternativos? |
| [ ] Custos de mudanca elevados? |
| [ ] Fornecedor pode integrar verticalmente? |
| |
| Poder: ALTO / MEDIO / BAIXO |
+---------------------------------------------------+
+---------------------------------------------------+
| 3. PODER DE NEGOCIACAO DOS CLIENTES |
+---------------------------------------------------+
| [ ] Poucos clientes (concentracao)? |
| [ ] Produto/servico commoditizado? |
| [ ] Switching costs baixos? |
| [ ] Transparencia de precos? |
| |
| Poder: ALTO / MEDIO / BAIXO |
+---------------------------------------------------+
+---------------------------------------------------+
| 4. AMEACA DE NOVOS ENTRANTES |
+---------------------------------------------------+
| [ ] Barreiras a entrada (capital, regulacao)? |
| [ ] Economias de escala necessarias? |
| [ ] Lealdade a marca existente? |
| [ ] Acesso a canais de distribuicao? |
| |
| Ameaca: ALTA / MEDIA / BAIXA |
+---------------------------------------------------+
+---------------------------------------------------+
| 5. AMEACA DE PRODUTOS SUBSTITUTOS |
+---------------------------------------------------+
| [ ] Alternativas com melhor price/performance? |
| [ ] Switching costs baixos para substituto? |
| [ ] Tendencias favor do substituto? |
| |
| Ameaca: ALTA / MEDIA / BAIXA |
+---------------------------------------------------+
CONCLUSAO:
Atractividade da industria: ALTA / MEDIA / BAIXA
Estrategia recomendada: [...]
```
---
## C. PESTEL Analysis
```
POLITICAL (Regulacao, Estabilidade)
- Regulacao GDPR/privacy -> [impacto]
- Incentivos fiscais I&D -> [oportunidade]
- Estabilidade governo PT -> [risco]
ECONOMIC (Inflacao, Crescimento, Cambio)
- Taxa de juro -> [impacto custos financiamento]
- Crescimento PIB PT -> [procura]
- Taxa de desemprego -> [talento disponivel]
SOCIAL (Demografia, Tendencias, Valores)
- Remote work trend -> [oportunidade]
- Envelhecimento populacao -> [target]
- Adopcao tecnologia SMBs -> [timing]
TECHNOLOGICAL (Inovacao, Disrupcao)
- AI/ML acessivel -> [competitive advantage]
- Cloud computing -> [custos infra]
- Open source -> [ameaca]
ENVIRONMENTAL (Sustentabilidade, Clima)
- Pressao ESG -> [requisito]
- Carbon neutrality -> [diferenciador]
- Green tech -> [nicho]
LEGAL (Legislacao, Compliance)
- Lei do trabalho remoto -> [oportunidade]
- Regulacao sector X -> [barreira entrada]
- IP/patents -> [proteccao]
```
---
## D. Competitive Analysis Template
```markdown
# Competitive Analysis: [Concorrente X]
## Overview
- **Website:** [URL]
- **Fundacao:** [Ano]
- **HQ:** [Localizacao]
- **Tamanho:** [N. employees] - via LinkedIn
- **Funding:** [Total raised] - via Crunchbase
- **Investors:** [Lista] - via Crunchbase
- **Status:** Activo / Estavel / Crescendo / Declinando
## Produto/Servico
**Oferta principal:**
- [Produto A]
- [Produto B]
**Pricing:**
| Plano | Preco | Features-chave |
|-------|-------|----------------|
| Free | 0 EUR | [features] |
| Pro | 29 EUR/mes | [features] |
| Enterprise | Custom | [features] |
**Diferenciadores:**
- [O que eles fazem bem unico]
**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 visiveis] - SpyFu
- Content: [Blog posts/mes]
- 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 Diferenciacao
1. [Feature X que eles nao tem]
2. [Segmento Y que ignoram]
3. [Pricing model Z mais justo]
## Threat Level
HIGH / MEDIUM / LOW
**Reasoning:** [...]
```

148
negocio/skills/research/references/recolha-dados-templates.md Normal file
View File

@@ -0,0 +1,148 @@
# Recolha de Dados e Templates de Reporting
Fontes de dados, templates de research brief, market sizing e executive summary.
---
## Fontes Primarias (dados originais)
```
ENTREVISTAS
- Stakeholders internos (5-10)
- Clientes actuais (10-20)
- Prospects (5-10)
- Experts da industria (3-5)
Template perguntas:
1. Maior desafio no [area]?
2. Solucoes actuais? Satisfacao?
3. O que faria a solucao ideal?
4. Quanto vale resolver este problema?
5. Quem decide compra? Processo?
SURVEYS
- Amostra: 50-200 respostas (statistical significance)
- Duracao: < 5 minutos
- Incentivo: Sorteio / Report gratis
- Plataforma: Typeform / Google Forms
```
## Fontes Secundarias (dados existentes)
```
RELATORIOS INDUSTRIA
- Gartner, Forrester, IDC (paywalled)
- Statista, eMarketer (publico)
- CB Insights (funding, trends)
DADOS PUBLICOS
- Websites concorrentes (WebFetch)
- LinkedIn (empresa, equipa, vagas)
- Crunchbase (funding, investors)
- G2, Capterra, Trustpilot (reviews)
- Google Trends (interesse ao longo tempo)
- SimilarWeb (trafego, sources)
DADOS INTERNOS
- Google Analytics (comportamento users)
- Desk CRM (deals ganhos/perdidos)
- Support tickets (pain points)
- Sales calls recordings (objecoes)
```
---
## Research Brief Template
```markdown
# Research Brief: [Titulo]
## Pergunta Central
[O que queremos descobrir? Ex: "Viabilidade de entrar no mercado PT de e-learning corporativo"]
## Stakeholders
- Decision maker: [Nome, Cargo]
- Beneficiarios: [Quem usa a research?]
- Approval: [Quem aprova?]
## Timeline
- Inicio: [Data]
- Entrega: [Data]
- Urgencia: Alta / Media / Baixa
## Ambito
**In scope:**
- [X]
- [Y]
**Out of scope:**
- [A]
- [B]
## Fontes a Consultar
- [ ] Fontes primarias (entrevistas, surveys)
- [ ] Fontes secundarias (relatorios, artigos)
- [ ] Dados internos (analytics, CRM)
- [ ] Dados publicos (websites, LinkedIn)
## Output Esperado
- Formato: Brief (1 pag) / Report (5-10 pag) / Deep Dive (20+ pag)
- Entrega: PDF / Apresentacao / Dashboard
```
---
## Market Sizing (TAM/SAM/SOM)
```
TAM (Total Addressable Market)
"Se tivessemos 100% do mercado..."
Exemplo: Todas as PMEs em Portugal = 1.2M empresas x 500 EUR/ano = 600M EUR
SAM (Serviceable Available Market)
"Mercado que conseguimos servir realisticamente..."
Exemplo: PMEs 10-50 employees em PT = 80k empresas x 500 EUR = 40M EUR
SOM (Serviceable Obtainable Market)
"Quota que conseguimos capturar em 3 anos..."
Exemplo: 2% do SAM = 800 empresas x 500 EUR = 400k EUR
Validacao:
[ ] Bottom-up (clientes x preco)
[ ] Top-down (% de mercado total)
[ ] Value theory (quanto vale resolver problema)
```
---
## Executive Summary Template (1 pagina)
```markdown
# Executive Summary: [Titulo Research]
## Key Question
[Pergunta central]
## Conclusion (TL;DR)
[Recomendacao 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 | Mitigacao |
|-------|---------------|---------|-----------|
| [Risco A] | Alta | Alto | [Como mitigar] |
## Next Steps
1. [Accao imediata]
2. [Accao follow-up]
3. [Decision point]
## Resources Needed
- Budget: [X] EUR
- Time: [Y] semanas
- Team: [Z] pessoas
```

513
negocio/skills/saas/SKILL.md
View File

@@ -1,18 +1,11 @@
---
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
description: Arquitectura e desenvolvimento de produtos SaaS cobrindo multi-tenancy, billing, onboarding e metricas.
---
# 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.
Skill especializada em arquitectura e desenvolvimento de produtos SaaS (Software as a Service).
## Sintaxe
@@ -20,479 +13,112 @@ Skill especializada em arquitectura e desenvolvimento de produtos SaaS (Software
/saas [operacao] [contexto]
```
**Operações:**
**Operacoes:**
- `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
- `pricing` - Modelos de precos e packaging de features
- `onboarding` - Flow de activacao e time-to-value
- `billing` - Integracao Stripe, trial, upgrades/downgrades
- `metricas` - Dashboard MRR, churn, LTV, CAC
## Quando Usar
- Planear novo produto SaaS
- Migrar aplicação tradicional para SaaS
- Migrar aplicacao tradicional para SaaS
- Optimizar onboarding ou reduzir churn
- Implementar billing e subscriptions
- Arquitectura multi-tenant
---
## Protocolo de Execução
## Contexto NotebookLM
ANTES de executar, consultar notebooks:
```
mcp__notebooklm__notebook_query({
notebook_id: "79d43410-0e29-4be1-881d-84db6bdc239a",
query: "<adaptar ao contexto do pedido do utilizador>"
})
```
---
## Protocolo de Execucao
### 1. Discovery de Produto
**Questões chave:**
Questoes chave:
```
Modelo de negócio:
Modelo de negocio:
- [ ] 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?
- [ ] Diferentes roles/permissoes?
- [ ] Colaboracao entre users?
Dados:
- [ ] Volume de dados por tenant?
- [ ] Regulamentações (GDPR, HIPAA)?
- [ ] Regulamentacoes (GDPR, HIPAA)?
- [ ] Backup e disaster recovery?
Integrações:
- [ ] APIs third-party necessárias?
Integracoes:
- [ ] APIs third-party necessarias?
- [ ] SSO/SAML enterprise?
- [ ] Webhooks para partners?
```
### 2. Arquitectura Multi-tenant
**Estratégias de Isolamento:**
Tres estrategias 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 │
└─────────────────────────────────────────────────┘
| Estrategia | Pros | Contras | Quando Usar |
|-----------|------|---------|-------------|
| DB per Tenant | Seguranca total, restore independente | Custo, complexidade | Enterprise, regulamentacoes |
| Schema per Tenant | Bom isolamento, gestao simples | Limites BD (~10k schemas) | B2B medio porte |
| Shared DB + RLS | Mais barato, facil escalar | tenant_id em tudo | B2C, SMB self-service |
┌─────────────────────────────────────────────────┐
│ 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)
```
Detalhes de implementacao (PostgreSQL RLS, checklist seguranca): [references/multi-tenancy.md](references/multi-tenancy.md)
### 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 |
| Modelo | Quando Usar |
|--------|-------------|
| Flat Rate | Simplicidade, previsibilidade |
| Per Seat | B2B, equipas |
| Usage Based | Variacao alta de uso |
| Tiered | Upsell natural |
| Hybrid | Receita previsivel + 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)
```
Tiers detalhados, Stripe billing, feature flags: [references/pricing-billing.md](references/pricing-billing.md)
**Exemplo de Tiers:**
### 4. Stack Tecnica Recomendada
```
┌─────────────────────────────────────────────────┐
│ 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
Frontend: Next.js 14+ | Tailwind + shadcn/ui | Zustand | React Hook Form + Zod
Backend: Next.js API / tRPC | PostgreSQL (Supabase) | Prisma | BullMQ | Redis
Auth: Clerk / Auth0 / NextAuth.js
Billing: Stripe Billing
Email: Resend / SendGrid
Analytics: PostHog / Mixpanel
Hosting: Vercel | Railway | Supabase | Cloudflare
```
**Hosting:**
```
Frontend: Vercel
Backend: Railway / Fly.io
Database: Supabase / Neon
CDN: Cloudflare
```
### 5. Metricas SaaS
### 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__notebooklm__notebook_query, 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
```
KPIs essenciais, onboarding flow, metricas de retencao: [references/metricas-kpis.md](references/metricas-kpis.md)
---
## 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
/saas arquitectura -> Discovery + multi-tenancy + stack + roadmap MVP
/saas pricing -> Analise competidores + LTV/CAC + tiers + feature packaging
/saas metricas -> KPIs + queries SQL + setup analytics + dashboards
```
---
@@ -500,14 +126,14 @@ mcp__dify-kb__dify_kb_retrieve_segments # Conhecimento estratégico
## Agentes Recomendados
```javascript
// Arquitectura técnica
// Arquitectura tecnica
Task({
subagent_type: "software-architect",
model: "sonnet",
prompt: "Design multi-tenant SaaS architecture. PostgreSQL RLS + Next.js."
});
// Estratégia produto
// Estrategia produto
Task({
subagent_type: "software-project-planner",
model: "sonnet",
@@ -517,21 +143,10 @@ Task({
---
## Instrumentação Automática
## Conteudo Detalhado
### 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
| Referencia | Conteudo |
|------------|----------|
| [references/multi-tenancy.md](references/multi-tenancy.md) | Implementacao RLS PostgreSQL, checklist seguranca |
| [references/pricing-billing.md](references/pricing-billing.md) | Tiers, Stripe setup, trial conversion, feature flags |
| [references/metricas-kpis.md](references/metricas-kpis.md) | KPIs receita/crescimento/aquisicao/retencao, onboarding flow |

63
negocio/skills/saas/references/metricas-kpis.md Normal file
View File

@@ -0,0 +1,63 @@
# SaaS - Metricas e KPIs
## Receita
| Metrica | Formula | Target |
|---------|---------|--------|
| **MRR** | Monthly Recurring Revenue | Crescimento mes/mes |
| **ARR** | MRR x 12 | > 100kEUR para sustainable |
| **ARPU** | MRR / Total customers | Sector-dependent |
| **NRR** | (MRR inicio + expansion - churn - contraction) / MRR inicio | > 100% |
## Crescimento
| Metrica | Formula | Target |
|---------|---------|--------|
| **New MRR** | Novos clientes x preco medio | +20%/mes (early) |
| **Expansion MRR** | Upsells + Add-ons | > 10% do MRR |
| **Churn MRR** | Cancelamentos valor | < 5%/mes |
## Aquisicao
| Metrica | Formula | Target |
|---------|---------|--------|
| **CAC** | Custo marketing+sales / Novos clientes | < 1/3 LTV |
| **LTV** | ARPU x (1 / Churn Rate) - CAC | > 3x CAC |
| **Payback Period** | CAC / ARPU | < 12 meses |
## Produto
| Metrica | 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) |
## Retencao
| Metrica | Formula | Target |
|---------|---------|--------|
| **Logo Churn** | Clientes cancelaram / Total | < 5%/mes |
| **Revenue Churn** | MRR perdido / MRR total | < 5%/mes |
| **Cohort Retention** | Clientes mes X activos em X+6 | > 50% |
## 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 - Video 30s: "O que vais conseguir" - Skip disponivel
3. QUICK SETUP - 3-5 campos essenciais - < 2 minutos
4. FIRST ACTION - Criar primeiro item com template pre-preenchido - < 2 minutos
5. AHA MOMENT - Ver resultado imediato (export, share, etc)
6. NEXT STEPS - Checklist guiada: "3 passos para dominar"
```
Metricas 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%

59
negocio/skills/saas/references/multi-tenancy.md Normal file
View File

@@ -0,0 +1,59 @@
# SaaS - Arquitectura Multi-tenant
## Estrategias de Isolamento
### 1. Database per Tenant (Isolamento Maximo)
- Pros: Seguranca total, restore independente
- Contras: Custo, complexidade gestao
- Usar quando: Enterprise, regulamentacoes
- Exemplo: AWS RDS + Aurora Serverless
### 2. Schema per Tenant (Equilibrio)
- Pros: Bom isolamento, gestao simplificada
- Contras: Limites BD (PostgreSQL ~10k schemas)
- Usar quando: B2B medio porte
- Exemplo: PostgreSQL schemas dinamicos
### 3. Shared DB + Row-Level Security (Economico)
- Pros: Mais barato, facil escalar
- Contras: tenant_id em tudo, RLS obrigatorio
- Usar quando: B2C, SMB self-service
- Exemplo: PostgreSQL RLS policies
## Implementacao 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 inicio de cada request (backend)
-- SET app.tenant_id = 'uuid-do-tenant-autenticado';
```
## Checklist Seguranca Multi-tenant
```
[ ] tenant_id em TODAS as tabelas
[ ] RLS policies activas
[ ] Indexes em tenant_id (performance)
[ ] Validacao tenant_id no auth middleware
[ ] Logs de acesso cross-tenant
[ ] Testes de isolamento (tenant A nao ve tenant B)
```

137
negocio/skills/saas/references/pricing-billing.md Normal file
View File

@@ -0,0 +1,137 @@
# SaaS - Pricing e Billing
## Modelos de Pricing
| Modelo | Descricao | Exemplo | Quando Usar |
|--------|-----------|---------|-------------|
| **Flat Rate** | Preco fixo mensal | 29EUR/mes | Simplicidade, previsibilidade |
| **Per Seat** | Por utilizador | 10EUR/user/mes | B2B, equipas |
| **Usage Based** | Pay-as-you-go | 0.01EUR/API call | Variacao alta de uso |
| **Tiered** | Planos com limites | Free/Pro/Enterprise | Upsell natural |
| **Hybrid** | Base + usage | 20EUR + 0.001EUR/email | Receita previsivel + escala |
Recomendacao 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 (0EUR/mes):**
- 1 user
- 100 records/mes
- 1 GB storage
- Sem integracoes, API, suporte prioritario
**PRO (29EUR/mes):**
- 5 users
- 10.000 records/mes
- 50 GB storage
- Integracoes basicas
- API access (10k calls/mes)
- Email support (24h)
**ENTERPRISE (Custom):**
- Users ilimitados
- Records ilimitados
- Storage dedicado
- Todas as integracoes
- API ilimitado
- Suporte 24/7 + Account Manager
- SSO/SAML
- SLA 99.9%
## Billing com Stripe
### Setup Basico
```typescript
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,
payment_behavior: 'default_incomplete',
expand: ['latest_invoice.payment_intent']
});
// Webhooks para sincronizar estado:
// - customer.subscription.created
// - customer.subscription.updated
// - customer.subscription.deleted
// - invoice.payment_succeeded
// - invoice.payment_failed
// 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 cartao)
|
+- Dia 7: Email "Metade do trial"
+- Dia 12: Email "2 dias restantes + valor criado"
+- Dia 14: Soft paywall (pedir cartao)
|
v
Converteu? -> Pro (29EUR/mes)
Nao converteu? -> Free (downgrade features)
```
## Feature Flags por Plano
```typescript
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'
]
};
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();
};
}
```