claude-plugins/negocio/skills/product/SKILL.md

name, description, author, version, quality_score, user_invocable, desk_task, allowed-tools

name	description	author	version	quality_score	user_invocable	desk_task	allowed-tools
product	Skill especializada em gestão de produto, desde discovery até execução, usando frameworks como RICE, MoSCoW e Jobs-to-be-Done.	Descomplicar® Crescimento Digital	2.0.0	55	true	null	Read, Task

Skill /product - Product Management & Planning

Skill especializada em gestão de produto, desde discovery até execução, usando frameworks como RICE, MoSCoW e Jobs-to-be-Done.

Sintaxe

/product [operacao] [contexto]

Operações:

• discovery - Problem space, jobs-to-be-done, validation
• prioritize - RICE scoring, MoSCoW, value/effort matrix
• roadmap - Planeamento quadrimestral, epics, milestones
• backlog - User stories, acceptance criteria, refinement
• sprint - Sprint planning, capacity, DoD

Quando Usar

• Planear novo produto ou feature
• Priorizar backlog com múltiplas requests
• Criar roadmap trimestral/anual
• Refinar user stories
• Optimizar processo de produto

---

Protocolo de Execução

1. Product Discovery

Problem Space (não Solution Space):

## Jobs to be Done (JTBD)

When [situação]
I want to [motivação]
So I can [outcome desejado]

### Exemplo:
When I need to share a report with my team
I want to export to PDF with custom branding
So I can present professional documents to stakeholders

Pain Points Discovery:

Perguntas a fazer:
1. O que frustra o utilizador actualmente?
2. Que workarounds usa hoje?
3. Quanto tempo/dinheiro perde com o problema?
4. Qual a frequência do problema?
5. O que tentou fazer para resolver?

Evidência:
- [ ] 5+ entrevistas com users
- [ ] Analytics de uso (onde abandonam?)
- [ ] Tickets de suporte relacionados
- [ ] Pesquisa concorrência (como resolvem?)

Validation Framework:

┌─────────────────────────────────────────────────┐
│ DESIRABILITY (Users querem?)                    │
├─────────────────────────────────────────────────┤
│ ☐ Problem interviews (10+)                      │
│ ☐ Solution interviews (5+)                      │
│ ☐ Survey (50+ respostas)                        │
│ ☐ Prototype test (usability)                    │
│ Evidence: X% users pagaria, Y% usaria diário    │
└─────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────┐
│ VIABILITY (Negócio faz sentido?)                │
├─────────────────────────────────────────────────┤
│ ☐ Market size (TAM/SAM/SOM)                     │
│ ☐ Revenue model claro                           │
│ ☐ Unit economics positivos                      │
│ ☐ Payback period aceitável                      │
│ Target: ROI > 3x em 12 meses                    │
└─────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────┐
│ FEASIBILITY (Conseguimos construir?)            │
├─────────────────────────────────────────────────┤
│ ☐ Technical spike completo                      │
│ ☐ Dependencies mapeadas                         │
│ ☐ Resources disponíveis                         │
│ ☐ Timeline realista                             │
│ Risk assessment: Alto/Médio/Baixo               │
└─────────────────────────────────────────────────┘

2. Prioritization Frameworks

A. RICE Score (Recomendado)

        Reach × Impact × Confidence
Score = ─────────────────────────────
                 Effort

Reach: Quantos users impactados por período
  - Ex: 1000 users/quarter, 500 users/month

Impact: Quanto impacto por user
  - 3 = Massive impact
  - 2 = High impact
  - 1 = Medium impact
  - 0.5 = Low impact
  - 0.25 = Minimal impact

Confidence: Certeza das estimativas
  - 100% = Dados sólidos
  - 80% = Boas evidências
  - 50% = Suposições educadas

Effort: Person-months para entregar
  - Ex: 2 person-months, 0.5 person-month

Exemplo Prático:

Feature	Reach	Impact	Confidence	Effort	RICE	Prioridade
Export PDF	800/q	2	80%	1	1280	🟢 Alta
Dark mode	400/q	0.5	100%	0.5	400	🟡 Média
API v2	200/q	3	50%	3	100	🔴 Baixa
Search filters	1000/q	1	80%	0.5	1600	🟢 Alta

B. MoSCoW Method

MUST have: Crítico para launch (MVP)
  - Sem isso, produto não funciona
  - Legal/compliance obrigatório
  - Blocker absoluto

SHOULD have: Importante mas não crítico
  - Melhora significativamente a experiência
  - Workaround existe
  - Pode ser adiado 1 sprint

COULD have: Nice to have
  - Pequena melhoria
  - Se sobrar tempo
  - Low effort/low impact

