Da biblioteca aos projetos: como trabalhar com skills no Rakenne

Quando você abre o Rakenne pela primeira vez, é fácil enxergar duas camadas:

• Projetos, onde você faz o trabalho do dia a dia com clientes e documentos.
• Skills, que são fluxos reutilizáveis que ensinam o agente a agir como um especialista no seu domínio.

Este artigo explica o ciclo de vida completo de uma skill do ponto de vista do usuário final:

1. O que é a Biblioteca de Skills e como encontrar a skill certa
2. Como instalar uma skill em um projeto e começar a usá-la
3. Como funcionam atualizações e versões
4. Como fazer fork de uma skill quando você precisa da sua própria variação
5. Como publicar e compartilhar skills entre projetos e clientes

Nada de código, nada de detalhes internos — apenas como usar isso como consultor, analista ou líder de compliance.

1. O que é a Biblioteca de Skills?

Uma skill é um fluxo guiado, escrito em linguagem natural, que diz ao agente:

• Quando ela deve ser usada (gatilhos típicos)
• Quais passos seguir e em que ordem
• Quais documentos, templates e ferramentas usar ao longo do caminho

Exemplos:

• “Inventário de Ativos ISO 27001”
• “Relatório de Estudo Clínico (CSR) – Seções principais”
• “Revisão de claims de rotulagem – Mercado EUA”

A Biblioteca de Skills é onde essas skills vivem:

• Skills de sistema: skills prontas que já vêm com o Rakenne
• Skills do tenant: skills criadas e compartilhadas dentro da sua organização
• Suas próprias skills: rascunhos e versões publicadas que você criou ou fez fork

Você pode pensar nela como uma loja de aplicativos para fluxos de trabalho. Os projetos não recebem todas as skills automaticamente; você escolhe quais quer usar.

2. Encontrando a skill certa

Antes de iniciar um novo projeto, vale gastar alguns minutos explorando a biblioteca.

2.1 Maneiras comuns de navegar

Na maioria das telas da biblioteca você pode:

• Buscar: digitar uma palavra‑chave como “SOC 2”, “clínico”, “inventário de ativos” ou “rotulagem”.
• Usar filtros / tags para afinar a lista:
  • Domínio (ex.: Segurança da Informação, Life Sciences, Alimentos & Bebidas)
  • Caso de uso (ex.: “Avaliação de Risco”, “Redação de Política”, “Readiness”, “Extração de Dados”)
• Ordenar por:
  • Mais instaladas / populares: o que outros times mais usam
  • Atualizadas recentemente: skills que estão sendo mantidas ativamente

Boa regra prática:

• Comece amplo: busque pelo seu framework ou regulação (“ISO 27001”, “ISO 14971”, “SOC 2”, “CVM FIDC”).
• Depois refine pelo tipo de documento (“SoA”, “Registro de Riscos”, “Readiness”, “Prospecto”, “Relatório Clínico”).

2.2 Lendo uma skill antes de usar

Ao clicar em uma skill você consegue ver:

• O que ela produz: documentos, dados estruturados, checklists, resumos…
• Quando usar: prompts ou situações típicas de início
• Entradas necessárias: o que você precisa ter em mãos (PDFs existentes, conjunto de políticas, fatos sobre o cliente etc.)
• Saídas esperadas: exemplos do que a sessão vai criar

Trate isso como ler o rótulo de um produto antes de comprar: se as saídas não batem com o entregável que você precisa, continue procurando.

3. Instalando uma skill em um projeto

As skills vivem na biblioteca, mas só se tornam utilizáveis quando você as vincula a um projeto específico.

3.1 Por que a instalação importa

Quando você instala uma skill em um projeto, o Rakenne:

• Torna o fluxo daquela skill disponível para o agente do projeto
• Traz junto qualquer skill de apoio de que ela dependa (por exemplo, helpers comuns de ISO 27001)
• Garante que os templates e ferramentas certos estejam disponíveis nos bastidores

Isso mantém os projetos enxutos: cada projeto só enxerga as skills de que realmente precisa.

3.2 Fluxo típico de instalação

1. Abra o seu projeto.
   Por exemplo: “Cliente A – ISMS ISO 27001”, “Fundo Alpha – Documentos FIDC” ou “ACME – Rotulagem de Produto”.

2. Vá até a seção de Skills do projeto.
   Procure por “Skills”, “Adicionar skills” ou “Biblioteca de skills” na navegação do projeto.

3. Navegue ou busque a biblioteca de dentro do projeto.
   Você verá as mesmas skills da biblioteca global, com indicadores para:

   • Skills já instaladas
   • Skills compatíveis com o template do seu projeto

