feat: refactor 30+ skills to Anthropic progressive disclosure pattern

- All SKILL.md files now <500 lines (avg reduction 69%) - Detailed content extracted to references/ subdirectories - Frontmatter standardised: only name + description (Anthropic standard) - New skills: brand-guidelines, spec-coauthor, report-templates, skill-creator - Design skills: anti-slop guidelines, premium-proposals reference - Removed non-standard frontmatter fields (triggers, version, author, category) Plugins affected: infraestrutura, marketing, dev-tools, crm-ops, gestao, core-tools, negocio, perfex-dev, wordpress, design-media Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-12 15:05:03 +00:00
parent 9404af7ac9
commit 6b3a6f2698
397 changed files with 67154 additions and 17257 deletions
--- a/negocio/skills/product/SKILL.md
+++ b/negocio/skills/product/SKILL.md
@@ -1,18 +1,11 @@
 ---
 name: product
-description: Skill especializada em gestão de produto, desde discovery até execução,
-  usando frameworks como RICE, MoSCoW e Jobs-to-be-Done.
-author: Descomplicar® Crescimento Digital
-version: 2.0.0
-quality_score: 55
-user_invocable: true
-desk_task: null
-allowed-tools: Read, Task
+description: Gestao de produto desde discovery ate execucao, usando frameworks como RICE, MoSCoW e Jobs-to-be-Done.
 ---

 # Skill /product - Product Management & Planning

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

 ## Sintaxe

@@ -20,7 +13,7 @@ Skill especializada em gestão de produto, desde discovery até execução, usan
 /product [operacao] [contexto]
 ```

-**Operações:**
+**Operacoes:**
 - `discovery` - Problem space, jobs-to-be-done, validation
 - `prioritize` - RICE scoring, MoSCoW, value/effort matrix
 - `roadmap` - Planeamento quadrimestral, epics, milestones
@@ -30,454 +23,114 @@ Skill especializada em gestão de produto, desde discovery até execução, usan
 ## Quando Usar

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

 ---

-## Protocolo de Execução
+## Contexto NotebookLM
+
+ANTES de executar, consultar notebooks:
+
+```
+mcp__notebooklm__notebook_query({
+  notebook_id: "79d43410-0e29-4be1-881d-84db6bdc239a",
+  query: "<adaptar ao contexto do pedido do utilizador>"
+})
+```
+
+---
+
+## Protocolo de Execucao

 ### 1. Product Discovery

-**Problem Space (não Solution Space):**
+**Jobs to be Done (JTBD):**

-```markdown
-## Jobs to be Done (JTBD)
-
-When [situação]
-I want to [motivação]
+```
+When [situacao]
+I want to [motivacao]
 So I can [outcome desejado]
-
-### Exemplo:
-When I need to share a report with my team
-I want to export to PDF with custom branding
-So I can present professional documents to stakeholders
 ```

-**Pain Points Discovery:**
+**Validation Framework resumo:**
+- **Desirability:** Users querem? (interviews, surveys, prototype tests)
+- **Viability:** Negocio faz sentido? (TAM/SAM/SOM, unit economics, ROI > 3x)
+- **Feasibility:** Conseguimos construir? (spike, dependencies, timeline)
+
+Detalhes completos: [references/metricas-produto.md](references/metricas-produto.md)
+
+### 2. Prioritization
+
+**RICE Score (recomendado):**

 ```
-Perguntas a fazer:
-1. O que frustra o utilizador actualmente?
-2. Que workarounds usa hoje?
-3. Quanto tempo/dinheiro perde com o problema?
-4. Qual a frequência do problema?
-5. O que tentou fazer para resolver?
-
-Evidência:
- [ ] 5+ entrevistas com users
- [ ] Analytics de uso (onde abandonam?)
- [ ] Tickets de suporte relacionados
- [ ] Pesquisa concorrência (como resolvem?)
+Score = (Reach x Impact x Confidence) / Effort
 ```

