diff --git a/negocio/.claude-plugin/plugin.json b/negocio/.claude-plugin/plugin.json new file mode 100644 index 0000000..0f496c7 --- /dev/null +++ b/negocio/.claude-plugin/plugin.json @@ -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"] +} diff --git a/negocio/AGENTS.md b/negocio/AGENTS.md new file mode 100644 index 0000000..c89ac29 --- /dev/null +++ b/negocio/AGENTS.md @@ -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) diff --git a/negocio/CHANGELOG.md b/negocio/CHANGELOG.md new file mode 100644 index 0000000..95b5063 --- /dev/null +++ b/negocio/CHANGELOG.md @@ -0,0 +1,5 @@ +# CHANGELOG — negocio + +## 0.1.0 — 2026-06-30 +### Adicionado +- Estrutura padrão (PROC-DEV-STANDARD) diff --git a/negocio/MEMORY.md b/negocio/MEMORY.md new file mode 100644 index 0000000..411ffa2 --- /dev/null +++ b/negocio/MEMORY.md @@ -0,0 +1,4 @@ +# MEMORY.md — negocio + +## 2026-06-30 +- Estrutura padrão aplicada via propagate-structure.sh diff --git a/negocio/README.md b/negocio/README.md new file mode 100644 index 0000000..0538e24 --- /dev/null +++ b/negocio/README.md @@ -0,0 +1,3 @@ +# negocio + +Subprojecto negocio do ecossistema Descomplicar. diff --git a/negocio/STATUS.md b/negocio/STATUS.md new file mode 100644 index 0000000..da8ed8b --- /dev/null +++ b/negocio/STATUS.md @@ -0,0 +1,8 @@ +# STATUS.md — negocio + +**Versão:** 0.1 | **Data:** 2026-06-30 | **Agente:** — + +## Estado actual +- Em curso: — +- Bloqueios: — +- Próximos passos: — diff --git a/negocio/agents/AGENTS.md b/negocio/agents/AGENTS.md new file mode 100644 index 0000000..e6608c3 --- /dev/null +++ b/negocio/agents/AGENTS.md @@ -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) diff --git a/negocio/agents/CHANGELOG.md b/negocio/agents/CHANGELOG.md new file mode 100644 index 0000000..c7fefdf --- /dev/null +++ b/negocio/agents/CHANGELOG.md @@ -0,0 +1,5 @@ +# CHANGELOG — agents + +## 0.1.0 — 2026-06-30 +### Adicionado +- Estrutura padrão (PROC-DEV-STANDARD) diff --git a/negocio/agents/MEMORY.md b/negocio/agents/MEMORY.md new file mode 100644 index 0000000..c42153f --- /dev/null +++ b/negocio/agents/MEMORY.md @@ -0,0 +1,4 @@ +# MEMORY.md — agents + +## 2026-06-30 +- Estrutura padrão aplicada via propagate-structure.sh diff --git a/negocio/agents/README.md b/negocio/agents/README.md new file mode 100644 index 0000000..d3e531d --- /dev/null +++ b/negocio/agents/README.md @@ -0,0 +1,3 @@ +# agents + +Subprojecto agents do ecossistema Descomplicar. diff --git a/negocio/agents/STATUS.md b/negocio/agents/STATUS.md new file mode 100644 index 0000000..05ba326 --- /dev/null +++ b/negocio/agents/STATUS.md @@ -0,0 +1,8 @@ +# STATUS.md — agents + +**Versão:** 0.1 | **Data:** 2026-06-30 | **Agente:** — + +## Estado actual +- Em curso: — +- Bloqueios: — +- Próximos passos: — diff --git a/negocio/agents/desk.project b/negocio/agents/desk.project new file mode 100644 index 0000000..5678920 --- /dev/null +++ b/negocio/agents/desk.project @@ -0,0 +1,6 @@ +{ + "task_id": null, + "project_id": null, + "customer_id": null, + "gitea_repo": null +} diff --git a/negocio/agents/ecommerce-architect.md b/negocio/agents/ecommerce-architect.md new file mode 100644 index 0000000..3b8fedd --- /dev/null +++ b/negocio/agents/ecommerce-architect.md @@ -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:"" +mcp__notebooklm__notebook_query notebook_id:"76647e0f-3ae2-4c00-a0a8-f457aebf5655" query:"" +``` +- 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 \ No newline at end of file diff --git a/negocio/agents/finance-manager.md b/negocio/agents/finance-manager.md new file mode 100644 index 0000000..9735160 --- /dev/null +++ b/negocio/agents/finance-manager.md @@ -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 \ No newline at end of file diff --git a/negocio/agents/index.md b/negocio/agents/index.md new file mode 100644 index 0000000..00c027f --- /dev/null +++ b/negocio/agents/index.md @@ -0,0 +1,8 @@ +# agents + +## Documentação + +- [README](README.md) +- [AGENTS](AGENTS.md) +- [STATUS](STATUS.md) +- [MEMORY](MEMORY.md) diff --git a/negocio/agents/log.md b/negocio/agents/log.md new file mode 100644 index 0000000..66e9c4d --- /dev/null +++ b/negocio/agents/log.md @@ -0,0 +1 @@ +## 2026-06-30 init | Estrutura padrão diff --git a/negocio/agents/research-analyst.md b/negocio/agents/research-analyst.md new file mode 100644 index 0000000..0c3434d --- /dev/null +++ b/negocio/agents/research-analyst.md @@ -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" +``` diff --git a/negocio/agents/saas-architect.md b/negocio/agents/saas-architect.md new file mode 100644 index 0000000..2bf68cd --- /dev/null +++ b/negocio/agents/saas-architect.md @@ -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 \ No newline at end of file diff --git a/negocio/desk.project b/negocio/desk.project new file mode 100644 index 0000000..5678920 --- /dev/null +++ b/negocio/desk.project @@ -0,0 +1,6 @@ +{ + "task_id": null, + "project_id": null, + "customer_id": null, + "gitea_repo": null +} diff --git a/negocio/index.md b/negocio/index.md new file mode 100644 index 0000000..391fa52 --- /dev/null +++ b/negocio/index.md @@ -0,0 +1,8 @@ +# negocio + +## Documentação + +- [README](README.md) +- [AGENTS](AGENTS.md) +- [STATUS](STATUS.md) +- [MEMORY](MEMORY.md) diff --git a/negocio/knowledge/datasets.json b/negocio/knowledge/datasets.json new file mode 100644 index 0000000..715229e --- /dev/null +++ b/negocio/knowledge/datasets.json @@ -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" + ] + } + ] + } + } +} diff --git a/negocio/log.md b/negocio/log.md new file mode 100644 index 0000000..66e9c4d --- /dev/null +++ b/negocio/log.md @@ -0,0 +1 @@ +## 2026-06-30 init | Estrutura padrão diff --git a/negocio/skills/AGENTS.md b/negocio/skills/AGENTS.md new file mode 100644 index 0000000..37d90a2 --- /dev/null +++ b/negocio/skills/AGENTS.md @@ -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) diff --git a/negocio/skills/CHANGELOG.md b/negocio/skills/CHANGELOG.md new file mode 100644 index 0000000..5e14603 --- /dev/null +++ b/negocio/skills/CHANGELOG.md @@ -0,0 +1,5 @@ +# CHANGELOG — skills + +## 0.1.0 — 2026-06-30 +### Adicionado +- Estrutura padrão (PROC-DEV-STANDARD) diff --git a/negocio/skills/MEMORY.md b/negocio/skills/MEMORY.md new file mode 100644 index 0000000..4971060 --- /dev/null +++ b/negocio/skills/MEMORY.md @@ -0,0 +1,4 @@ +# MEMORY.md — skills + +## 2026-06-30 +- Estrutura padrão aplicada via propagate-structure.sh diff --git a/negocio/skills/README.md b/negocio/skills/README.md new file mode 100644 index 0000000..2ad232f --- /dev/null +++ b/negocio/skills/README.md @@ -0,0 +1,3 @@ +# skills + +Subprojecto skills do ecossistema Descomplicar. diff --git a/negocio/skills/STATUS.md b/negocio/skills/STATUS.md new file mode 100644 index 0000000..07c1590 --- /dev/null +++ b/negocio/skills/STATUS.md @@ -0,0 +1,8 @@ +# STATUS.md — skills + +**Versão:** 0.1 | **Data:** 2026-06-30 | **Agente:** — + +## Estado actual +- Em curso: — +- Bloqueios: — +- Próximos passos: — diff --git a/negocio/skills/desk.project b/negocio/skills/desk.project new file mode 100644 index 0000000..5678920 --- /dev/null +++ b/negocio/skills/desk.project @@ -0,0 +1,6 @@ +{ + "task_id": null, + "project_id": null, + "customer_id": null, + "gitea_repo": null +} diff --git a/negocio/skills/ecommerce/SKILL.md b/negocio/skills/ecommerce/SKILL.md new file mode 100644 index 0000000..71effd6 --- /dev/null +++ b/negocio/skills/ecommerce/SKILL.md @@ -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: "" +}) +``` + +``` +mcp__notebooklm__notebook_query({ + notebook_id: "8a430cf2-ed99-413d-b4bf-a1400deaf49e", + query: "" +}) +``` + +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 | \ No newline at end of file diff --git a/negocio/skills/index.md b/negocio/skills/index.md new file mode 100644 index 0000000..1d7c6b4 --- /dev/null +++ b/negocio/skills/index.md @@ -0,0 +1,8 @@ +# skills + +## Documentação + +- [README](README.md) +- [AGENTS](AGENTS.md) +- [STATUS](STATUS.md) +- [MEMORY](MEMORY.md) diff --git a/negocio/skills/interview/SKILL.md b/negocio/skills/interview/SKILL.md new file mode 100644 index 0000000..12b283b --- /dev/null +++ b/negocio/skills/interview/SKILL.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: "" +}) +``` + +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 \ No newline at end of file diff --git a/negocio/skills/log.md b/negocio/skills/log.md new file mode 100644 index 0000000..66e9c4d --- /dev/null +++ b/negocio/skills/log.md @@ -0,0 +1 @@ +## 2026-06-30 init | Estrutura padrão diff --git a/negocio/skills/product/SKILL.md b/negocio/skills/product/SKILL.md new file mode 100644 index 0000000..3110a42 --- /dev/null +++ b/negocio/skills/product/SKILL.md @@ -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: "" +}) +``` + +--- + +## 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.* diff --git a/negocio/skills/product/references/metricas-produto.md b/negocio/skills/product/references/metricas-produto.md new file mode 100644 index 0000000..499d29d --- /dev/null +++ b/negocio/skills/product/references/metricas-produto.md @@ -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 diff --git a/negocio/skills/product/references/prioritization-frameworks.md b/negocio/skills/product/references/prioritization-frameworks.md new file mode 100644 index 0000000..a6f7bb6 --- /dev/null +++ b/negocio/skills/product/references/prioritization-frameworks.md @@ -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 +``` diff --git a/negocio/skills/product/references/roadmap-sprint-templates.md b/negocio/skills/product/references/roadmap-sprint-templates.md new file mode 100644 index 0000000..9e44164 --- /dev/null +++ b/negocio/skills/product/references/roadmap-sprint-templates.md @@ -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 +``` diff --git a/negocio/skills/research/SKILL.md b/negocio/skills/research/SKILL.md new file mode 100644 index 0000000..0de7e96 --- /dev/null +++ b/negocio/skills/research/SKILL.md @@ -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: "" +}) +``` + +--- + +## 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.* diff --git a/negocio/skills/research/references/frameworks-analise.md b/negocio/skills/research/references/frameworks-analise.md new file mode 100644 index 0000000..712f2bc --- /dev/null +++ b/negocio/skills/research/references/frameworks-analise.md @@ -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:** [...] +``` diff --git a/negocio/skills/research/references/recolha-dados-templates.md b/negocio/skills/research/references/recolha-dados-templates.md new file mode 100644 index 0000000..d0f44e4 --- /dev/null +++ b/negocio/skills/research/references/recolha-dados-templates.md @@ -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 +``` diff --git a/negocio/skills/saas/SKILL.md b/negocio/skills/saas/SKILL.md new file mode 100644 index 0000000..209e161 --- /dev/null +++ b/negocio/skills/saas/SKILL.md @@ -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: "" +}) +``` + +--- + +## 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.* diff --git a/negocio/skills/saas/references/metricas-kpis.md b/negocio/skills/saas/references/metricas-kpis.md new file mode 100644 index 0000000..8e11a8b --- /dev/null +++ b/negocio/skills/saas/references/metricas-kpis.md @@ -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% diff --git a/negocio/skills/saas/references/multi-tenancy.md b/negocio/skills/saas/references/multi-tenancy.md new file mode 100644 index 0000000..69a17bd --- /dev/null +++ b/negocio/skills/saas/references/multi-tenancy.md @@ -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) +``` diff --git a/negocio/skills/saas/references/pricing-billing.md b/negocio/skills/saas/references/pricing-billing.md new file mode 100644 index 0000000..4d426bc --- /dev/null +++ b/negocio/skills/saas/references/pricing-billing.md @@ -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(); + }; +} +```