4. Instale a skill.

   • Clique em Instalar (ou equivalente) na skill desejada.
   • Se a skill precisar de helpers (outras skills de que depende), elas são instaladas junto.
   • A instalação costuma levar poucos segundos.

5. Confirme que ela está disponível no projeto.
   Depois de instalar, a skill:

   • Aparece na lista de Skills instaladas do projeto
   • Fica disponível no chat (veja a próxima seção)

A partir daí, qualquer pessoa com acesso ao projeto pode usar aquela skill.

4. Usando uma skill instalada em sessão

Depois que a skill está instalada, você não precisa mais pensar na biblioteca — basta conversar com o agente.

4.1 Como invocar uma skill

Dois padrões são mais comuns:

• Linguagem natural
  Abra uma sessão e descreva o que você quer:

  “Me ajude a conduzir um workshop de inventário de ativos ISO 27001 para a ACME.”
  “Preciso extrair todos os dados relevantes deste prospecto FIDC em PDF.”

  Se o projeto tiver uma skill relevante instalada, o agente muitas vezes vai rotear seu pedido para essa skill automaticamente.

• Seleção explícita
  Em algumas interfaces, você pode escolher uma skill em um menu ou usar uma sintaxe específica de gatilho.
  Isso é útil quando:

  • Você sabe exatamente qual skill quer
  • Está em um projeto com várias skills parecidas

4.2 Como é uma sessão dirigida por skill

Comparado a conversar com uma IA genérica, uma sessão guiada por skill é:

• Estruturada — o agente conduz você por passos claros:
  • Coletar certas entradas (documentos, fatos, escolhas de parâmetros)
  • Rodar extrações ou análises
  • Produzir documentos, checklists ou dados estruturados
• Repetível — se você rodar a mesma skill em outro cliente, o fluxo será quase idêntico.
• Rastreável — você normalmente sabe em que passo está e o que vem a seguir.

Você não precisa lembrar os detalhes técnicos. Só precisa:

• Escolher a skill certa
• Fornecer as entradas que ela pede
• Revisar e aprovar as saídas

5. Como funcionam versões e atualizações de skills

As skills evoluem com o tempo: um checklist melhor, um template mais enxuto, uma interpretação mais madura de um padrão.

O Rakenne cuida disso por meio de versões.

5.1 O que versões significam para você

Do ponto de vista de quem usa:

• Cada skill tem uma versão atual (por exemplo “v1.0”, “v1.1”…)
• Um projeto normalmente usa uma versão por skill de cada vez
• Quando sai uma nova versão, você vê isso como uma oportunidade de atualização, não como uma mudança surpresa

Comportamentos importantes:

• Projetos existentes ficam estáveis.
  Se um projeto está na v1.0, ele permanece nessa versão até você decidir mudar.
• Novos projetos podem começar na última versão.
  Ao instalar uma skill em um projeto novo, você geralmente já recebe a versão mais recente.

5.2 Decidindo quando atualizar

Quando há uma nova versão disponível, você pode ver:

• Um aviso ou indicador na skill dentro do projeto
• Release notes explicando o que mudou (novas seções, melhor cobertura, correções, orientações aprimoradas)

Boa prática:

• Atualize cedo quando:
  • Estiver começando um engajamento novo com um cliente
  • As notas de versão corrigirem erros, lacunas ou mapeamentos que importam para você
• Adie ou teste antes quando:
  • Estiver no meio de um entregável regulatório sensível
  • Seus revisores internos já tiverem aprovado uma versão específica

Um fluxo simples para trabalhos regulados:

1. Crie um projeto sandbox.
2. Instale a skill e faça upgrade para a última versão ali.
3. Rode uma sessão de teste com um cliente de exemplo.
4. Só então, atualize a skill nos projetos de produção dos clientes.

6. Fazendo fork de uma skill: criando a sua variação

Às vezes uma skill padrão leva você 80% do caminho, mas a sua organização:

• Tem checklists ou thresholds de aprovação próprios
• Usa terminologia diferente (nomes internos de controles, cargos, comitês)
• Precisa de passos extras para governança interna

Nesses casos, vale fazer fork de uma skill em vez de começar do zero.

6.1 O que “fazer fork” significa na prática

Do ponto de vista de quem usa:

• Você cria um projeto especial (geralmente a partir de um template Skill Workshop) que contém:
  • Uma cópia da skill original
  • Referências e exemplos de apoio
• Você adapta o fluxo à sua realidade:
  • Reescreve perguntas e instruções na sua linguagem
  • Adiciona ou remove passos
  • Aponta para estilos de documento, exemplos e políticas internas
• No fim, você tem uma nova skill que:
  • É claramente baseada na original
  • Pertence à sua organização
  • Pode ser instalada em projetos como qualquer outra

6.2 Quando configurar e quando fazer fork

