Rastreamento de Tempo

O que é: Registro de horas.

Visão Geral

Identifica a menor configuração útil de Rastreamento de Tempo para o negócio em questão e, em seguida, a constrói apenas quando solicitada. A saída padrão é uma recomendação curta, não uma planilha. Artefatos - CSV, SQL DDL, JSON Schema, mapeamento do Notion - são produzidos sob demanda, a partir de uma lista de campos para que não se afastem.

Camada: Camada 4: Gerenciar. Adequado para: Estágio inicial. Código da tabela: n/a.

Quando Usar Esta Habilidade

• rastreador de tempo
• modelo de folha de ponto
• registro de horas
• rastreador de horas faturáveis

Use também quando o usuário disser "registro de horas" ou descrever o mesmo processo ocorrendo em uma planilha, um documento ou alguém envia 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, depois 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 introdução:

P: Você fatura por hora?

Etapa 2 - Pergunte apenas o que está faltando

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

• Propósito - Faturável ou interno? / Faturamento de cliente? / Produtividade?
• Granularidade - Diária ou semanal? / Projeto ou tarefa? / Entrada mínima?
• Processo - Quem aprova? / Período de bloqueio? / Correções permitidas?
• Processo atual - Como você registra o tempo agora? / Ferramenta ou planilha? / Está completo?
• Resultado - O que você precisa? / Um registro, faturas ou entrada para folha de pagamento?

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: time-tracking
intent: null            # setup | advice | review | fix | build | convert | export
scale: null             # Starter | Growth | Scale, only if the answer changes it
areas:
  "Purpose": null
  "Granularity": null
  "Process": 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: Colete o tempo por projeto e conecte o faturamento a ele apenas se você faturar por hora. Bloqueie o período assim que for faturado.

Por que esta: Os dados de tempo só valem a pena coletar se algo os utiliza. O faturamento é o motivo mais forte; se não houver nenhum, mantenha a entrada mínima.

Fluxo de trabalho: Entrada → Aprovação → Bloqueio do período → Fatura ou visualização de custo

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, direcione a etapa do Notion para lá. Quando o usuário selecionar Notion, passe essa etapa para @notion-manual-import: 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 reafirme o mapeamento aqui e não improvise as etapas de importação. Saídas manuais de CSV e mapeamento não precisam de conexão. Para alterações solicitadas no espaço de trabalho, siga o contrato compartilhado: verifique o acesso real à ferramenta e o destino antes de escrever. Um usuário dizendo "conectado" não é evidência de ferramenta.

…