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

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

# Skill /product - Product Management & Planning

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

## Sintaxe

```
/product [operacao] [contexto]
```

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

## Quando Usar

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

---

## Protocolo de Execução

### 1. Product Discovery

**Problem Space (não Solution Space):**

```markdown
## Jobs to be Done (JTBD)

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

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

**Pain Points Discovery:**

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

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

**Validation Framework:**

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

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

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

### 2. Prioritization Frameworks

**A. RICE Score (Recomendado)**

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

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

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

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

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

**Exemplo Prático:**

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

**B. MoSCoW Method**

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

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

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

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

**C. Value vs Effort Matrix**

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

### 3. Roadmap Planning

**Template Quadrimestral:**

```markdown
# Product Roadmap Q1-Q3 2026

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

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

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

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

---

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

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

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

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

---

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

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

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

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

### 4. User Stories & Acceptance Criteria

**Template:**

```markdown
## US-123: Export dashboard to PDF

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

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

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

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

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

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

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

### 5. Sprint Planning

**Template Sprint (2 semanas):**

```markdown
# Sprint 23 (3-14 Fev 2026)

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

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

## Committed Stories

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

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

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

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

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

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

---

## Métricas de Produto

### Acquisition (AARRR Pirate Metrics)

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

### Product Health

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

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

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

### Outcomes vs Outputs

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

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

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

---

## Consultar Datasets Dify

**SEMPRE antes de decidir features:**

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

### Como Consultar

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

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

---

## MCPs Utilizados

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

---

## Exemplos de Uso

### 1. Discovery Nova Feature
```
/product discovery
→ Problem space exploration
→ Jobs-to-be-done framework
→ Validation checklist (desirability/viability/feasibility)
→ Decision: Build / No Build
```

### 2. Prioritização Backlog
```
/product prioritize
→ Lista features candidatas
→ RICE scoring interactivo
→ Ranking final
→ Export para Desk CRM
```

### 3. Roadmap Trimestral
```
/product roadmap
→ Objectivos Q1/Q2/Q3
→ Epics e milestones
→ Success metrics
→ Output Markdown para Obsidian
```

---

## Agentes Recomendados

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

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

---

## Instrumentação Automática

### Query para Gravar (executar no final)

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

---

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