WON'T have (agora): Fora de scope
  - Para próxima versão
  - Não alinhado com objectivo actual

C. Value vs Effort Matrix

         │ HIGH VALUE
         │
    II   │   I
  Quick  │  Big
  Wins   │  Bets
  (DO)   │ (PLAN)
─────────┼─────────
   III   │   IV
  Fill   │  Money
  Ins    │  Pit
 (LATER) │ (AVOID)
         │
         │ LOW VALUE
    LOW EFFORT → HIGH EFFORT

3. Roadmap Planning

Template Quadrimestral:

# Product Roadmap Q1-Q3 2026

## Q1 (Jan-Abr): Foundation
**Theme:** Stabilize core + basic integrations
**Goal:** 100 active users, NPS > 40

### Epic 1: Core Functionality Polish
- [ ] Performance optimization (< 2s load)
- [ ] Mobile responsive
- [ ] Error handling robusto

### Epic 2: Basic Integrations
- [ ] Slack notifications
- [ ] Google Calendar sync
- [ ] Email templates

**Milestone:** MVP Launch (31 Mar)
**Success Metrics:**
- 50 signups/week
- 40% activation rate
- < 10% churn

---

## Q2 (Mai-Ago): Growth
**Theme:** Expand features + virality
**Goal:** 500 active users, NPS > 50

### Epic 3: Collaboration Features
- [ ] Team workspaces
- [ ] Comments & mentions
- [ ] Activity feed

### Epic 4: Growth Loops
- [ ] Invite system (referral)
- [ ] Public templates gallery
- [ ] Embeddable widgets

**Milestone:** Product-Market Fit (31 Ago)
**Success Metrics:**
- 1000 signups total
- 50% M1 retention
- NRR > 100%

---

## Q3 (Set-Dez): Scale
**Theme:** Enterprise readiness
**Goal:** 2000 active users, ARR > 100k€

### Epic 5: Enterprise Features
- [ ] SSO/SAML
- [ ] Advanced permissions
- [ ] Audit logs
- [ ] Custom branding

### Epic 6: API & Integrations
- [ ] Public API v1
- [ ] Zapier integration
- [ ] Webhooks

**Milestone:** Enterprise Ready (31 Dez)
**Success Metrics:**
- 5 enterprise clients (>100€/mês)
- API adoption > 20%
- Support tickets < 5/100 users

4. User Stories & Acceptance Criteria

Template:

## US-123: Export dashboard to PDF

### User Story
Como [Product Manager]
Quero [exportar dashboard para PDF com branding personalizado]
Para que [possa partilhar relatórios profissionais com stakeholders externos]

### Context
- Users pedem isto em 60% dos support tickets
- Concorrentes já têm (Competitor A, B)
- Workaround actual: screenshots (não profissional)

