--- title: "Controle de tempo para desenvolvedores" url: "https://timeretain.com/pt-br/blog/controle-de-tempo-para-desenvolvedores" description: "Guarde notas úteis, revise sessões esquecidas e compare estimativas com as horas que uma tarefa realmente levou." --- ![Cena em argila 3D com editor de código abstrato no computador, cronômetro grande, diagrama de ramificações, caneca e planta numa mesa creme.](/_astro/hero.DDTgAypx_ov1CI.webp) O controle de tempo para desenvolvedores pode ser um registro pessoal das próprias horas. Não precisa de plugin no editor nem de um agente tirando capturas de tela. O registro pode explicar por que uma tarefa curta consumiu a semana. Também pode descrever melhor o trabalho que “coisas diversas” e somar o tempo das reuniões. ## Para que serve Um registro pessoal pode responder a quatro perguntas: 1. **O que fiz nesta semana?** Na avaliação, vira uma lista datada, não “trabalhei na plataforma”. 2. **Quanto uma tarefa realmente custa?** Compare estimativas e horas para ver quais partes faltaram. 3. **Onde foi a semana?** Separe funcionalidades, depuração, revisão, reuniões e tarefas secundárias imprevistas. O total de reuniões dá algo concreto para discutir quando prioridades competem. Inclua preparação se quiser ver o tempo inteiro exigido. 4. **O que vou faturar?** Se cobra diretamente, precisa de horas com notas reconhecidas pelo cliente. Mantenha um registro simples: em que trabalhou, para quem e por quanto tempo. Use [controle manual](/pt-br/blog/controle-manual-do-tempo-sem-vigilancia), com alguns ajustes para desenvolvimento. ## A entrada mínima Mantenha cada entrada pequena o suficiente para escrevê-la: | Campo | Por que guardar | | --- | --- | | Projeto ou cliente | A qual produto, base de código ou cliente pertence | | Início e fim | Limites reais, não duração digitada de memória | | Nota | Resultado, com chamado ou branch quando existir | | Situação de cobrança | Só se fatura; empregados podem dispensar | “PROJ-142: corrigi condição de corrida no checkout” faz sentido na avaliação ou fatura. “Programação” não. Se a entrada pode chegar a um cliente ou gestor, descreva o resultado nas palavras deles: o que corrigiu, entregou ou revisou. A briga com o webpack fica numa nota privada. Você não precisa de uma árvore que reproduza o sistema de chamados. Reúna trabalho por projeto ou cliente e marque depuração, revisão e reuniões para comparar entre projetos. Num dia simples, a nota sozinha basta. ## Um dia que faz sentido no mês seguinte Veja um dia hipotético: | Data | Início | Fim | Projeto | Nota | Tipo | Total | | --- | --- | --- | --- | --- | --- | --- | | 12 ago. | 09:10 | 10:40 | Checkout | PROJ-142: corrigi condição de corrida no checkout | Depuração | 1 h 30 min | | 12 ago. | 10:40 | 11:20 | Checkout | Revisei PR #418 sobre novas tentativas de pagamento | Revisão | 40 min | | 12 ago. | 11:30 | 12:20 | Plataforma | Planejamento do sprint | Reuniões | 50 min | | 12 ago. | 13:15 | 14:10 | Checkout | Li documentação do fluxo de pagamento (estimativa) | Pesquisa | 55 min | A última linha é uma estimativa baseada nas notas e no calendário. Um commit posterior ajuda a identificar a tarefa, mas não estabelece a duração. ## Registre sessões, não atividade do editor Um histórico do IDE deixa duas lacunas no registro pessoal. Primeiro, editor aberto não comprova trabalho, e fechado não comprova descanso. Ler documentação, desenhar um modelo de dados no papel e olhar para o teto até entender o bug fazem parte da tarefa. Uma ferramenta limitada ao editor pode perder isso. Segundo, projeto ou objetivo podem faltar. Um repositório ou título de janela pode identificar o projeto. Uma página compartilhada de documentação nem sempre diz qual cliente precisava da pesquisa. Quando falta identificação, você interpreta o histórico depois. É onde [o registro automático precisa da sua avaliação](/pt-br/blog/quando-o-registro-automatico-precisa-de-avaliacao). Um histórico em segundo plano pode servir de apoio para classificar depois. Use-o para preencher lacunas nas sessões. Use a sessão de trabalho como unidade. Inicie ao sentar para uma tarefa. Pare ao mudar de tarefa, reunião ou cliente e pause nos intervalos. Uma nota junto desses limites dá contexto para a revisão. O registro responde às suas perguntas. Pode ficar separado de qualquer monitoramento do empregador. Mantenha as notas dentro do que seu empregador ou cliente permite anotar fora dos sistemas deles. ## Recupere uma sessão enquanto lembra Um commit ou pull request pode lembrar o trabalho. Calendário e mensagens ajudam a completar. Use as pistas para estimar uma sessão esquecida e marque como estimativa. Dois commits separados por uma hora não comprovam uma hora de trabalho. Você pode ter pausado ou mudado de tarefa. Pesquisa e depuração podem não deixar commit algum. Inclua quando lembrar, sem tratar alterações de código como o trabalho inteiro. Se não conseguir uma estimativa útil, deixe a duração desconhecida. Na próxima sessão, registre enquanto trabalha. ## Use as horas para revisar estimativas Se registra todo o tempo da tarefa, consegue compará-lo com a estimativa. Anote a estimativa no chamado, registre a tarefa e compare. Procure duas coisas em tarefas semelhantes: - **Espaço para trabalho esquecido.** Se correções semelhantes exigem repetidamente revisão e testes além do previsto, inclua esses passos da próxima vez. Reserve mais incerteza para trabalho desconhecido. - **Onde ocorreu o estouro.** Compare programação, depuração, integração, configuração do ambiente e revisão. Se há um padrão, estime essas partes separadamente. Isso também serve para preço fixo. Ao concluir, divida o preço por todas as horas para obter receita por hora antes dos custos. Use as horas para planejar trabalho parecido. Você pode conferir o próximo preço com custos e renda desejada, em vez de repetir esse valor. ## Depuração e retrabalho de clientes Pule esta seção se não trabalha para clientes. Depuração e retrabalho podem desaparecer numa entrada vaga. **Depuração.** Registre a sessão e o resultado: “Identifiquei e corrigi webhook duplicado no fluxo de pagamento” é uma linha compreensível ao cliente. Separe testes, depuração e retrabalho quando isso ajuda a avaliar. O registro pode incluir tempo que não cobra. Identifique o retrabalho para revisar as horas. A divisão entre [faturável e não faturável](/pt-br/blog/horas-faturaveis-e-nao-faturaveis) ajuda a organizar. **Desvios demorados.** Um conflito de dependências pode consumir quatro horas, apesar da descrição curta. Registre a duração real e o obstáculo. Se usa um número menor na fatura, deixe as quatro horas no seu registro. Mudar o original para “talvez duas” perde informação. Deixe trabalho sem cliente visível também. Propostas, faturamento e aprender um framework não solicitado saem da mesma semana que você cobra. Omiti-los subestima o tempo que o negócio exige. ## Onde o TimeRetain entra O registro guarda sistemas usados, noites trabalhando, carga real de reuniões e, se cobra, nomes e valores de clientes. Você não precisa enviar esse histórico para mantê-lo. O [TimeRetain](https://timeretain.com) é um [cronômetro manual](/pt-br/blog/controle-manual-do-tempo-sem-vigilancia) para guardar esse registro no dispositivo. Veja quanto tempo foi para revisão, reuniões e depuração e o que cada sessão produziu. Nada observa seu IDE. Se fatura, use notas para explicar a entrega. Guarde retrabalho não cobrado para ver o que o projeto realmente exigiu. O registro principal fica no dispositivo. Se ativar a sincronização, o TimeRetain guarda uma cópia criptografada nos próprios servidores. ![TimeRetain](/favicon.svg) Guarde uma semana que consiga explicar. Registre a próxima sessão no TimeRetain. [Abrir aplicativo →](/) ## Comece por uma semana Não monte um sistema inteiro. Por uma semana, registre só sessões reais: projeto ou cliente, início, fim, nota com o chamado. Use git e notas para estimar sessões esquecidas enquanto lembra do dia. Deixe lacunas que não consegue sustentar. Depois releia. Compare o total das reuniões com a sensação da semana. Compare uma ou duas tarefas com suas estimativas. Se o registro ajuda a avaliar ou faturar e o esforço vale a pena, continue. ## Perguntas e respostas ### Como desenvolvedores registram o tempo? Uma opção é iniciar ao começar a sessão, parar ao mudar e identificar o resultado numa nota curta. Um caderno ou planilha guarda o mesmo registro. Ler documentação e pensar num bug também fazem parte do trabalho. ### Como recuperar horas que esqueci de registrar? Use commits, pull requests, execuções de CI e eventos de calendário como pistas, não como prova dos limites da sessão. A estimativa pode ficar acima ou abaixo, pois as lacunas podem incluir pausas, outros trabalhos ou pesquisa sem commit. Marque como estimativa e deixe a duração desconhecida se faltarem evidências. ### Um desenvolvedor deve usar registro automático? Um histórico só do IDE pode perder trabalho fora do editor, e pode faltar o cliente ou projeto. A captura automática pode recuperar sessões esquecidas. Escolha o método que consegue explicar e corrigir com menos esforço. ### Como registrar depuração em trabalho freelance? Registre a sessão inteira e identifique o resultado, mesmo que depois fature um valor menor. Guarde o retrabalho no registro privado para avaliar quanto tempo levou. ### Registrar o tempo melhora estimativas? Comparar horas registradas com estimativas originais pode mostrar onde você errou. Use padrões de tarefas parecidas para ajustar as próximas estimativas, considerando trabalho desconhecido e variação.