• Configure (não faça fork) quando:

  • A skill já tiver opções/entradas para suas escolhas (ex.: jurisdição, setor)
  • Você só precisa mudar dados (fatos do cliente), não o fluxo

• Faça fork quando:

  • Seu processo de revisão for significativamente diferente do padrão
  • A redação padrão geraria confusão nos seus times
  • Você precisa de passos extras que serão reutilizados em muitos clientes

O fork é como você transforma o Rakenne de “melhores práticas genéricas” no seu método da casa.

7. Publicando e compartilhando suas skills

Quando você tem uma skill personalizada que funciona bem, pode publicá-la para que outras pessoas usem.

Do ponto de vista do usuário final, publicar faz três coisas:

1. Congela uma versão da skill na qual outros podem confiar.
2. Coloca a skill na biblioteca visível para a sua organização (ou para um subconjunto, dependendo da governança).
3. Torna a skill instalável em projetos normais, como qualquer skill de sistema.

Padrões comuns de compartilhamento:

• Dentro de um time
  Exemplo: o time de Segurança publica “ACME – Gap Assessment ISO 27001” adaptado à forma como a ACME interpreta certos controles.

• Entre linhas de negócio
  Exemplo: uma squad de consultoria GRC publica “SOC 2 Readiness – Versão Consultoria” para que qualquer consultor rode o mesmo fluxo com seus clientes.

• Por segmento de cliente
  Exemplo: “Relatórios Clínicos – Patrocinadores de Oncologia” vs. “Relatórios Clínicos – Dispositivos Médicos”.

Você pode continuar iterando:

• Criar a v1.1 com melhorias pontuais
• Migrar novos projetos para a versão mais recente
• Decidir caso a caso se projetos existentes devem ser atualizados

8. Cenários multi‑cliente e multi‑tenant

Se você é consultor ou presta serviços gerenciados, pode:

• Atender vários clientes no mesmo tenant do Rakenne
• Querer que cada cliente tenha seus próprios projetos, mas compartilhe skills comuns

O padrão normal é:

1. Criar / fazer fork das suas skills “versão consultoria” uma vez.
2. Publicá-las na biblioteca do seu tenant.
3. Para cada cliente:
   • Criar projetos específicos daquele cliente
   • Instalar as mesmas skills nesses projetos
4. Usar dados específicos do cliente (projetos e documentos) com os mesmos fluxos de trabalho por trás.

Isso garante:

• Metodologia consistente entre clientes
• Isolamento de dados por projeto
• Um único lugar (a skill) para atualizar sua abordagem quando normas ou boas práticas mudam

9. Juntando tudo: um exemplo concreto

Imagine que você é um consultor GRC preparando vários clientes para certificação ISO 27001.

Um fluxo realista poderia ser:

1. Encontrar skills na biblioteca

   • Buscar por “ISO 27001” e identificar:
     • “Inventário de Ativos ISO 27001”
     • “SoA ISO 27001”
     • “Avaliação de Risco ISO 27001”
     • “Escopo e Contexto do ISMS ISO 27001”
     • “Revisão pela Direção ISO 27001”

2. Instalar as skills em um projeto de cliente

   • Criar o projeto: “Cliente A – ISMS ISO 27001”.
   • Instalar essas skills ISO no projeto.

3. Rodar sessões com o cliente

   • Usar a skill de Escopo e Contexto para definir os limites do ISMS.
   • Usar Inventário de Ativos para conduzir workshops com stakeholders.
   • Usar Avaliação de Risco e SoA para gerar saídas estruturadas.

4. Ajustar a abordagem

   • Perceber que sua consultoria tem um checklist extra de revisão pela direção.
   • Fazer fork da skill de Revisão pela Direção, adicionar esse checklist e o estilo de apresentação, depois publicar como “Consultoria GRC – Revisão pela Direção”.

5. Escalar para outros clientes

   • Para “Cliente B – ISMS ISO 27001”, instalar a sua skill versão consultoria de Revisão pela Direção em vez da padrão.
   • Todos os projetos passam a compartilhar o mesmo fluxo melhorado.

Você nunca tocou em APIs ou código — só trabalhou com skills, projetos e a interface da biblioteca.

10. Próximos passos

Se esta é a sua primeira vez trabalhando com skills no Rakenne:

• Passo 1: Abra um projeto que você já usa e veja a lista de Skills instaladas.
• Passo 2: Visite a Biblioteca de Skills e escolha uma skill nova para testar nesse projeto.
• Passo 3: Para um processo que você repete entre clientes, avalie se ele merece sua própria skill com fork.

Com o tempo, a sua Biblioteca de Skills vira um catálogo vivo de como a sua organização realmente trabalha, não só de como as normas são escritas.
É aí que o Rakenne brilha.