Manual de Integração (Onboarding Playbook)

O que é: Integração estruturada.

Visão Geral

Desenvolve a configuração mínima útil do Manual de Integração para o negócio em questão e, em seguida, constrói-o apenas quando solicitado. A saída padrão é uma recomendação curta, não uma planilha. Artefatos - CSV, SQL DDL, JSON Schema, mapeamento Notion - são produzidos sob demanda, a partir de uma lista de campos para que não possam se desviar.

Camada: Camada 3: Integrar. Adequado para: Estágio de crescimento. Código da tabela: n/a.

Quando Usar Esta Habilidade

• lista de verificação de integração
• manual de integração
• plano de 30 60 90 dias para novos contratados
• rastreador de etapas de integração

Use também quando o usuário disser "integração estruturada" ou descrever o mesmo processo ocorrendo em uma planilha, um documento ou por e-mail.

Não use para: cálculo de folha de pagamento, declaração de impostos ou aconselhamento jurídico. Esta habilidade produz apenas modelos vazios - nunca armazena ou processa dados reais de funcionários ou clientes.

Como Funciona

Siga o contrato de execução compartilhado. As regras específicas do módulo abaixo definem apenas campos de domínio, decisões, cálculos e restrições de segurança.

Etapa 1 - Identificar a intenção

Leia a solicitação e escolha a intenção antes de perguntar qualquer coisa.

• "configurar" ou "construir" ou "criar" -> o usuário quer artefatos; vá para a Etapa 2.
• "nosso processo é ..." ou "está em uma planilha" -> o usuário quer mover um processo existente; capture-o e, em seguida, vá para a Etapa 2.
• "isso está certo" ou "revisar" ou "auditar" -> o usuário quer uma verificação, não uma construção; responda com base no que eles compartilham.
• "como eu faço ..." -> pergunta de aconselhamento; responda diretamente e ofereça a construção apenas se ajudar.

Pergunte apenas se este é o fato ausente de maior valor; caso contrário, prossiga sem uma abertura:

P: Quando um novo contratado começa?

Etapa 2 - Pergunte apenas o que está faltando

Pule qualquer coisa que o usuário já respondeu em uma mensagem anterior. Pergunte o restante um de cada vez e pare assim que as respostas restantes não alterarem a saída.

• Jornada - Quanto tempo dura a integração? / É igual para todos? / Por cargo ou por pessoa?
• Etapas - Tarefas do primeiro dia? / Primeira semana? / 30, 60, 90 dias?
• Responsabilidade - Quem é responsável por cada etapa? / Gerente ou RH? / Quem aprova?
• Processo atual - Está documentado? / Lista de verificação usada? / O que é pulado?
• Resultado - O que você precisa? / Uma lista de verificação, um cronograma ou relatórios?

Nunca invente uma resposta. Se o usuário não souber, registre como desconhecido e continue.

Etapa 3 - Mantenha o contexto interno

Mantenha as respostas nesta forma. Ela permanece interna - não é mostrada ao usuário, a menos que ele peça, e nunca carrega um valor que o usuário não forneceu.

module: onboarding-playbook
intent: null            # setup | advice | review | fix | build | convert | export
scale: null             # Starter | Growth | Scale, only if the answer changes it
areas:
  "Journey": null
  "Steps": null
  "Ownership": null
  "Current process": null
  "Outcome": null
requested_outputs: []   # csv | sql | json | notion | xlsx - requested formats only
confirmed_facts: []     # only what the user actually said
open_questions: []      # the unanswered ones, in the order worth asking

Etapa 4 - Recomende o menor fluxo de trabalho

Se um artefato foi solicitado, construa-o após resolver os fatos essenciais ausentes. Caso contrário, dê uma recomendação curta e ofereça o artefato relevante.

Abordagem recomendada: Construir uma lista de verificação com um responsável e um prazo a partir da data de início, para que o mesmo plano se aplique a todos os novos contratados.

Por que esta: Planos de integração falham quando são documentos por pessoa. Um plano com prazos em dias é reutilizável e evita que 30% de faltas sejam perdidas.

Fluxo de trabalho: Oferta aceita → Pré-integração → Primeiro dia → Primeira semana → 30, 60, 90 dias

Etapa 5 - Construa apenas sob demanda

Assim que o usuário solicitar, derive os campos do contexto confirmado e emita os artefatos solicitados. Para texto legível por máquina, mantenha a prosa fora dos dados; para arquivos, forneça um link utilizável. Relate falhas de validação de material ou limitações separadamente.

Uma saída selecionada do Notion é renderizada por notion-manual-import, portanto, roteie a etapa do Notion para lá. Quando o usuário selecionar Notion, entregue essa etapa para ](https://github.com/sickn33/agentic-awesome-skills/blob/main/skills/notion-manual-import/SKILL.md): ela contém o CSV, o mapeamento de propriedades, as etapas de importação e a lista de verificação de verificação, e renderiza a Referência de Campo abaixo em vez de definir uma tabela própria. Não repita o mapeamento aqui e não improvise as etapas de importação. Saídas manuais de CSV e mapeamento não precisam de

…