-**Validation Framework:**
+Tambem disponivel: MoSCoW, Value vs Effort Matrix.

-```
-┌─────────────────────────────────────────────────┐
-│ DESIRABILITY (Users querem?)                    │
-├─────────────────────────────────────────────────┤
-│ ☐ Problem interviews (10+)                      │
-│ ☐ Solution interviews (5+)                      │
-│ ☐ Survey (50+ respostas)                        │
-│ ☐ Prototype test (usability)                    │
-│ Evidence: X% users pagaria, Y% usaria diário    │
-└─────────────────────────────────────────────────┘
-
-┌─────────────────────────────────────────────────┐
-│ VIABILITY (Negócio faz sentido?)                │
-├─────────────────────────────────────────────────┤
-│ ☐ Market size (TAM/SAM/SOM)                     │
-│ ☐ Revenue model claro                           │
-│ ☐ Unit economics positivos                      │
-│ ☐ Payback period aceitável                      │
-│ Target: ROI > 3x em 12 meses                    │
-└─────────────────────────────────────────────────┘
-
-┌─────────────────────────────────────────────────┐
-│ FEASIBILITY (Conseguimos construir?)            │
-├─────────────────────────────────────────────────┤
-│ ☐ Technical spike completo                      │
-│ ☐ Dependencies mapeadas                         │
-│ ☐ Resources disponíveis                         │
-│ ☐ Timeline realista                             │
-│ Risk assessment: Alto/Médio/Baixo               │
-└─────────────────────────────────────────────────┘
-```
-
-### 2. Prioritization Frameworks
-
-**A. RICE Score (Recomendado)**
-
-```
-        Reach × Impact × Confidence
-Score = ─────────────────────────────
-                 Effort
-
-Reach: Quantos users impactados por período
-  - Ex: 1000 users/quarter, 500 users/month
-
-Impact: Quanto impacto por user
-  - 3 = Massive impact
-  - 2 = High impact
-  - 1 = Medium impact
-  - 0.5 = Low impact
-  - 0.25 = Minimal impact
-
-Confidence: Certeza das estimativas
-  - 100% = Dados sólidos
-  - 80% = Boas evidências
-  - 50% = Suposições educadas
-
-Effort: Person-months para entregar
-  - Ex: 2 person-months, 0.5 person-month
-```
-
-**Exemplo Prático:**
-
-| Feature | Reach | Impact | Confidence | Effort | RICE | Prioridade |
-|---------|-------|--------|------------|--------|------|------------|
-| Export PDF | 800/q | 2 | 80% | 1 | 1280 | 🟢 Alta |
-| Dark mode | 400/q | 0.5 | 100% | 0.5 | 400 | 🟡 Média |
-| API v2 | 200/q | 3 | 50% | 3 | 100 | 🔴 Baixa |
-| Search filters | 1000/q | 1 | 80% | 0.5 | 1600 | 🟢 Alta |
-
-**B. MoSCoW Method**
-
-```
-MUST have: Crítico para launch (MVP)
-  - Sem isso, produto não funciona
-  - Legal/compliance obrigatório
-  - Blocker absoluto
-
-SHOULD have: Importante mas não crítico
-  - Melhora significativamente a experiência
-  - Workaround existe
-  - Pode ser adiado 1 sprint
-
-COULD have: Nice to have
-  - Pequena melhoria
-  - Se sobrar tempo
-  - Low effort/low impact
-
-WON'T have (agora): Fora de scope
-  - Para próxima versão
-  - Não alinhado com objectivo actual
-```
-
-**C. Value vs Effort Matrix**
-
-```
-         │ HIGH VALUE
-         │
-    II   │   I
-  Quick  │  Big
-  Wins   │  Bets
-  (DO)   │ (PLAN)
-─────────┼─────────
-   III   │   IV
-  Fill   │  Money
-  Ins    │  Pit
- (LATER) │ (AVOID)
-         │
-         │ LOW VALUE
-    LOW EFFORT → HIGH EFFORT
-```
+Detalhes e exemplos: [references/prioritization-frameworks.md](references/prioritization-frameworks.md)

 ### 3. Roadmap Planning

