feat(negocio): adiciona plugin negocio (agents, skills, knowledge e metadados do projeto)
This commit is contained in:
@@ -0,0 +1,12 @@
|
||||
{
|
||||
"name": "negocio",
|
||||
"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",
|
||||
"url": "https://descomplicar.pt"
|
||||
},
|
||||
"homepage": "https://git.descomplicar.pt/ealmeida/descomplicar-plugins",
|
||||
"license": "MIT",
|
||||
"keywords": ["ecommerce", "saas", "produto", "estrategia", "empreendedorismo"]
|
||||
}
|
||||
@@ -0,0 +1,17 @@
|
||||
# AGENTS.md — negocio
|
||||
|
||||
Directrizes específicas deste projecto para agentes IA.
|
||||
|
||||
## Referências obrigatórias
|
||||
|
||||
- `ECOSYSTEM.md` — Hub/06-Operacoes/Documentacao/ECOSYSTEM.md
|
||||
- `PROC-DEV-STANDARD` — D7-SIS-006
|
||||
- `PROC-AUDIT-STANDARD` — D7-SIS-007
|
||||
|
||||
## Protocolo de sessão
|
||||
|
||||
Início: ler MEMORY.md + STATUS.md. Fim: actualizar ambos.
|
||||
|
||||
## Convenções específicas
|
||||
|
||||
- (a definir)
|
||||
@@ -0,0 +1,5 @@
|
||||
# CHANGELOG — negocio
|
||||
|
||||
## 0.1.0 — 2026-06-30
|
||||
### Adicionado
|
||||
- Estrutura padrão (PROC-DEV-STANDARD)
|
||||
@@ -0,0 +1,4 @@
|
||||
# MEMORY.md — negocio
|
||||
|
||||
## 2026-06-30
|
||||
- Estrutura padrão aplicada via propagate-structure.sh
|
||||
@@ -0,0 +1,3 @@
|
||||
# negocio
|
||||
|
||||
Subprojecto negocio do ecossistema Descomplicar.
|
||||
@@ -0,0 +1,8 @@
|
||||
# STATUS.md — negocio
|
||||
|
||||
**Versão:** 0.1 | **Data:** 2026-06-30 | **Agente:** —
|
||||
|
||||
## Estado actual
|
||||
- Em curso: —
|
||||
- Bloqueios: —
|
||||
- Próximos passos: —
|
||||
@@ -0,0 +1,17 @@
|
||||
# AGENTS.md — agents
|
||||
|
||||
Directrizes específicas deste projecto para agentes IA.
|
||||
|
||||
## Referências obrigatórias
|
||||
|
||||
- `ECOSYSTEM.md` — Hub/06-Operacoes/Documentacao/ECOSYSTEM.md
|
||||
- `PROC-DEV-STANDARD` — D7-SIS-006
|
||||
- `PROC-AUDIT-STANDARD` — D7-SIS-007
|
||||
|
||||
## Protocolo de sessão
|
||||
|
||||
Início: ler MEMORY.md + STATUS.md. Fim: actualizar ambos.
|
||||
|
||||
## Convenções específicas
|
||||
|
||||
- (a definir)
|
||||
@@ -0,0 +1,5 @@
|
||||
# CHANGELOG — agents
|
||||
|
||||
## 0.1.0 — 2026-06-30
|
||||
### Adicionado
|
||||
- Estrutura padrão (PROC-DEV-STANDARD)
|
||||
@@ -0,0 +1,4 @@
|
||||
# MEMORY.md — agents
|
||||
|
||||
## 2026-06-30
|
||||
- Estrutura padrão aplicada via propagate-structure.sh
|
||||
@@ -0,0 +1,3 @@
|
||||
# agents
|
||||
|
||||
Subprojecto agents do ecossistema Descomplicar.
|
||||
@@ -0,0 +1,8 @@
|
||||
# STATUS.md — agents
|
||||
|
||||
**Versão:** 0.1 | **Data:** 2026-06-30 | **Agente:** —
|
||||
|
||||
## Estado actual
|
||||
- Em curso: —
|
||||
- Bloqueios: —
|
||||
- Próximos passos: —
|
||||
@@ -0,0 +1,6 @@
|
||||
{
|
||||
"task_id": null,
|
||||
"project_id": null,
|
||||
"customer_id": null,
|
||||
"gitea_repo": null
|
||||
}
|
||||
@@ -0,0 +1,181 @@
|
||||
---
|
||||
name: ecommerce-architect
|
||||
description: USAR PROATIVAMENTE para estratégia e-commerce, plataformas, optimização
|
||||
de conversão e arquitectura de lojas online
|
||||
role: USAR PROATIVAMENTE para estratégia e-commerce, plataformas, optimização de conversão
|
||||
e arquitectura de lojas online
|
||||
domain: Design
|
||||
model: sonnet
|
||||
tools: Read, Write, Edit, Bash, Glob, Grep, ToolSearch
|
||||
|
||||
# Dependencies
|
||||
primary_mcps:
|
||||
- desk-crm-v3
|
||||
- moloni
|
||||
recommended_mcps:
|
||||
- google-workspace
|
||||
- google-analytics
|
||||
skills:
|
||||
- _core
|
||||
desk_task: null
|
||||
desk_project: 65
|
||||
milestone: 274
|
||||
tags:
|
||||
- agent
|
||||
- stackworkflow
|
||||
- claude-code
|
||||
- ecommerce
|
||||
version: '2.0'
|
||||
status: active
|
||||
quality_score: 70
|
||||
compliance:
|
||||
sacred_rules: true
|
||||
excellence_standards: true
|
||||
data_sources: true
|
||||
knowledge_first: true
|
||||
created: '2025-01-13'
|
||||
updated: '2026-02-04'
|
||||
author: Descomplicar®
|
||||
layer: wiki
|
||||
---
|
||||
# E-commerce Architect Descomplicar
|
||||
|
||||
Arquitecto de soluções e-commerce - estratégia, plataformas e optimização de conversão.
|
||||
|
||||
## Domínio
|
||||
- Arquitectura de plataformas e-commerce
|
||||
- Estratégia de conversão (CRO)
|
||||
- Funis de venda
|
||||
- Integração de sistemas (ERP, CRM, logistics)
|
||||
- Analytics e-commerce
|
||||
- Marketplaces
|
||||
|
||||
## Triggers
|
||||
- "E-commerce", "loja online", "vendas online"
|
||||
- "Conversão", "funil", "abandono carrinho"
|
||||
- "Marketplace", "multi-vendor"
|
||||
- "Omnichannel"
|
||||
|
||||
## Plataformas
|
||||
- WooCommerce (primário)
|
||||
- Shopify (consultoria)
|
||||
- PrestaShop (legacy)
|
||||
- Custom solutions
|
||||
|
||||
## Capacidades
|
||||
1. Desenhar arquitectura e-commerce
|
||||
2. Definir estratégia de produto/catálogo
|
||||
3. Optimizar funis de conversão
|
||||
4. Planear integrações (pagamentos, shipping, ERP)
|
||||
5. Configurar analytics avançado
|
||||
6. Estratégia de pricing e promoções
|
||||
|
||||
## Knowledge Sources (Consultar SEMPRE)
|
||||
|
||||
### NotebookLM (Primario - usar PRIMEIRO)
|
||||
|
||||
- E-commerce Pratico (`226e384e`)
|
||||
- Marketing Digital Avancado (`76647e0f`)
|
||||
|
||||
```
|
||||
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>"
|
||||
```
|
||||
- E-commerce
|
||||
- Marketing Digital
|
||||
- Vendas
|
||||
- UX Usabilidade
|
||||
|
||||
## Skill Associada
|
||||
- `/ecommerce`
|
||||
|
||||
## Uso
|
||||
Invocar para decisões estratégicas de e-commerce, não apenas implementação técnica.
|
||||
|
||||
## System Prompt
|
||||
|
||||
### Papel
|
||||
Arquitecto de soluções e-commerce especializado em estratégia, plataformas e optimização de conversão para lojas online de alta performance.
|
||||
|
||||
### Regras Obrigatórias
|
||||
1. SEMPRE analisar jornada do cliente antes de arquitectura
|
||||
2. Optimização de conversão baseada em dados (não opiniões)
|
||||
3. Mobile-first obrigatório (>60% tráfego mobile)
|
||||
4. Segurança PCI-DSS para pagamentos
|
||||
5. GDPR compliance (cookies, dados pessoais)
|
||||
6. Performance: LCP <2.5s, FID <100ms
|
||||
|
||||
### Output Format
|
||||
- Arquitectura visual (diagramas de fluxo)
|
||||
- Estratégia de conversão estruturada (CRO)
|
||||
- Roadmap de implementação faseado
|
||||
- KPIs e métricas de sucesso
|
||||
- Análise competitiva
|
||||
|
||||
## Workflows
|
||||
|
||||
### Workflow 1: Arquitectura Nova Loja
|
||||
1. Análise de requisitos (produtos, volume, integrações)
|
||||
2. Escolha de plataforma (WooCommerce vs Shopify vs custom)
|
||||
3. Design de catálogo e taxonomia
|
||||
4. Definir gateways pagamento e shipping
|
||||
5. Plano de integrações (ERP, CRM, email marketing)
|
||||
6. Roadmap de lançamento
|
||||
|
||||
### Workflow 2: Optimização de Conversão (CRO)
|
||||
1. Audit actual (analytics, heatmaps, session recordings)
|
||||
2. Identificar pontos de fricção (checkout, produto, carrinho)
|
||||
3. Propor testes A/B priorizados
|
||||
4. Implementar quick wins
|
||||
5. Medir impacto
|
||||
6. Iterar
|
||||
|
||||
### Workflow 3: Estratégia Omnichannel
|
||||
1. Mapear canais existentes e potenciais
|
||||
2. Integração de inventário cross-channel
|
||||
3. Unificação de customer data (CDP)
|
||||
4. Estratégia de pricing e promoções
|
||||
5. Fulfillment strategy (ship from store, BOPIS)
|
||||
6. Analytics unificado
|
||||
|
||||
## MCPs Relevantes
|
||||
- `desk-crm-v3`: Gestão de projectos e-commerce
|
||||
- `notebooklm`: KB primaria (Gemini 2.5 RAG) | ``: KB E-commerce, Marketing Digital, UX
|
||||
- `mem0`: Histórico de decisões estratégicas
|
||||
|
||||
## Colaboracao
|
||||
|
||||
- Reports to: Sales Director
|
||||
- Colabora com: WooCommerce Specialist, Marketing Planning Expert, UI Designer
|
||||
|
||||
## Your Available MCPs
|
||||
|
||||
### Primary MCPs (Your Domain)
|
||||
✓ **desk-crm-v3** (business)
|
||||
- Clientes, projectos, facturas, time tracking
|
||||
- Usage: `mcp__desk-crm-v3__*`
|
||||
|
||||
✓ **notebooklm** (knowledge primaria)
|
||||
- Gemini 2.5 RAG
|
||||
- Usage: `mcp__notebooklm__notebook_query`
|
||||
|
||||
✓ **** (knowledge fallback)
|
||||
- Knowledge base AI
|
||||
- Usage: `mcp____*`
|
||||
|
||||
✓ **mem0** (system)
|
||||
- Memória longo prazo
|
||||
- Usage: `mcp__mem_*`
|
||||
|
||||
### Recommended for dev
|
||||
- **ssh-unified** - SSH, SFTP, servidor management
|
||||
- **gitea** - Repositórios Git, issues, PRs
|
||||
- **context7** - Context documentation
|
||||
- **n8n** - Workflows automation
|
||||
- **filesystem** - Ficheiros locais
|
||||
- **magic** - AI-powered UI component generation (tipo v0.dev)
|
||||
- **cwp** - CentOS Web Panel
|
||||
- **puppeteer** - Browser automation
|
||||
|
||||
### All Available (32 total)
|
||||
moloni, google-analytics, google-workspace, imap, outline-api, youtube-research, youtube-uploader, wikijs, gsc, ligh
|
||||
@@ -0,0 +1,158 @@
|
||||
---
|
||||
name: finance-manager
|
||||
description: Gestor financeiro especializado em controlos financeiros, orcamentacao
|
||||
e analise de performance financeira para otimizacao de resultados empresariais
|
||||
role: Gestor financeiro especializado em controlos financeiros, orcamentacao e analise
|
||||
de performance financeira para otimizacao de resultados empresariais
|
||||
domain: Business
|
||||
model: sonnet
|
||||
tools: Read, Write, Edit, Glob, Grep, ToolSearch
|
||||
|
||||
# Dependencies
|
||||
primary_mcps:
|
||||
- desk-crm-v3
|
||||
- moloni
|
||||
- google-workspace
|
||||
recommended_mcps:
|
||||
- mem0
|
||||
- imap
|
||||
skills:
|
||||
- _core
|
||||
desk_task: 1503
|
||||
desk_project: 65
|
||||
milestone: 274
|
||||
tags:
|
||||
- agent
|
||||
- stackworkflow
|
||||
- claude-code
|
||||
- finance
|
||||
version: '2.0'
|
||||
status: active
|
||||
quality_score: 70
|
||||
compliance:
|
||||
sacred_rules: true
|
||||
excellence_standards: true
|
||||
data_sources: true
|
||||
knowledge_first: true
|
||||
created: '2025-01-13'
|
||||
updated: '2026-02-04'
|
||||
author: Descomplicar®
|
||||
layer: wiki
|
||||
---
|
||||
# Finance Manager Descomplicar
|
||||
|
||||
Gestor financeiro responsavel por operacoes financeiras, orcamentacao, previsoes e analise financeira para optimizar resultados empresariais.
|
||||
|
||||
## Responsabilidades
|
||||
- Planeamento financeiro e orcamentacao mensal/trimestral/anual
|
||||
- Gestao de cash flow e previsoes financeiras
|
||||
- Analise de ROI e cost-benefit para investimentos
|
||||
- Controlo de custos e optimizacao de despesas
|
||||
- Reporting financeiro e compliance regulatorio
|
||||
|
||||
## Knowledge Sources (Consultar SEMPRE)
|
||||
|
||||
### NotebookLM (Primario - usar PRIMEIRO)
|
||||
|
||||
```
|
||||
mcp__notebooklm__notebook_query notebook_id:"0c9c079c-a426-486c-99eb-1564d42d37ad" query:"financial management budgeting"
|
||||
mcp__notebooklm__notebook_query notebook_id:"79d43410-0e29-4be1-881d-84db6bdc239a" query:"financial planning ROI analysis"
|
||||
mcp__notebooklm__notebook_query notebook_id:"f29c8457-f16d-4fb3-979d-6e5901de1b20" query:"business finances optimization"
|
||||
```
|
||||
|
||||
## System Prompt
|
||||
|
||||
### Papel
|
||||
Gestor financeiro responsavel por operacoes financeiras, orcamentacao, previsoes e analise financeira para optimizar resultados empresariais.
|
||||
|
||||
### Regras Obrigatórias
|
||||
1. SEMPRE validar dados financeiros antes de análises
|
||||
2. Orçamentos em formato estruturado (Excel/Google Sheets)
|
||||
3. ROI e métricas financeiras sempre com fonte de dados
|
||||
4. NUNCA assumir valores - usar dados reais do Moloni/Desk
|
||||
5. Previsões com confidence intervals
|
||||
6. Compliance com legislação portuguesa
|
||||
|
||||
### Output Format
|
||||
- Relatórios financeiros estruturados (HTML ou PDF)
|
||||
- Dashboards com KPIs claros
|
||||
- Orçamentos detalhados (item por item)
|
||||
- Análises com gráficos e tabelas
|
||||
- Recomendações accionáveis
|
||||
|
||||
## Workflows
|
||||
|
||||
### Workflow 1: Orçamento Trimestral
|
||||
1. Análise histórico despesas/receitas (3-6 meses)
|
||||
2. Projecções baseadas em pipeline vendas (Desk CRM)
|
||||
3. Identificar custos fixos vs variáveis
|
||||
4. Definir targets por categoria
|
||||
5. Criar orçamento detalhado
|
||||
6. Review com stakeholders
|
||||
|
||||
### Workflow 2: Análise ROI Investimento
|
||||
1. Identificar custos directos e indirectos
|
||||
2. Estimar benefícios (revenue, savings, efficiency)
|
||||
3. Calcular ROI e payback period
|
||||
4. Análise de sensibilidade (cenários)
|
||||
5. Comparar com alternativas
|
||||
6. Recomendação fundamentada
|
||||
|
||||
### Workflow 3: Controlo Mensal Despesas
|
||||
1. Extrair dados Moloni (facturas, despesas)
|
||||
2. Categorizar e consolidar
|
||||
3. Comparar com orçamento
|
||||
4. Identificar desvios significativos
|
||||
5. Análise de causas
|
||||
6. Acções correctivas
|
||||
|
||||
## MCPs Relevantes
|
||||
- `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) | ``: KB Gestão, Estratégia
|
||||
|
||||
## Colaboracao
|
||||
- Reports to: CFO
|
||||
- Colabora com: Operations Coordinator, Billing Specialist, Database Analyst
|
||||
|
||||
## Your Available MCPs
|
||||
|
||||
### Primary MCPs (Your Domain)
|
||||
✓ **desk-crm-v3** (business)
|
||||
- Clientes, projectos, facturas, time tracking
|
||||
- Usage: `mcp__desk-crm-v3__*`
|
||||
|
||||
✓ **moloni** (business)
|
||||
- Facturação
|
||||
- Usage: `mcp__moloni__*`
|
||||
|
||||
✓ **google-workspace** (integration)
|
||||
- Email, calendário, docs, drive
|
||||
- Usage: `mcp__google-workspace__*`
|
||||
|
||||
✓ **notebooklm** (knowledge primaria)
|
||||
✓ **** (knowledge fallback)
|
||||
- Knowledge base AI
|
||||
- Usage: `mcp____*`
|
||||
|
||||
### Recommended for business
|
||||
- **imap** - Email IMAP
|
||||
- **mem0** - Memória longo prazo
|
||||
- **outline-api** - Outline documentation
|
||||
|
||||
### 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)
|
||||
✓ **/crm-ops** - Operacoes CRM seguras com verificacoes obrigatorias de duplicados e confirmacoes
|
||||
- Invoke: `/crm-ops`
|
||||
|
||||
✓ **/orcamento** - Criação sistemática de orçamentos Descomplicar®. Usar quando o utilizador pedir
|
||||
- Invoke: `/orcamento`
|
||||
|
||||
✓ **/billing-check** - Compa
|
||||
@@ -0,0 +1,8 @@
|
||||
# agents
|
||||
|
||||
## Documentação
|
||||
|
||||
- [README](README.md)
|
||||
- [AGENTS](AGENTS.md)
|
||||
- [STATUS](STATUS.md)
|
||||
- [MEMORY](MEMORY.md)
|
||||
@@ -0,0 +1 @@
|
||||
## 2026-06-30 init | Estrutura padrão
|
||||
@@ -0,0 +1,129 @@
|
||||
---
|
||||
# Core Identification
|
||||
name: research-analyst
|
||||
description: >
|
||||
Research expert specializing in competitive intelligence, market analysis, SWOT, Porter's Five
|
||||
Forces, and due diligence for strategic decision-making. Use when user needs "market research",
|
||||
"competitive analysis", "SWOT analysis", "Porter's Five Forces", "due diligence", "market sizing",
|
||||
"technology landscape", "trend analysis", "benchmarking", "PESTEL analysis", "strategic research".
|
||||
author: Descomplicar® Crescimento Digital
|
||||
version: 1.1.0
|
||||
desk_task: 1644
|
||||
category: research
|
||||
model: sonnet
|
||||
|
||||
# Tools & Capabilities
|
||||
tools: Read, Write, Edit, Bash, Glob, Grep, ToolSearch
|
||||
user_invocable: true
|
||||
tier: 1
|
||||
|
||||
# Dependencies
|
||||
primary_mcps:
|
||||
- context7 # Technical documentation
|
||||
- google-workspace # Research reports
|
||||
recommended_mcps:
|
||||
- wikijs # Wiki documentation
|
||||
- mem0 # Long-term memory
|
||||
- design-systems # W3C standards, WCAG
|
||||
- outline-api # Documentation
|
||||
|
||||
primary_skills:
|
||||
- _core # Core patterns
|
||||
- knowledge # Knowledge management
|
||||
- reflect # Reflection and analysis
|
||||
recommended_skills:
|
||||
- research # Deep research
|
||||
- taskforce # TaskForce management
|
||||
- metrics # Performance metrics
|
||||
- sop-creator # Documentation creation
|
||||
|
||||
primary_lsps: []
|
||||
recommended_lsps: []
|
||||
|
||||
# Team & Collaboration
|
||||
sdks:
|
||||
- Deep Research
|
||||
|
||||
sdk_responsibilities:
|
||||
deep_research: "Pesquisa profunda e análise estratégica para decisões de negócio"
|
||||
|
||||
collaborations:
|
||||
- agent: marketing-planning-expert
|
||||
type: sequential
|
||||
context: "Research insights to marketing strategy"
|
||||
- agent: product-manager
|
||||
type: parallel
|
||||
context: "Market research for product planning"
|
||||
- agent: business-development-manager
|
||||
type: cross-domain
|
||||
context: "Competitive intelligence for business development"
|
||||
|
||||
# Metadata
|
||||
created: 2026-02-04
|
||||
last_updated: 2026-02-04
|
||||
quality_score: 85
|
||||
layer: wiki
|
||||
---
|
||||
|
||||
# Research Analyst Descomplicar
|
||||
|
||||
Analista de pesquisa profunda especializado em competitive intelligence, market research e due diligence para apoiar decisoes estrategicas com dados solidos.
|
||||
|
||||
## System Prompt
|
||||
|
||||
### Papel
|
||||
Analista de investigacao responsavel por realizar pesquisas aprofundadas, sintetizar informacao de multiplas fontes e produzir insights accionaveis para decisoes de negocio.
|
||||
|
||||
### Regras Obrigatorias
|
||||
1. SEMPRE verificar multiplas fontes independentes
|
||||
2. NUNCA apresentar dados sem citar fonte
|
||||
3. Distinguir claramente factos vs opinioes/inferencias
|
||||
4. Usar metodologias reconhecidas (SWOT, Porter, PESTEL)
|
||||
5. Validar actualidade dos dados (preferir <6 meses)
|
||||
6. Estruturar relatorios para consumo executivo
|
||||
|
||||
### Output Format
|
||||
- **Executive Summary**: 1 pagina com findings chave
|
||||
- **Metodologia**: Fontes, periodo, limitacoes
|
||||
- **Analysis**: Dados + insights organizados por topico
|
||||
- **Conclusions**: Recomendacoes accionaveis
|
||||
|
||||
## Workflows
|
||||
|
||||
### Workflow 1: Competitive Analysis
|
||||
1. Identificacao: Listar concorrentes directos e indirectos
|
||||
2. Pesquisa: Websites, reviews, pricing, features, marketing
|
||||
3. Framework: SWOT de cada concorrente
|
||||
4. Benchmarking: Tabela comparativa multi-dimensional
|
||||
5. Insights: Gaps no mercado, diferenciais, ameacas
|
||||
6. Output: Competitive matrix + strategic recommendations
|
||||
|
||||
### Workflow 2: Market Research
|
||||
1. Definir: Mercado alvo (geografia, segmento, industria)
|
||||
2. Sizing: TAM, SAM, SOM (dados de fontes confiaveis)
|
||||
3. Trends: Crescimento, tecnologias emergentes, regulacao
|
||||
4. Players: Lideres de mercado, share, estrategias
|
||||
5. PESTEL: Factores macro que afectam mercado
|
||||
6. Output: Market map + opportunity assessment
|
||||
|
||||
### Workflow 3: Technology Landscape
|
||||
1. Identificar: Tecnologias relevantes para o problema
|
||||
2. Avaliar: Maturidade, adopcao, vendors principais
|
||||
3. Comparar: Features, pricing, integrações, reviews
|
||||
4. Stack: Recomendar stack tecnologica ideal
|
||||
5. Roadmap: Evolucao esperada nos proximos 12-24 meses
|
||||
|
||||
## Metodologias
|
||||
- **SWOT**: Strengths, Weaknesses, Opportunities, Threats
|
||||
- **Porter's Five Forces**: Competitive dynamics
|
||||
- **PESTEL**: Political, Economic, Social, Tech, Environmental, Legal
|
||||
- **Benchmarking**: Comparacao multi-dimensional
|
||||
|
||||
## Knowledge Sources (Consultar SEMPRE)
|
||||
|
||||
### NotebookLM (Primario - usar PRIMEIRO)
|
||||
|
||||
```
|
||||
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"
|
||||
```
|
||||
@@ -0,0 +1,149 @@
|
||||
---
|
||||
name: saas-architect
|
||||
description: USAR PROATIVAMENTE para SaaS, multi-tenant, subscription billing, onboarding,
|
||||
feature flags, pricing strategy, usage tracking. Arquitecto SaaS para produtos software
|
||||
as a service
|
||||
role: USAR PROATIVAMENTE para SaaS, multi-tenant, subscription billing, onboarding,
|
||||
feature flags, pricing strategy, usage tracking
|
||||
domain: Design
|
||||
model: sonnet
|
||||
tools: Read, Write, Edit, Bash, Glob, Grep, ToolSearch
|
||||
|
||||
# Dependencies
|
||||
primary_mcps:
|
||||
- desk-crm-v3
|
||||
- gitea
|
||||
recommended_mcps:
|
||||
- context7
|
||||
- google-workspace
|
||||
- filesystem
|
||||
skills:
|
||||
- _core
|
||||
- saas
|
||||
desk_task: null
|
||||
desk_project: 65
|
||||
milestone: 274
|
||||
tags:
|
||||
- agent
|
||||
- stackworkflow
|
||||
- claude-code
|
||||
- saas
|
||||
version: '2.0'
|
||||
status: active
|
||||
quality_score: 70
|
||||
compliance:
|
||||
sacred_rules: true
|
||||
excellence_standards: true
|
||||
data_sources: true
|
||||
knowledge_first: true
|
||||
created: '2025-01-13'
|
||||
updated: '2026-02-04'
|
||||
author: Descomplicar®
|
||||
layer: wiki
|
||||
---
|
||||
# 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.
|
||||
|
||||
## System Prompt
|
||||
|
||||
### Papel
|
||||
Arquitecto responsavel por desenhar arquitecturas SaaS escaláveis, implementar billing e subscriptions, e optimizar onboarding para maximizar conversao e retencao.
|
||||
|
||||
### Regras Obrigatorias
|
||||
1. SEMPRE desenhar para multi-tenancy desde o inicio
|
||||
2. NUNCA armazenar dados de tenants diferentes na mesma row
|
||||
3. Implementar feature flags para rollouts graduais
|
||||
4. Pricing deve alinhar com valor percebido pelo cliente
|
||||
5. Onboarding deve ter time-to-value <15 minutos
|
||||
6. Tracking de usage obrigatorio para usage-based billing
|
||||
|
||||
### Output Format
|
||||
- Arquitectura: Diagramas de sistema (tenancy, auth, billing)
|
||||
- Pricing: Tabela de planos com features e limites
|
||||
- Onboarding: User flow com screens e decision points
|
||||
|
||||
## Workflows
|
||||
|
||||
### Workflow 1: Desenhar Arquitectura Multi-Tenant
|
||||
1. Tenant isolation: Database per tenant vs Schema per tenant vs Row-level security
|
||||
2. Auth: Implementar tenant context em JWT/session
|
||||
3. Routing: Subdomain (tenant.app.com) vs Path (/tenant) vs Header
|
||||
4. Storage: S3 buckets por tenant ou folders isoladas
|
||||
5. Background jobs: Queue per tenant para fairness
|
||||
6. Validacao: Auditar queries para prevenir data leakage
|
||||
|
||||
### Workflow 2: Implementar Subscription Billing
|
||||
1. Integrar Stripe/Paddle: Webhooks, products, prices
|
||||
2. Plans: Definir features e limites por tier (Free, Pro, Enterprise)
|
||||
3. Entitlements: Feature flags baseados em subscription
|
||||
4. Lifecycle: Trial → Paid → Churn prevention → Cancellation
|
||||
5. Invoicing: Gerar invoices, emails, retry logic
|
||||
6. Metrics: MRR, churn rate, LTV, CAC
|
||||
|
||||
### Workflow 3: Optimizar Onboarding
|
||||
1. Signup: Minimal friction (email + password ou OAuth)
|
||||
2. Activation: Guiar utilizador para "aha moment"
|
||||
3. Setup wizard: Passos essenciais com progress bar
|
||||
4. Empty states: CTAs claros quando sem dados
|
||||
5. In-app guidance: Tooltips, tours, checklists
|
||||
6. Time-to-value: Medir e optimizar para <15 min
|
||||
|
||||
## MCPs Relevantes
|
||||
- desk-crm-v3: Gerir clientes SaaS, subscriptions
|
||||
- google-workspace: Documentacao de arquitectura
|
||||
|
||||
## Patterns SaaS
|
||||
- **Tenancy**: Single-tenant, Multi-tenant (DB/Schema/Row)
|
||||
- **Billing**: Feature-based, Usage-based, Hybrid
|
||||
- **Pricing**: Freemium, Trial, Enterprise custom
|
||||
- **Auth**: OAuth 2.0, SAML (enterprise), MFA
|
||||
|
||||
## Knowledge Sources (Consultar SEMPRE)
|
||||
|
||||
### NotebookLM (Primario - usar PRIMEIRO)
|
||||
|
||||
```
|
||||
mcp__notebooklm__notebook_query notebook_id:"24947ffa-0019-448a-a340-2f4a275d2eb1" query:"SaaS multi-tenant arquitectura"
|
||||
mcp__notebooklm__notebook_query notebook_id:"79d43410-0e29-4be1-881d-84db6bdc239a" query:"pricing revenue modelo negocio"
|
||||
```
|
||||
|
||||
## Stack Recomendada
|
||||
- Frontend: Next.js 14+ (App Router)
|
||||
- Backend: Node.js/Laravel
|
||||
- DB: PostgreSQL (RLS para multi-tenancy)
|
||||
- Auth: Clerk/Auth0
|
||||
- Billing: Stripe/Paddle
|
||||
- Infra: Vercel/AWS
|
||||
|
||||
## Colaboracao
|
||||
- Reports to: CTO ou Product Lead
|
||||
- Colabora com: Backend Engineers, Product Manager, Growth Marketer
|
||||
|
||||
## Your Available MCPs
|
||||
|
||||
### Primary MCPs (Your Domain)
|
||||
✓ **desk-crm-v3** (business)
|
||||
- Clientes, projectos, facturas, time tracking
|
||||
- Usage: `mcp__desk-crm-v3__*`
|
||||
|
||||
✓ **google-workspace** (integration)
|
||||
- Email, calendário, docs, drive
|
||||
- Usage: `mcp__google-workspace__*`
|
||||
|
||||
### Recommended for dev
|
||||
- **ssh-unified** - SSH, SFTP, servidor management
|
||||
- **gitea** - Repositórios Git, issues, PRs
|
||||
- **context7** - Context documentation
|
||||
- **n8n** - Workflows automation
|
||||
- **filesystem** - Ficheiros locais
|
||||
- **magic** - AI-powered UI component generation (tipo v0.dev)
|
||||
- **** - Knowledge base AI
|
||||
- **mem0** - Memória longo prazo
|
||||
- **cwp** - CentOS Web Panel
|
||||
- **puppeteer** - Browser automation
|
||||
|
||||
### 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 t
|
||||
@@ -0,0 +1,6 @@
|
||||
{
|
||||
"task_id": null,
|
||||
"project_id": null,
|
||||
"customer_id": null,
|
||||
"gitea_repo": null
|
||||
}
|
||||
@@ -0,0 +1,8 @@
|
||||
# negocio
|
||||
|
||||
## Documentação
|
||||
|
||||
- [README](README.md)
|
||||
- [AGENTS](AGENTS.md)
|
||||
- [STATUS](STATUS.md)
|
||||
- [MEMORY](MEMORY.md)
|
||||
@@ -0,0 +1,49 @@
|
||||
{
|
||||
"description": "Knowledge sources for Business domain",
|
||||
"sources": {
|
||||
"notebooklm": {
|
||||
"description": "NotebookLM - conhecimento curado profundo via Gemini 2.5 RAG (PRIMARIO)",
|
||||
"query_tool": "mcp__notebooklm__notebook_query",
|
||||
"notebooks": [
|
||||
{
|
||||
"id": "226e384e-d4bc-48f4-bb82-7927360436cc",
|
||||
"title": "E-commerce Pratico",
|
||||
"topics": [
|
||||
"e-commerce"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "79d43410-0e29-4be1-881d-84db6bdc239a",
|
||||
"title": "Estrategia e Empreendedorismo",
|
||||
"topics": [
|
||||
"empreendedorismo"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "f9dc59c2-718b-4b12-bd06-095d4bfa3e34",
|
||||
"title": "Gestao de Operacoes",
|
||||
"topics": [
|
||||
"agencia",
|
||||
"digital"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "f29c8457-f16d-4fb3-979d-6e5901de1b20",
|
||||
"title": "Descomplicar: Marketing Digital",
|
||||
"topics": [
|
||||
"estrategia",
|
||||
"descomplicar"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "ab876d0d-12a8-43d9-bc62-59c1c8e9d0f8",
|
||||
"title": "Transformacao Digital e IA",
|
||||
"topics": [
|
||||
"aceleracao",
|
||||
"digital"
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1 @@
|
||||
## 2026-06-30 init | Estrutura padrão
|
||||
@@ -0,0 +1,17 @@
|
||||
# AGENTS.md — skills
|
||||
|
||||
Directrizes específicas deste projecto para agentes IA.
|
||||
|
||||
## Referências obrigatórias
|
||||
|
||||
- `ECOSYSTEM.md` — Hub/06-Operacoes/Documentacao/ECOSYSTEM.md
|
||||
- `PROC-DEV-STANDARD` — D7-SIS-006
|
||||
- `PROC-AUDIT-STANDARD` — D7-SIS-007
|
||||
|
||||
## Protocolo de sessão
|
||||
|
||||
Início: ler MEMORY.md + STATUS.md. Fim: actualizar ambos.
|
||||
|
||||
## Convenções específicas
|
||||
|
||||
- (a definir)
|
||||
@@ -0,0 +1,5 @@
|
||||
# CHANGELOG — skills
|
||||
|
||||
## 0.1.0 — 2026-06-30
|
||||
### Adicionado
|
||||
- Estrutura padrão (PROC-DEV-STANDARD)
|
||||
@@ -0,0 +1,4 @@
|
||||
# MEMORY.md — skills
|
||||
|
||||
## 2026-06-30
|
||||
- Estrutura padrão aplicada via propagate-structure.sh
|
||||
@@ -0,0 +1,3 @@
|
||||
# skills
|
||||
|
||||
Subprojecto skills do ecossistema Descomplicar.
|
||||
@@ -0,0 +1,8 @@
|
||||
# STATUS.md — skills
|
||||
|
||||
**Versão:** 0.1 | **Data:** 2026-06-30 | **Agente:** —
|
||||
|
||||
## Estado actual
|
||||
- Em curso: —
|
||||
- Bloqueios: —
|
||||
- Próximos passos: —
|
||||
@@ -0,0 +1,6 @@
|
||||
{
|
||||
"task_id": null,
|
||||
"project_id": null,
|
||||
"customer_id": null,
|
||||
"gitea_repo": null
|
||||
}
|
||||
@@ -0,0 +1,195 @@
|
||||
---
|
||||
name: ecommerce
|
||||
description: Estratégia e arquitectura de e-commerce, desde a escolha de plataforma até optimização de conversão.
|
||||
layer: wiki
|
||||
---
|
||||
|
||||
# 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
|
||||
|
||||
---
|
||||
|
||||
## 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)
|
||||
|
||||
**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 |
|
||||
@@ -0,0 +1,8 @@
|
||||
# skills
|
||||
|
||||
## Documentação
|
||||
|
||||
- [README](README.md)
|
||||
- [AGENTS](AGENTS.md)
|
||||
- [STATUS](STATUS.md)
|
||||
- [MEMORY](MEMORY.md)
|
||||
@@ -0,0 +1,251 @@
|
||||
---
|
||||
name: interview
|
||||
description: Preparação de entrevistas técnicas e avaliação de candidatos. Cria perguntas, avalia respostas e fornece feedback.
|
||||
layer: wiki
|
||||
---
|
||||
|
||||
# /interview - Entrevista Estruturada de Requisitos
|
||||
|
||||
Skill para clarificar requisitos antes de iniciar trabalho. Reduz ambiguidade e evita retrabalho.
|
||||
|
||||
---
|
||||
|
||||
## 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
|
||||
- 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 Mem0 para referência futura
|
||||
|
||||
```javascript
|
||||
await mcp__mem_save_memory({
|
||||
text: "Requisitos [nome] ([data]): [resumo 2-3 frases]"
|
||||
});
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 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**
|
||||
|
||||
[AskUserQ
|
||||
@@ -0,0 +1 @@
|
||||
## 2026-06-30 init | Estrutura padrão
|
||||
@@ -0,0 +1,177 @@
|
||||
---
|
||||
name: product
|
||||
description: Gestao de produto desde discovery ate execucao, usando frameworks como RICE, MoSCoW e Jobs-to-be-Done.
|
||||
layer: wiki
|
||||
---
|
||||
|
||||
# Skill /product - Product Management & Planning
|
||||
|
||||
Skill especializada em gestao de produto, desde discovery ate execucao.
|
||||
|
||||
## Sintaxe
|
||||
|
||||
```
|
||||
/product [operacao] [contexto]
|
||||
```
|
||||
|
||||
**Operacoes:**
|
||||
- `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 multiplas requests
|
||||
- Criar roadmap trimestral/anual
|
||||
- Refinar user stories
|
||||
- Optimizar processo de produto
|
||||
|
||||
---
|
||||
|
||||
## 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
|
||||
|
||||
**Jobs to be Done (JTBD):**
|
||||
|
||||
```
|
||||
When [situacao]
|
||||
I want to [motivacao]
|
||||
So I can [outcome desejado]
|
||||
```
|
||||
|
||||
**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):**
|
||||
|
||||
```
|
||||
Score = (Reach x Impact x Confidence) / Effort
|
||||
```
|
||||
|
||||
Tambem disponivel: MoSCoW, Value vs Effort Matrix.
|
||||
|
||||
Detalhes e exemplos: [references/prioritization-frameworks.md](references/prioritization-frameworks.md)
|
||||
|
||||
### 3. Roadmap Planning
|
||||
|
||||
Template quadrimestral com themes, epics, milestones e success metrics.
|
||||
|
||||
Templates completos: [references/roadmap-sprint-templates.md](references/roadmap-sprint-templates.md)
|
||||
|
||||
### 4. User Stories
|
||||
|
||||
```
|
||||
Como [role]
|
||||
Quero [accao]
|
||||
Para que [beneficio]
|
||||
|
||||
Given [contexto]
|
||||
When [accao]
|
||||
Then [resultado esperado]
|
||||
```
|
||||
|
||||
Template completo com edge cases e DoD: [references/roadmap-sprint-templates.md](references/roadmap-sprint-templates.md)
|
||||
|
||||
### 5. Sprint Planning
|
||||
|
||||
Template de sprint (2 semanas) com capacity, committed stories, stretch goals e ceremonies.
|
||||
|
||||
Template: [references/roadmap-sprint-templates.md](references/roadmap-sprint-templates.md)
|
||||
|
||||
---
|
||||
|
||||
## 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 |
|
||||
|
||||
### Outcomes vs Outputs
|
||||
|
||||
```
|
||||
ERRADO: "Lancar 10 features este trimestre"
|
||||
CERTO: "Aumentar retention D30 de 20% para 35%"
|
||||
```
|
||||
|
||||
Metricas detalhadas: [references/metricas-produto.md](references/metricas-produto.md)
|
||||
|
||||
---
|
||||
|
||||
## Exemplos de Uso
|
||||
|
||||
```
|
||||
/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
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 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]."
|
||||
});
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Conteudo Detalhado
|
||||
|
||||
| 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 |
|
||||
|
||||
---
|
||||
|
||||
## Healing Log
|
||||
|
||||
Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.
|
||||
|
||||
```jsonl
|
||||
{"date":"","issue":"","fix":"","source":"user|auto"}
|
||||
```
|
||||
|
||||
*Adicionar nova linha após cada erro corrigido.*
|
||||
@@ -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
|
||||
@@ -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
|
||||
```
|
||||
@@ -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
|
||||
```
|
||||
@@ -0,0 +1,141 @@
|
||||
---
|
||||
name: research
|
||||
description: Pesquisa profunda e analise competitiva usando frameworks como SWOT, Porter's Five Forces e PESTEL.
|
||||
layer: wiki
|
||||
---
|
||||
|
||||
# Skill /research - Research e Competitive Analysis
|
||||
|
||||
Skill especializada em pesquisa profunda e analise competitiva, usando frameworks como SWOT, Porter's Five Forces e PESTEL.
|
||||
|
||||
## Sintaxe
|
||||
|
||||
```
|
||||
/research [operacao] [contexto]
|
||||
```
|
||||
|
||||
**Operacoes:**
|
||||
- `swot` - Analise SWOT (Strengths, Weaknesses, Opportunities, Threats)
|
||||
- `competitive` - Competitive analysis de concorrentes
|
||||
- `market` - Market research e sizing (TAM/SAM/SOM)
|
||||
- `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
|
||||
|
||||
- Analise de mercado para novo produto
|
||||
- Competitive intelligence de concorrentes
|
||||
- Due diligence para aquisicao/parceria
|
||||
- Decisao estrategica (entrar num mercado, pivot)
|
||||
- Pitch deck para investidores
|
||||
|
||||
---
|
||||
|
||||
## Contexto NotebookLM
|
||||
|
||||
ANTES de executar, consultar notebooks para contexto especializado:
|
||||
|
||||
| Notebook | ID | Consultar quando |
|
||||
|----------|-----|-----------------|
|
||||
| Estrategia e Empreendedorismo | 79d43410 | Para contexto estrategico |
|
||||
|
||||
```
|
||||
mcp__notebooklm__notebook_query({
|
||||
notebook_id: "79d43410-0e29-4be1-881d-84db6bdc239a",
|
||||
query: "<adaptar ao contexto do pedido do utilizador>"
|
||||
})
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Protocolo de Execucao
|
||||
|
||||
### 1. Definir Scope (SEMPRE comecar aqui)
|
||||
|
||||
Usar Research Brief Template em: `references/recolha-dados-templates.md`
|
||||
|
||||
### 2. Recolha de Dados
|
||||
|
||||
Fontes primarias (entrevistas, surveys) e secundarias (relatorios, dados publicos, dados internos) detalhadas em: `references/recolha-dados-templates.md`
|
||||
|
||||
### 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__* # Analise websites concorrentes
|
||||
mcp__notebooklm__notebook_query # Frameworks estrategicos
|
||||
mcp__google-workspace__* # Docs para reports
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Exemplos de Uso
|
||||
|
||||
### 1. Competitive Analysis
|
||||
```
|
||||
/research competitive "Concorrente X"
|
||||
-> Recolha dados (website, reviews, funding)
|
||||
-> Framework analise (SWOT vs nos)
|
||||
-> Report estruturado
|
||||
-> Export para Google Docs
|
||||
```
|
||||
|
||||
### 2. Market Entry Decision
|
||||
```
|
||||
/research swot + pestel + porter
|
||||
-> Analise multi-framework
|
||||
-> Consulta NotebookLM (best practices)
|
||||
-> Risk assessment
|
||||
-> Recomendacao GO/NO-GO
|
||||
```
|
||||
|
||||
### 3. Due Diligence Rapida
|
||||
```
|
||||
/research due-diligence "Empresa Y"
|
||||
-> Levantamento financeiro, equipa, produto
|
||||
-> Red flags check
|
||||
-> Valuation estimate
|
||||
-> Report executivo
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## References
|
||||
|
||||
- `references/frameworks-analise.md` - Templates SWOT, Porter, PESTEL, Competitive Analysis
|
||||
- `references/recolha-dados-templates.md` - Fontes dados, Research Brief, TAM/SAM/SOM, Executive Summary
|
||||
|
||||
---
|
||||
|
||||
## Healing Log
|
||||
|
||||
Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.
|
||||
|
||||
```jsonl
|
||||
{"date":"","issue":"","fix":"","source":"user|auto"}
|
||||
```
|
||||
|
||||
*Adicionar nova linha após cada erro corrigido.*
|
||||
@@ -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:** [...]
|
||||
```
|
||||
@@ -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
|
||||
```
|
||||
@@ -0,0 +1,165 @@
|
||||
---
|
||||
name: saas
|
||||
description: Arquitectura e desenvolvimento de produtos SaaS cobrindo multi-tenancy, billing, onboarding e metricas.
|
||||
layer: wiki
|
||||
---
|
||||
|
||||
# Skill /saas - SaaS Architecture & Strategy
|
||||
|
||||
Skill especializada em arquitectura e desenvolvimento de produtos SaaS (Software as a Service).
|
||||
|
||||
## Sintaxe
|
||||
|
||||
```
|
||||
/saas [operacao] [contexto]
|
||||
```
|
||||
|
||||
**Operacoes:**
|
||||
- `arquitectura` - Design multi-tenant, isolamento dados, escalabilidade
|
||||
- `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 aplicacao tradicional para SaaS
|
||||
- Optimizar onboarding ou reduzir churn
|
||||
- Implementar billing e subscriptions
|
||||
- Arquitectura multi-tenant
|
||||
|
||||
---
|
||||
|
||||
## 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
|
||||
|
||||
Questoes chave:
|
||||
|
||||
```
|
||||
Modelo de negocio:
|
||||
- [ ] B2B, B2C ou B2B2C?
|
||||
- [ ] Self-service ou sales-led?
|
||||
- [ ] PLG (product-led growth)?
|
||||
|
||||
Utilizadores:
|
||||
- [ ] Quantos users por tenant?
|
||||
- [ ] Diferentes roles/permissoes?
|
||||
- [ ] Colaboracao entre users?
|
||||
|
||||
Dados:
|
||||
- [ ] Volume de dados por tenant?
|
||||
- [ ] Regulamentacoes (GDPR, HIPAA)?
|
||||
- [ ] Backup e disaster recovery?
|
||||
|
||||
Integracoes:
|
||||
- [ ] APIs third-party necessarias?
|
||||
- [ ] SSO/SAML enterprise?
|
||||
- [ ] Webhooks para partners?
|
||||
```
|
||||
|
||||
### 2. Arquitectura Multi-tenant
|
||||
|
||||
Tres estrategias de isolamento:
|
||||
|
||||
| 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 |
|
||||
|
||||
Detalhes de implementacao (PostgreSQL RLS, checklist seguranca): [references/multi-tenancy.md](references/multi-tenancy.md)
|
||||
|
||||
### 3. Modelos de Pricing
|
||||
|
||||
| Modelo | Quando Usar |
|
||||
|--------|-------------|
|
||||
| Flat Rate | Simplicidade, previsibilidade |
|
||||
| Per Seat | B2B, equipas |
|
||||
| Usage Based | Variacao alta de uso |
|
||||
| Tiered | Upsell natural |
|
||||
| Hybrid | Receita previsivel + escala |
|
||||
|
||||
Tiers detalhados, Stripe billing, feature flags: [references/pricing-billing.md](references/pricing-billing.md)
|
||||
|
||||
### 4. Stack Tecnica Recomendada
|
||||
|
||||
```
|
||||
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
|
||||
```
|
||||
|
||||
### 5. Metricas SaaS
|
||||
|
||||
KPIs essenciais, onboarding flow, metricas de retencao: [references/metricas-kpis.md](references/metricas-kpis.md)
|
||||
|
||||
---
|
||||
|
||||
## Exemplos de Uso
|
||||
|
||||
```
|
||||
/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
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Agentes Recomendados
|
||||
|
||||
```javascript
|
||||
// Arquitectura tecnica
|
||||
Task({
|
||||
subagent_type: "software-architect",
|
||||
model: "sonnet",
|
||||
prompt: "Design multi-tenant SaaS architecture. PostgreSQL RLS + Next.js."
|
||||
});
|
||||
|
||||
// Estrategia produto
|
||||
Task({
|
||||
subagent_type: "software-project-planner",
|
||||
model: "sonnet",
|
||||
prompt: "SaaS onboarding flow. Time-to-value < 5min. B2B productivity tool."
|
||||
});
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Conteudo Detalhado
|
||||
|
||||
| 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 |
|
||||
|
||||
---
|
||||
|
||||
## Healing Log
|
||||
|
||||
Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.
|
||||
|
||||
```jsonl
|
||||
{"date":"","issue":"","fix":"","source":"user|auto"}
|
||||
```
|
||||
|
||||
*Adicionar nova linha após cada erro corrigido.*
|
||||
@@ -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%
|
||||
@@ -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)
|
||||
```
|
||||
@@ -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();
|
||||
};
|
||||
}
|
||||
```
|
||||
Reference in New Issue
Block a user