### Acceptance Criteria
Given [estou no dashboard com dados carregados]
When [clico em "Export PDF"]
Then [sistema gera PDF em < 5s com:
  - Logo da empresa
  - Data do relatório
  - Todos os gráficos (vectorial)
  - Tabela de dados resumida
  - Footer com marca d'água Descomplicar]

And [recebo notificação quando PDF pronto]
And [posso fazer download ou enviar por email]

### Edge Cases
- [ ] Dashboard sem dados → mostrar "No data" no PDF
- [ ] Dashboard com 100+ items → paginar automaticamente
- [ ] Logo não carregado → usar placeholder

### Definition of Done
- [ ] Código completo e reviewed
- [ ] Testes unitários (> 80% coverage)
- [ ] Testes E2E (happy path + edge cases)
- [ ] Documentação API actualizada
- [ ] Changelog entry
- [ ] Deployed to staging
- [ ] QA sign-off
- [ ] Product Manager review

### Effort Estimate
Story Points: 5 (Fibonacci: 1, 2, 3, 5, 8, 13)
Dev: 2 days
QA: 0.5 days
Total: 2.5 days

5. Sprint Planning

Template Sprint (2 semanas):

# Sprint 23 (3-14 Fev 2026)

## Sprint Goal
"Users podem exportar dashboards profissionais e partilhar com stakeholders"

## Team Capacity
- 3 developers × 8 days = 24 person-days
- Velocity média: 25 story points/sprint
- Buffer para bugs/support: 20% → 20 SP disponíveis

## Committed Stories

### 🎯 Must Have (MVP sprint)
- [ ] US-123: Export PDF (5 SP) - @dev1
- [ ] US-124: Email sharing (3 SP) - @dev2
- [ ] US-125: Custom branding settings (3 SP) - @dev3

### 🚀 Should Have (se tempo)
- [ ] US-126: Schedule exports (5 SP)
- [ ] US-127: Export templates (3 SP)

### 🐛 Bugs Críticos
- [ ] BUG-45: Login timeout (2 SP) - @dev1

**Total Committed:** 13 SP
**Stretch Goals:** 8 SP
**Total Possível:** 21 SP

## Definition of Done (Sprint)
- [ ] Todas as US committed DONE
- [ ] Zero bugs críticos open
- [ ] Test coverage > 80%
- [ ] Docs actualizadas
- [ ] Demo preparada para stakeholders
- [ ] Retrospective completa

## Ceremonies
- Planning: Seg 3 Fev, 10h-12h
- Daily: 9h30 (15 min)
- Refinement: Qua 7 Fev, 14h-16h
- Review: Sex 14 Fev, 14h-15h
- Retrospective: Sex 14 Fev, 15h-16h

---

Métricas de Produto

Acquisition (AARRR Pirate Metrics)

Fase	Métrica	Target
Acquisition	Signups/semana	+20%/mês
Activation	Setup completo	> 40%
Retention	D7 retention	> 30%
Revenue	Conversion free→paid	> 3%
Referral	NPS	> 40

Product Health

Engagement:
- DAU/MAU ratio (stickiness): > 20%
- Session duration: Sector-dependent
- Features usado/session: > 3

Adoption:
- Time to first value: < 10 min
- Feature adoption (30 dias): > 30%
- Power users (5+ dias/semana): > 10%

Quality:
- Error rate: < 1%
- Support tickets/100 users: < 5
- CSAT: > 4/5

Outcomes vs Outputs

❌ ERRADO (Output-driven):
"Lançar 10 features este trimestre"

✅ CERTO (Outcome-driven):
"Aumentar retention D30 de 20% para 35% (via engagement features)"

Medir:
- North Star Metric (ex: DAU/MAU)
- Leading indicators (ex: time-to-value)
- Lagging indicators (ex: churn)

---

Consultar Datasets Dify

SEMPRE antes de decidir features:

Dataset	ID	Query Exemplo
Gestão de Processos	cae2a27e-f5bc-4d75-8a7a-9f83064f2512	"product discovery user interviews"
Estratégia	7d1d1d21-bc05-43d8-ab8f-6b7b90dafc28	"roadmap planning okr metrics"
Gestão de Projectos	b10a9418-bcb4-4e4c-b1f8-e64c88bedc04	"sprint planning scrum velocity"

Como Consultar

// Product discovery best practices
mcp__notebooklm__notebook_query, mcp__dify-kb__dify_kb_retrieve_segments({
  dataset_id: "cae2a27e-f5bc-4d75-8a7a-9f83064f2512",
  query: "product discovery validation framework jobs to be done",
  retrieval_mode: "hybrid_search",
  top_k: 5
});

// Prioritização e roadmaps
mcp__dify-kb__dify_kb_retrieve_segments({
  dataset_id: "7d1d1d21-bc05-43d8-ab8f-6b7b90dafc28",
  query: "priorizar features rice moscow roadmap",
  retrieval_mode: "hybrid_search",
  top_k: 5
});

---

MCPs Utilizados

mcp__desk-crm-v3__*                  # Gestão projectos e tarefas
mcp__dify-kb__dify_kb_retrieve_segments  # Conhecimento metodologias

---

Exemplos de Uso

1. Discovery Nova Feature

/product discovery
→ Problem space exploration
→ Jobs-to-be-done framework
→ Validation checklist (desirability/viability/feasibility)
→ Decision: Build / No Build

2. Prioritização Backlog

/product prioritize
→ Lista features candidatas
→ RICE scoring interactivo
→ Ranking final
→ Export para Desk CRM

3. Roadmap Trimestral

/product roadmap
→ Objectivos Q1/Q2/Q3
→ Epics e milestones
→ Success metrics
→ Output Markdown para Obsidian

---

Agentes Recomendados

// Planeamento produto
Task({
  subagent_type: "software-project-planner",
  model: "sonnet",
  prompt: "Create product roadmap Q1 2026. Focus: B2B SaaS collaboration tool."
});

// Research & validation
Task({
  subagent_type: "research-analyst",
  model: "sonnet",
  prompt: "Analyse competitor features. Product: [X]. Competitors: [A, B, C]."
});

---

Instrumentação Automática

Query para Gravar (executar no final)

INSERT INTO tblskill_agent_metrics (
  type, name, duration_ms, status, staff_id,
  kb_consulted, kb_cache_hit, tool_calls, project_id
) VALUES (
  'skill', '/product', {DURACAO_MS}, '{STATUS}', 25,
  {KB_CONSULTADO}, {CACHE_HIT}, {TOOL_CALLS}, {PROJECT_ID}
);

---

Versão: 2.0.0 | Data: 2026-02-03 | Autor: Descomplicar® Instrumentação: Activa