-**Template Quadrimestral:**
+Template quadrimestral com themes, epics, milestones e success metrics.

-```markdown
-# Product Roadmap Q1-Q3 2026
+Templates completos: [references/roadmap-sprint-templates.md](references/roadmap-sprint-templates.md)

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

-### Epic 1: Core Functionality Polish
- [ ] Performance optimization (< 2s load)
- [ ] Mobile responsive
- [ ] Error handling robusto
+```
+Como [role]
+Quero [accao]
+Para que [beneficio]

-### Epic 2: Basic Integrations
- [ ] Slack notifications
- [ ] Google Calendar sync
- [ ] Email templates
-
-**Milestone:** MVP Launch (31 Mar)
-**Success Metrics:**
- 50 signups/week
- 40% activation rate
- < 10% churn
-
---
-
-## Q2 (Mai-Ago): Growth
-**Theme:** Expand features + virality
-**Goal:** 500 active users, NPS > 50
-
-### Epic 3: Collaboration Features
- [ ] Team workspaces
- [ ] Comments & mentions
- [ ] Activity feed
-
-### Epic 4: Growth Loops
- [ ] Invite system (referral)
- [ ] Public templates gallery
- [ ] Embeddable widgets
-
-**Milestone:** Product-Market Fit (31 Ago)
-**Success Metrics:**
- 1000 signups total
- 50% M1 retention
- NRR > 100%
-
---
-
-## Q3 (Set-Dez): Scale
-**Theme:** Enterprise readiness
-**Goal:** 2000 active users, ARR > 100k€
-
-### Epic 5: Enterprise Features
- [ ] SSO/SAML
- [ ] Advanced permissions
- [ ] Audit logs
- [ ] Custom branding
-
-### Epic 6: API & Integrations
- [ ] Public API v1
- [ ] Zapier integration
- [ ] Webhooks
-
-**Milestone:** Enterprise Ready (31 Dez)
-**Success Metrics:**
- 5 enterprise clients (>100€/mês)
- API adoption > 20%
- Support tickets < 5/100 users
+Given [contexto]
+When [accao]
+Then [resultado esperado]
 ```

-### 4. User Stories & Acceptance Criteria
-
-**Template:**
-
-```markdown
-## US-123: Export dashboard to PDF
-
-### User Story
-Como [Product Manager]
-Quero [exportar dashboard para PDF com branding personalizado]
-Para que [possa partilhar relatórios profissionais com stakeholders externos]
-
-### Context
- Users pedem isto em 60% dos support tickets
- Concorrentes já têm (Competitor A, B)
- Workaround actual: screenshots (não profissional)
-
-### Acceptance Criteria
-Given [estou no dashboard com dados carregados]
-When [clico em "Export PDF"]
-Then [sistema gera PDF em < 5s com:
-  - Logo da empresa
-  - Data do relatório
-  - Todos os gráficos (vectorial)
-  - Tabela de dados resumida
-  - Footer com marca d'água Descomplicar]
-
-And [recebo notificação quando PDF pronto]
-And [posso fazer download ou enviar por email]
-
-### Edge Cases
- [ ] Dashboard sem dados → mostrar "No data" no PDF
- [ ] Dashboard com 100+ items → paginar automaticamente
- [ ] Logo não carregado → usar placeholder
-
-### Definition of Done
- [ ] Código completo e reviewed
- [ ] Testes unitários (> 80% coverage)
- [ ] Testes E2E (happy path + edge cases)
- [ ] Documentação API actualizada
- [ ] Changelog entry
- [ ] Deployed to staging
- [ ] QA sign-off
- [ ] Product Manager review
-
-### Effort Estimate
-Story Points: 5 (Fibonacci: 1, 2, 3, 5, 8, 13)
-Dev: 2 days
-QA: 0.5 days
-Total: 2.5 days
-```
+Template completo com edge cases e DoD: [references/roadmap-sprint-templates.md](references/roadmap-sprint-templates.md)

 ### 5. Sprint Planning

-**Template Sprint (2 semanas):**
+Template de sprint (2 semanas) com capacity, committed stories, stretch goals e ceremonies.

-```markdown
-# Sprint 23 (3-14 Fev 2026)
-
-## Sprint Goal
-"Users podem exportar dashboards profissionais e partilhar com stakeholders"
-
-## Team Capacity
- 3 developers × 8 days = 24 person-days
- Velocity média: 25 story points/sprint
- Buffer para bugs/support: 20% → 20 SP disponíveis
-
-## Committed Stories
-
-### 🎯 Must Have (MVP sprint)
- [ ] US-123: Export PDF (5 SP) - @dev1
- [ ] US-124: Email sharing (3 SP) - @dev2
- [ ] US-125: Custom branding settings (3 SP) - @dev3
-
-### 🚀 Should Have (se tempo)
- [ ] US-126: Schedule exports (5 SP)
- [ ] US-127: Export templates (3 SP)
-
-### 🐛 Bugs Críticos
- [ ] BUG-45: Login timeout (2 SP) - @dev1
-
-**Total Committed:** 13 SP
-**Stretch Goals:** 8 SP
-**Total Possível:** 21 SP
-
-## Definition of Done (Sprint)
- [ ] Todas as US committed DONE
- [ ] Zero bugs críticos open
- [ ] Test coverage > 80%
- [ ] Docs actualizadas
- [ ] Demo preparada para stakeholders
- [ ] Retrospective completa
-
-## Ceremonies
- Planning: Seg 3 Fev, 10h-12h
- Daily: 9h30 (15 min)
- Refinement: Qua 7 Fev, 14h-16h
- Review: Sex 14 Fev, 14h-15h
- Retrospective: Sex 14 Fev, 15h-16h
-```
+Template: [references/roadmap-sprint-templates.md](references/roadmap-sprint-templates.md)

 ---

-## Métricas de Produto
+## Metricas de Produto

-### Acquisition (AARRR Pirate Metrics)
+### AARRR Pirate Metrics

-| Fase | Métrica | Target |
+| Fase | Metrica | Target |
 |------|---------|--------|
-| **Acquisition** | Signups/semana | +20%/mês |
-| **Activation** | Setup completo | > 40% |
-| **Retention** | D7 retention | > 30% |
-| **Revenue** | Conversion free→paid | > 3% |
-| **Referral** | NPS | > 40 |
-
-### Product Health
-
-```
-Engagement:
- DAU/MAU ratio (stickiness): > 20%
- Session duration: Sector-dependent
- Features usado/session: > 3
-
-Adoption:
- Time to first value: < 10 min
- Feature adoption (30 dias): > 30%
- Power users (5+ dias/semana): > 10%
-
-Quality:
- Error rate: < 1%
- Support tickets/100 users: < 5
- CSAT: > 4/5
-```
+| Acquisition | Signups/semana | +20%/mes |
+| Activation | Setup completo | > 40% |
+| Retention | D7 retention | > 30% |
+| Revenue | Conversion free->paid | > 3% |
+| Referral | NPS | > 40 |

 ### Outcomes vs Outputs

 ```
-❌ ERRADO (Output-driven):
-"Lançar 10 features este trimestre"
-
-✅ CERTO (Outcome-driven):
-"Aumentar retention D30 de 20% para 35% (via engagement features)"
-
-Medir:
- North Star Metric (ex: DAU/MAU)
- Leading indicators (ex: time-to-value)
- Lagging indicators (ex: churn)
+ERRADO: "Lancar 10 features este trimestre"
+CERTO:  "Aumentar retention D30 de 20% para 35%"
 ```

---
-
-## Consultar Datasets Dify
-
-**SEMPRE antes de decidir features:**
-
-| Dataset | ID | Query Exemplo |
-|---------|----|--------------:|
-| **Gestão de Processos** | `cae2a27e-f5bc-4d75-8a7a-9f83064f2512` | "product discovery user interviews" |
-| **Estratégia** | `7d1d1d21-bc05-43d8-ab8f-6b7b90dafc28` | "roadmap planning okr metrics" |
-| **Gestão de Projectos** | `b10a9418-bcb4-4e4c-b1f8-e64c88bedc04` | "sprint planning scrum velocity" |
-
-### Como Consultar
-
-```javascript
-// Product discovery best practices
-mcp__notebooklm__notebook_query, mcp__dify-kb__dify_kb_retrieve_segments({
-  dataset_id: "cae2a27e-f5bc-4d75-8a7a-9f83064f2512",
-  query: "product discovery validation framework jobs to be done",
-  retrieval_mode: "hybrid_search",
-  top_k: 5
-});
-
-// Prioritização e roadmaps
-mcp__dify-kb__dify_kb_retrieve_segments({
-  dataset_id: "7d1d1d21-bc05-43d8-ab8f-6b7b90dafc28",
-  query: "priorizar features rice moscow roadmap",
-  retrieval_mode: "hybrid_search",
-  top_k: 5
-});
-```
-
---
-
-## MCPs Utilizados
-
-```
-mcp__desk-crm-v3__*                  # Gestão projectos e tarefas
-mcp__dify-kb__dify_kb_retrieve_segments  # Conhecimento metodologias
-```
+Metricas detalhadas: [references/metricas-produto.md](references/metricas-produto.md)

 ---

 ## Exemplos de Uso

-### 1. Discovery Nova Feature
 ```
-/product discovery
-→ Problem space exploration
-→ Jobs-to-be-done framework
-→ Validation checklist (desirability/viability/feasibility)
-→ Decision: Build / No Build
-```
-
-### 2. Prioritização Backlog
-```
-/product prioritize
-→ Lista features candidatas
-→ RICE scoring interactivo
-→ Ranking final
-→ Export para Desk CRM
-```
-
-### 3. Roadmap Trimestral
-```
-/product roadmap
-→ Objectivos Q1/Q2/Q3
-→ Epics e milestones
-→ Success metrics
-→ Output Markdown para Obsidian
+/product discovery   -> Problem space + JTBD + validation + decision Build/No Build
+/product prioritize  -> Lista features + RICE scoring + ranking + export Desk
+/product roadmap     -> Objectivos Q1/Q2/Q3 + epics + milestones + success metrics
 ```

 ---
@@ -502,21 +155,10 @@ Task({

 ---

-## Instrumentação Automática
+## Conteudo Detalhado

-### Query para Gravar (executar no final)
-
-```sql
-INSERT INTO tblskill_agent_metrics (
-  type, name, duration_ms, status, staff_id,
-  kb_consulted, kb_cache_hit, tool_calls, project_id
-) VALUES (
-  'skill', '/product', {DURACAO_MS}, '{STATUS}', 25,
-  {KB_CONSULTADO}, {CACHE_HIT}, {TOOL_CALLS}, {PROJECT_ID}
-);
-```
-
---
-
-**Versão**: 2.0.0 | **Data**: 2026-02-03 | **Autor**: Descomplicar®
-**Instrumentação**: Activa
+| Referencia | Conteudo |
+|------------|----------|
+| [references/prioritization-frameworks.md](references/prioritization-frameworks.md) | RICE scoring, MoSCoW, Value vs Effort matrix |
+| [references/roadmap-sprint-templates.md](references/roadmap-sprint-templates.md) | Templates roadmap, user stories, sprint planning |
+| [references/metricas-produto.md](references/metricas-produto.md) | AARRR, product health, validation framework, pain points |