Porque é que os programadores perdem tantas horas?
Programar exige blocos longos de trabalho, mas o dia está cheio de interrupções: um colega com dificuldades, um cliente ao telefone, um incidente em produção. Depois de uma interrupção, volta ao código — não à folha de registo de horas.
O que se perde não são os blocos grandes, mas as margens. O projeto principal do dia ainda se lembra à sexta-feira. Os vinte minutos para outro cliente, já não.
- Ajudar um colega noutro projeto.
- O cliente que liga com uma questão que ocupa quarenta e cinco minutos.
- Um incidente que obriga a largar tudo.
- Revisão de código num projeto que não desenvolve diretamente.
- Pesquisar em logs ou documentação que nunca existiu como tarefa.
O que fazer com questões de suporte de dez minutos?
Questões pequenas têm pouco impacto isoladamente, mas somam muito. Cobrar ou não depende de cada cliente: por vezes o suporte está incluído num contrato de manutenção, outras vezes cobra-se à hora ou por fração. Mas registe sempre, senão não sabe quanto custa esse contrato.
Defina com cada cliente onde registar essas horas, por exemplo num projeto ‘Suporte’ ou ‘Manutenção’, e registe assim que terminar a questão. Se não for possível, uma timeline que ajude a encontrar a questão mais tarde é útil.
| Acordo | Como registar | Porquê |
|---|---|---|
| Contrato de manutenção a preço fixo | Num projeto de suporte, não faturável | Para saber se o contrato ainda compensa |
| Suporte faturado à medida | Num projeto de suporte, faturável | Cada pedido chega à fatura |
| Suporte dentro de um projeto em curso | No próprio projeto | O orçamento do projeto mantém-se correto |
Como ajudam os commits e sessões de IA a encontrar as suas horas?
O seu trabalho deixa rastos. Um commit tem hora, repositório e mensagem. Uma sessão no Claude Code, Codex ou Cursor mostra em que problema trabalhou e durante quanto tempo. Juntamente com o calendário, são as melhores pistas do que fez num determinado dia.
São um apoio à memória, não um registo de horas. Um commit não indica quanto tempo demorou, e uma sessão de IA aberta não é tempo trabalhado. Use-os para gerar sugestões que depois valida, como explicado em Registo automático de horas.
Atenção à privacidade. Mensagens de commit, nomes de ficheiros e prompts nem sempre são para o gestor ou cliente. Mantenha esses dados privados e partilhe apenas as horas com uma breve descrição. Mais em Privacidade e contexto de IA.
O seu agente de IA pode registar horas automaticamente?
Sim, se o seu registo de horas tiver um servidor MCP. O agente com quem acabou de corrigir um bug sabe em que repositório e branch trabalhou e que commits fez. No final da sessão pode registar esse tempo, com uma descrição legível para o cliente.
- Ligue o seu assistente ao servidor MCP do registo de horas uma vez e faça login.
- Trabalhe normalmente. No fim, peça: ‘registar isto’.
- O agente envia uma descrição, o repositório, a branch e os assuntos dos commits, nunca código ou caminhos de ficheiros.
- Se houver dúvidas sobre cliente ou duração, o agente pergunta-lhe.
- O registo fica a aguardar aprovação, como as restantes horas.
Como se associa o cliente certo a um repositório está explicado em Como funciona o log_work.
Os tickets não chegam para calcular horas?
Os tickets descrevem o que há a fazer; as horas mostram o que custou. Um ticket pode estar aberto três dias e só ter duas horas de trabalho, e há muito trabalho sem ticket. Calcular horas só com base nos estados dos tickets dá uma visão distorcida.
O que resulta: coloque o número do ticket na descrição do registo de horas. Assim, qualquer pessoa pode associar as horas ao ticket sem manter dois sistemas sincronizados.
Porque registar horas num projeto a preço fixo?
Num preço fixo não fatura as horas, mas são elas que determinam se o projeto é rentável. Se não as registar, só descobre no fim que o orçamento foi ultrapassado, e não consegue estimar melhor o próximo.
Defina um orçamento em horas para o projeto e registe normalmente, com uma atividade não faturável se essas horas não forem cobradas à parte. Verifique semanalmente quanto do orçamento já foi usado, não só na entrega.
Se a sua empresa desenvolve software novo nos Países Baixos, pode ser elegível para o WBSO, o incentivo fiscal holandês para I&D. A RVO exige então registos de tempo que distingam pelo menos por dia, projeto e colaborador. Como funciona para software está em WBSO para software.
Como a Half5 faz
A aplicação desktop Half5 para Mac e Windows regista o seu trabalho numa ‘Timeline’ privada: programas e títulos de janelas, páginas do browser via extensão, commits das pastas git que escolher e sessões Claude Code, Codex e Cursor em ‘Sessões de IA’. Daí surgem ‘Sugestões’ que confirma ou ajusta. Só o utilizador pode ler a sua timeline; a Half5 não tem acesso. O responsável de equipa só vê as horas registadas. Não existe integração direta com sistemas de tickets; uma página de ticket aberta no browser aparece na timeline.
Os agentes registam via servidor MCP em https://app.half5.com/mcp com log_work. Esses registos ficam como ‘Por aprovar’. A Half5 memoriza por utilizador que repositório pertence a que cliente; gere isso em ‘Agentes ligados’, na memória de repositórios. Os projetos têm orçamento em horas: vê horas usadas, desvios ao orçamento e o relatório ‘Saúde do projeto’. Não existe exportação dedicada para WBSO; filtre o relatório por atividade, projeto e colaborador e exporte para CSV, Excel ou PDF.
Perguntas frequentes
Preciso de registar cada mudança de contexto separadamente?
Não cada mudança, mas cada tarefa para cliente ou projeto diferente. Uma timeline ou os commits ajudam a identificar essas tarefas depois, sem usar um cronómetro.
O meu empregador vê os meus commits e prompts de IA?
Na Half5, não. Commits e sessões de IA ficam na sua timeline, que só existe nos seus dispositivos e sincroniza encriptada de ponta a ponta. A organização só vê as horas registadas, com a descrição que escrever.
O Claude Code ou Cursor podem registar as minhas horas?
Sim, via MCP. O agente regista o tempo com descrição, repositório e branch, e o registo aguarda aprovação antes de contar para faturação.
Como registo horas num projeto a preço fixo?
Registe-as no projeto como habitual, com uma atividade não faturável se não forem cobradas à parte. Assim vê quanto do orçamento em horas já foi usado.
Como associo horas a tickets?
Coloque o número do ticket na descrição do registo. Assim pode pesquisar por ticket sem ter de manter o registo de horas e o sistema de tickets sincronizados.
Fontes
- RVO, Keeping S&O records (in Dutch) · consultado em
