--- name: master-skill version: 1.0.0 category: Meta description: Sistema modular de conhecimento especializado para trabalho em IA/Healthcare, ensino de tecnologia, e gestão de projetos. Esta meta-skill documenta a arquitetura, filosofia e uso do sistema completo de 6 skills interconectadas. author: Tai Oliveira last_updated: 2025-01-23 tags: [meta, documentação, índice, navegação, sistema] --- # 🎯 Master Skill - Sistema de Knowledge Management **Versão:** 1.0.0 **Última atualização:** 2025-01-23 **Autor:** Tai Oliveira --- ## 📋 Sumário Executivo Este é o **sistema modular de skills** que organiza todo o conhecimento especializado necessário para: 1. 💼 **Trabalho na SulAmérica** - Projetos de IA em Healthcare (Análise Guiada, Experimento Auditor) 2. 🎓 **Ensino de Pós-Graduação** - Disciplinas de gestão de projetos de dados 3. 🚀 **Inovação e Experimentação** - Desenvolvimento de novas soluções **Total:** 6 skills modulares, ~4.500 linhas de documentação estruturada, 100% focada em ação. --- ## 🎯 Filosofia do Sistema ### Por que Skills Modulares? **Antes: Monolítico** ``` ❌ 1 documento gigante (2000+ linhas) ❌ Carrega tudo sempre (alto custo de tokens) ❌ Difícil manter e atualizar ❌ Conteúdo misturado de domínios diferentes ❌ Redundância e duplicação ``` **Agora: Modular** ``` ✅ 6 skills especializadas ✅ Carrega só o necessário (70-75% economia) ✅ Fácil manter independentemente ✅ Separação clara de concerns ✅ Zero redundância ✅ Composição flexível ``` ### Princípios de Design 1. **🎯 Acionável, não teórico** - Templates prontos, exemplos reais, zero fluff 2. **🔗 Modular e componível** - Skills se combinam para resolver problemas complexos 3. **💡 Contextualizado** - Exemplos do mundo real (SulAmérica, aulas, projetos) 4. **📊 Baseado em evidências** - Métricas, ROI, impacto mensurável 5. **🔄 Versionado e evolutivo** - Cada skill tem changelog e versão independente --- ## 🗺️ Mapa do Sistema ### Visão Geral das 6 Skills ``` ┌─────────────────────────────────────────────────────────┐ │ SISTEMA DE SKILLS │ └─────────────────────────────────────────────────────────┘ │ ┌──────────────────┼──────────────────┐ │ │ │ 🧠 TÉCNICAS 🏥 DOMÍNIO 👥 GESTÃO │ │ │ ┌────┴────┐ │ ┌─────┴─────┐ │ │ │ │ │ Skill 1 Skill 2 Skill 3 Skill 4 Skill 5 Skill 6 Prompts Arq/Eng Healthcare Gestão Ensino Inovação ``` ### Tabela de Skills | # | Skill | Status | Linhas | Quando Usar | |---|-------|--------|--------|-------------| | 1 | 🧠 Prompt Engineering | ✅ v2.0.0 | 439 | Criar/otimizar prompts, sistemas LLM | | 2 | 🏗️ Arquitetura & Engenharia | ⏳ Em Desenvolvimento | ~762 | Decisões técnicas, código, infraestrutura | | 3 | 🏥 Healthcare & Insurance | ✅ v2.0.0 | 461 | Projetos SulAmérica, contexto médico | | 4 | 📊 Gestão de Projetos | ⏳ Em Desenvolvimento | ~571 | Planning, stakeholders, métricas, ROI | | 5 | 🎓 Ensino & Design Instrucional | ⏳ Em Desenvolvimento | ~665 | Preparar aulas, exercícios, avaliação | | 6 | 🚀 Inovação & Metodologias | ⏳ Em Desenvolvimento | ~759 | Experimentação, MVP, validação | **Total atual:** 4.657 linhas estruturadas --- ## 🎯 Quando Usar Cada Skill ### 🧠 Skill 1: Prompt Engineering & LLM **USE quando precisar:** - ✅ Criar ou otimizar prompts - ✅ Reduzir custos de API (tokens) - ✅ Melhorar qualidade das respostas - ✅ Implementar Chain-of-Thought, Few-Shot - ✅ Versionamento de prompts - ✅ A/B testing de prompts **NÃO use para:** - ❌ Código que não envolve LLM - ❌ Gestão de projeto (use Skill 4) - ❌ Contexto específico de healthcare (use Skill 3) **Exemplos de queries:** - "Como otimizar este prompt para análise médica?" - "Preciso reduzir o custo de tokens do sistema" - "Como implementar Chain-of-Thought neste caso?" --- ### 🏗️ Skill 2: Arquitetura & Engenharia **USE quando precisar:** - ✅ Decidir stack tecnológico - ✅ Escrever código Python/React/Node - ✅ Modelar dados em Neo4j (Cypher) - ✅ Integrar APIs e sistemas - ✅ Deploy e infraestrutura - ✅ Patterns de arquitetura **NÃO use para:** - ❌ Prompts e LLMs (use Skill 1) - ❌ Processos de negócio (use Skill 4) - ❌ Conhecimento de domínio healthcare (use Skill 3) **Exemplos de queries:** - "Como modelar relacionamento médico-paciente em Neo4j?" - "Qual pattern React usar para este componente?" - "Como estruturar pipeline de dados?" --- ### 🏥 Skill 3: Healthcare & Insurance (SulAmérica) **USE quando precisar:** - ✅ Contexto de projetos SulAmérica - ✅ Termos médicos (TUSS, CID, CBHPM) - ✅ Regulamentação (ANS, CFM) - ✅ Processos de autorização/auditoria - ✅ Stakeholders específicos (DSI, médicos, operações) - ✅ Métricas de impacto em saúde **NÃO use para:** - ❌ Healthcare genérico de outros países - ❌ Projetos fora da SulAmérica - ❌ Tecnologia desconectada do domínio **Exemplos de queries:** - "Como funciona o fluxo de autorização de cirurgia?" - "Qual o impacto do projeto Análise Guiada?" - "Como comunicar com equipe médica sobre IA?" --- ### 📊 Skill 4: Gestão de Projetos & Produtos **USE quando precisar:** - ✅ Planejar roadmap de projeto - ✅ Definir OKRs e métricas - ✅ Gerenciar stakeholders - ✅ Calcular ROI e business case - ✅ Priorizar backlog - ✅ Apresentações executivas **NÃO use para:** - ❌ Decisões técnicas (use Skill 2) - ❌ Criação de código - ❌ Criação de aulas (use Skill 5) **Exemplos de queries:** - "Como apresentar R$ 663k/mês de impacto para diretoria?" - "Como priorizar 3 projetos concorrentes?" - "Template de business case para novo projeto IA" --- ### 🎓 Skill 5: Ensino & Design Instrucional **USE quando precisar:** - ✅ Planejar cronograma de aulas - ✅ Criar exercícios e trabalhos - ✅ Avaliar alunos (provas, rubricas) - ✅ Produzir material didático (vídeos, slides) - ✅ Usar Jupyter notebooks para ensino - ✅ Adaptar projetos reais para sala de aula **NÃO use para:** - ❌ Projetos de trabalho (use Skills 1, 2, 3) - ❌ Gestão de projetos (use Skill 4) - ❌ Treinamento corporativo rápido **Exemplos de queries:** - "Como estruturar 30 horas de aula sobre gestão de dados?" - "Criar exercício progressivo sobre prompts" - "Rubrica de avaliação para trabalho final" --- ### 🚀 Skill 6: Inovação & Metodologias Científicas **USE quando precisar:** - ✅ Estruturar experimentos (Experimento Auditor) - ✅ Validar hipóteses cientificamente - ✅ Design Thinking, Lean Startup - ✅ Criar MVPs - ✅ Decisões pivot vs. persevere - ✅ Frameworks de inovação **NÃO use para:** - ❌ Projetos já validados em produção - ❌ Gestão operacional (use Skill 4) - ❌ Implementação técnica (use Skill 2) **Exemplos de queries:** - "Como desenhar A/B test para Experimento Auditor?" - "Validar hipótese do Gerador de Protocolos" - "Framework de MVP para nova funcionalidade" --- ## 🧭 Decision Tree: Qual Skill Usar? ``` Sua pergunta é sobre... │ ├─ 💻 CRIAR OU OTIMIZAR PROMPTS? │ └─ → Skill 1 (Prompt Engineering) │ ├─ 🔧 DECISÃO TÉCNICA / CÓDIGO? │ └─ → Skill 2 (Arquitetura) │ ├─ 🏥 CONTEXTO SULAMERICA / HEALTHCARE? │ └─ → Skill 3 (Healthcare) │ ├─ 📊 PLANEJAMENTO / STAKEHOLDERS / ROI? │ └─ → Skill 4 (Gestão) │ ├─ 🎓 PREPARAR AULAS / AVALIAR ALUNOS? │ └─ → Skill 5 (Ensino) │ └─ 🧪 EXPERIMENTAÇÃO / MVP / VALIDAÇÃO? └─ → Skill 6 (Inovação) ``` ### Perguntas Difusas? Use Múltiplas Skills! Muitas situações reais requerem **composição de skills**: **Exemplo 1: "Desenvolver novo sistema de IA para análise médica"** ``` 1. Skill 3 (Healthcare) → Entender domínio e requisitos 2. Skill 1 (Prompts) → Design dos prompts otimizados 3. Skill 2 (Arquitetura) → Implementação técnica 4. Skill 4 (Gestão) → Business case e stakeholders 5. Skill 6 (Inovação) → Experimentação e validação ``` **Exemplo 2: "Criar aula sobre gestão de projetos de IA"** ``` 1. Skill 5 (Ensino) → Estrutura pedagógica 2. Skill 4 (Gestão) → Conteúdo core 3. Skill 3 (Healthcare) → Exemplos SulAmérica 4. Skill 2 (Arquitetura) → Exercícios técnicos ``` **Exemplo 3: "Apresentar impacto de projeto para diretoria"** ``` 1. Skill 4 (Gestão) → Template de apresentação 2. Skill 3 (Healthcare) → Métricas de impacto em saúde 3. Skill 1 (Prompts) → Detalhes técnicos da solução ``` --- ## 🔗 Matriz de Relacionamentos ### Como as Skills se Complementam ``` Skill 1 Skill 2 Skill 3 Skill 4 Skill 5 Skill 6 Prompts Arq/Eng Health Gestão Ensino Inovação Skill 1 - Alta Média Baixa Média Média Skill 2 Alta - Alta Média Alta Alta Skill 3 Média Alta - Alta Média Média Skill 4 Baixa Média Alta - Média Alta Skill 5 Média Alta Média Média - Média Skill 6 Média Alta Média Alta Média - ``` **Legenda:** - **Alta**: Frequentemente usadas juntas - **Média**: Às vezes combinadas - **Baixa**: Raramente juntas ### Dependências **Skill 1 (Prompts)** ← depende de contexto de: - Skill 3 (Healthcare) - para prompts específicos de saúde - Skill 2 (Arquitetura) - para integração técnica **Skill 2 (Arquitetura)** ← depende de: - Skill 1 (Prompts) - para sistemas LLM - Skill 3 (Healthcare) - para requisitos de domínio **Skill 3 (Healthcare)** ← standalone, mas complementada por: - Skill 1 (Prompts) - para IA em saúde - Skill 4 (Gestão) - para projetos SulAmérica **Skill 4 (Gestão)** ← combina com todas para: - Planning de qualquer tipo de projeto - ROI de qualquer iniciativa **Skill 5 (Ensino)** ← usa conteúdo de: - Todas as outras skills como material didático **Skill 6 (Inovação)** ← aplica-se a: - Projetos novos de qualquer skill - Validação de hipóteses --- ## 📊 Métricas do Sistema ### Por Skill (Status Atual) | Métrica | Skill 1 | Skill 2 | Skill 3 | Skill 4 | Skill 5 | Skill 6 | |---------|---------|---------|---------|---------|---------|---------| | Status | ✅ v2.0 | ⏳ Dev | ✅ v2.0 | ⏳ Dev | ⏳ Dev | ⏳ Dev | | Linhas | 439 | ~762 | 461 | ~571 | ~665 | ~759 | | Templates | 12 | ~15 | 8 | ~10 | ~12 | ~8 | | Exemplos | 15 | ~20 | 12 | ~8 | ~10 | ~7 | | Qualidade | ⭐⭐⭐⭐⭐ | - | ⭐⭐⭐⭐⭐ | - | - | - | ### Economia de Tokens **Antes (Monolítico):** - 1 documento × 2000 linhas = ~2000 tokens por invocação - 100% carregado sempre **Agora (Modular):** - Quick Reference: ~100-200 tokens - Skill completa: ~400-800 tokens - **Economia: 70-75%** ✅ ### Tempo de Manutenção **Antes:** - 🔴 Atualizar 1 conceito = revisar 2000 linhas - 🔴 Risco alto de quebrar outras seções - 🔴 Difícil encontrar o que mudar **Agora:** - ✅ Atualizar 1 conceito = editar 1 skill específica - ✅ Zero impacto em outras skills - ✅ Fácil localizar e modificar --- ## 🛠️ Como Usar o Sistema ### Para Trabalho (SulAmérica) **1. Novo Projeto de IA** ```bash 1. Skill 3 (Healthcare) → Contexto do problema 2. Skill 1 (Prompts) → Design da solução 3. Skill 2 (Arquitetura) → Implementação 4. Skill 4 (Gestão) → Planning e ROI 5. Skill 6 (Inovação) → Validação experimental ``` **2. Otimização de Sistema Existente** ```bash 1. Skill 1 (Prompts) → Melhorar prompts 2. Skill 2 (Arquitetura) → Refatorar código 3. Skill 4 (Gestão) → Medir impacto ``` **3. Apresentação para Stakeholders** ```bash 1. Skill 4 (Gestão) → Template de apresentação 2. Skill 3 (Healthcare) → Métricas de impacto 3. Skill 1 (Prompts) → Detalhes técnicos (se necessário) ``` ### Para Ensino (Pós-Graduação) **1. Preparar Aula Nova** ```bash 1. Skill 5 (Ensino) → Estrutura pedagógica 2. Skill 4 (Gestão) → Conteúdo (se aula de gestão) 3. Skill 2 (Arquitetura) → Exemplos técnicos ``` **2. Criar Exercício Prático** ```bash 1. Skill 5 (Ensino) → Framework de exercício 2. Skill 3 (Healthcare) → Caso SulAmérica adaptado 3. Skill 2 (Arquitetura) → Código base ``` **3. Avaliar Trabalhos** ```bash 1. Skill 5 (Ensino) → Rubrica de avaliação 2. [Skill específica do tema do trabalho] ``` ### Para Desenvolvimento Pessoal **1. Aprender Nova Técnica** ```bash 1. [Skill relevante] → Framework teórico 2. Skill 6 (Inovação) → Experimentação prática ``` **2. Documentar Aprendizado** ```bash 1. [Skill relevante] → Adicionar ao changelog 2. Skill 5 (Ensino) → Transformar em material didático ``` --- ## 🎓 Casos de Uso Reais ### Caso 1: Análise Guiada v2.0 **Contexto:** Sistema em produção, R$ 663k/mês de impacto, precisa de melhorias **Skills usadas:** 1. **Skill 3 (Healthcare)** - Contexto do projeto, stakeholders, métricas atuais 2. **Skill 1 (Prompts)** - Otimizar prompts de análise médica 3. **Skill 2 (Arquitetura)** - Refatorar código, melhorar performance 4. **Skill 4 (Gestão)** - ROI da melhoria, apresentação para diretoria 5. **Skill 6 (Inovação)** - A/B test de nova versão **Resultado:** Abordagem estruturada, zero retrabalho, entrega eficiente --- ### Caso 2: Experimento Auditor **Contexto:** Sistema experimental, validando hipóteses, não em produção **Skills usadas:** 1. **Skill 6 (Inovação)** - Framework de experimentação, hipóteses 2. **Skill 3 (Healthcare)** - Processos de auditoria, terminologia 3. **Skill 1 (Prompts)** - Design dos prompts experimentais 4. **Skill 2 (Arquitetura)** - Setup técnico do experimento 5. **Skill 4 (Gestão)** - Métricas de sucesso, comunicação de resultados **Resultado:** Experimento bem estruturado, dados confiáveis, decisão informada --- ### Caso 3: Aula "Gestão de Projetos de Dados" **Contexto:** 30 horas de conteúdo, pós-graduação, alunos com background técnico **Skills usadas:** 1. **Skill 5 (Ensino)** - Estrutura pedagógica, cronograma de 10 aulas 2. **Skill 4 (Gestão)** - Conteúdo core (metodologias, OKRs, stakeholders) 3. **Skill 3 (Healthcare)** - Casos SulAmérica como exemplos reais 4. **Skill 2 (Arquitetura)** - Exercícios técnicos (Jupyter notebooks) 5. **Skill 6 (Inovação)** - Projeto final: validar MVP de solução de dados **Resultado:** Curso completo, material rico, exercícios práticos, avaliação justa --- ## 🔄 Versionamento e Evolução ### Semver (Semantic Versioning) Cada skill segue **versionamento independente**: - **Major (X.0.0)**: Mudanças incompatíveis (reestruturação completa) - **Minor (1.X.0)**: Novas funcionalidades (seções, templates) - **Patch (1.0.X)**: Correções, melhorias (typos, exemplos) ### Status Atual | Skill | Versão Atual | Próxima Release | |-------|--------------|-----------------| | Skill 1 | v2.0.0 | v2.1.0 (Q2 2025) | | Skill 2 | - | v1.0.0 (Jan 2025) | | Skill 3 | v2.0.0 | v2.1.0 (Q2 2025) | | Skill 4 | - | v1.0.0 (Jan 2025) | | Skill 5 | - | v1.0.0 (Fev 2025) | | Skill 6 | - | v1.0.0 (Fev 2025) | ### Changelog Consolidado Ver changelog específico em cada skill. Principais marcos: **2025-01-23** - Master Skill v1.0.0 - ✅ Criação do sistema de documentação - ✅ Decision tree e matriz de relacionamentos **2025-01-22** - Skills 1 e 3 v2.0.0 - ✅ Refatoração completa para estrutura modular - ✅ Templates práticos e acionáveis - ✅ Zero redundância **Futuro:** - 📅 2025-01 - Skills 2 e 4 v1.0.0 - 📅 2025-02 - Skills 5 e 6 v1.0.0 - 📅 2025-Q2 - Sistema completo de validação automatizada --- ## 🚀 Roadmap ### Fase 1: Fundações ✅ (Completo) - [x] Skill 1 (Prompts) v2.0.0 - [x] Skill 3 (Healthcare) v2.0.0 - [x] Master Skill v1.0.0 ### Fase 2: Core Skills 🔄 (Em Progresso) - [ ] Skill 2 (Arquitetura) v1.0.0 - [ ] Skill 4 (Gestão) v1.0.0 ### Fase 3: Complementares ⏳ (Próximo) - [ ] Skill 5 (Ensino) v1.0.0 - [ ] Skill 6 (Inovação) v1.0.0 ### Fase 4: Automação 🔮 (Futuro) - [ ] Scripts de validação de qualidade - [ ] Gerador de índices automatizado - [ ] Dashboard interativo de navegação - [ ] Sistema de busca semântica --- ## 📚 Recursos Complementares ### Documentação Adicional **Para este sistema:** - Cada skill tem seu próprio SKILL.md detalhado - Changelogs individuais por skill - Templates e exemplos inline **Skill-Creator Reference:** - `/mnt/skills/examples/skill-creator/SKILL.md` - Guia oficial - Progressive disclosure patterns - Best practices de criação ### Convenções de Formato **Estrutura padrão de cada skill:** ```markdown --- [YAML frontmatter] --- # Nome da Skill ## 🎯 Quando Usar ## 🚫 Quando NÃO Usar ## 🔗 Skills Relacionadas ## 📚 Conteúdo Core ## 📄 Changelog ``` **Navegação por emojis:** - 🎯 Objetivo/Quando usar - 🚫 Limitações/Quando NÃO usar - 🔗 Cross-references - 📚 Conteúdo principal - 📊 Métricas/dados - 🏆 Best practices - ⚠️ Avisos importantes - 📄 Documentação/changelog --- ## 💡 Dicas de Uso ### Maximize Eficiência 1. **Comece sempre pelo Master Skill** (este documento) - Entenda qual skill usar - Veja se precisa combinar múltiplas 2. **Use o Decision Tree** (seção acima) - Pergunta ambígua? Siga a árvore 3. **Leia só o necessário** - Quick Reference primeiro - Detalhe só se precisar 4. **Combine skills estrategicamente** - Projetos complexos = 3-5 skills - Tarefas simples = 1-2 skills ### Evite Armadilhas ❌ **NÃO faça:** - Carregar todas skills sempre - Ignorar "Quando NÃO usar" - Copiar template sem adaptar ao contexto - Esquecer de versionar mudanças ✅ **FAÇA:** - Carregue só skills relevantes - Respeite os limites de cada skill - Adapte templates ao seu contexto - Documente aprendizados no changelog --- ## 🤝 Contribuindo ### Como Atualizar uma Skill 1. **Identifique a mudança** - Bug? → Patch version (1.0.X) - Novo template? → Minor version (1.X.0) - Reestruturação? → Major version (X.0.0) 2. **Edite a skill específica** - Mantenha estrutura padrão - Adicione exemplo real sempre que possível - Teste templates antes de commitar 3. **Atualize changelog** - Data, versão, descrição clara - Link para issue/contexto se aplicável 4. **Valide cross-references** - Links para outras skills ainda funcionam? - Metadados estão corretos? ### Guidelines de Qualidade Toda skill deve: - ✅ Ter quick reference no topo - ✅ Definir "quando usar" e "quando NÃO usar" - ✅ Conter templates acionáveis - ✅ Usar exemplos do contexto real (SulAmérica, aulas) - ✅ Ter zero redundância com outras skills - ✅ Seguir estrutura padrão - ✅ Ter changelog atualizado --- ## 📞 Suporte ### Dúvidas? **Sobre o sistema:** - Consulte este Master Skill primeiro - Veja decision tree e matriz de relacionamentos **Sobre skill específica:** - Leia o SKILL.md da skill relevante - Verifique changelog para histórico **Não encontrou resposta?** - Documente o gap - Adicione ao roadmap da skill relevante --- ## 🎯 Quick Reference: Cheat Sheet ### Top 5 Perguntas **1. "Qual skill usar?"** → Veja Decision Tree (seção acima) **2. "Preciso combinar skills?"** → Sim, para projetos complexos. Veja Matriz de Relacionamentos **3. "Como atualizar uma skill?"** → Veja seção "Contribuindo" **4. "Qual a diferença entre Skill 1 e Skill 2?"** → Skill 1 = Prompts/LLM. Skill 2 = Código/Arquitetura **5. "Onde está o exemplo de X?"** → Use Ctrl+F na skill relevante ### Comandos Rápidos ```bash # Ver todas skills ls skills/ # Ver versão de uma skill grep "version:" skills/skill-1.md # Buscar termo em todas skills grep -r "termo" skills/ # Ver changelog consolidado grep -A5 "Changelog" skills/*/SKILL.md ``` --- ## 📊 Estatísticas do Sistema **Criado:** 2025-01-23 **Skills totais:** 6 **Skills completas:** 2 (Skill 1, Skill 3) **Skills em desenvolvimento:** 4 **Linhas totais:** ~4.657 **Templates totais:** ~65 **Exemplos totais:** ~72 **Versão do sistema:** 1.0.0 **Economia de tokens:** 70-75% vs. monolítico **Tempo de manutenção:** -60% vs. antes **Facilidade de navegação:** +80% vs. antes --- ## 🎓 Sobre o Autor **Tai Oliveira** - 💼 Líder de Soluções Inteligentes (DSI) na SulAmérica - 🧠 Especialista em IA aplicada a Healthcare - 🎓 Professor de pós-graduação (Gestão de Projetos de Dados) - 🚀 Projetos: Análise Guiada (R$ 663k/mês), Experimento Auditor, Gerador de Protocolos **Contato:** - Feedback sobre skills: [via changelog de cada skill] - Sugestões de melhorias: [documente no roadmap] --- **Este é um sistema vivo, em evolução contínua. Contribua, use, adapte! 🚀** --- ## 📄 Changelog - Master Skill ### v1.0.0 (2025-01-23) - ✅ Criação da Master Skill - ✅ Decision tree completo - ✅ Matriz de relacionamentos - ✅ Documentação de uso - ✅ Casos reais (Análise Guiada, Experimento Auditor, Aulas) - ✅ Roadmap e versionamento - ✅ Quick reference e cheat sheet --- **Próxima versão:** v1.1.0 (quando Skills 2-6 estiverem completas)