A Disciplina de Sessão

Tudo no FlowForge se apoia em um pequeno ciclo repetido: uma sessão roda sobre um ticket, sobre um cronômetro, sobre uma branch de feature. Este capítulo explica o ciclo e, mais importante, por que ele é o ponto central em vez de ser uma tarefa maçante.

O ciclo

/flowforge:session:start [ticket]   →   trabalho   →   /flowforge:session:end "resumo"

• Start verifica o ticket, inicia o cronômetro, faz o checkout da branch de feature e restaura o contexto.
• Trabalho acontece com o relógio correndo e a branch protegendo a main.
• End para o cronômetro, escreve um resumo e deixa um rastro limpo para trás.

O pause e o end existem para as interrupções naturais de um dia. O que nunca acontece é trabalho sem sessão.

Um ticket é a sua vitrine

Uma vitrine é a janela da loja. O seu ticket é onde o seu trabalho fica exposto.

• Trabalho sem ticket não deixa rastro. Ele não pode ser medido, não pode ser visto e não será contabilizado quando um aumento ou uma promoção for decidido.
• Em uma equipe, você é um recurso para os outros, e mostrar o seu trabalho é responsabilidade sua, não deles.
• Dimensione um ticket bem calibrado por entrega real — não cinco tickets para uma feature (isso soa como agitação sem rumo), nem um ticket gigante para um mês de trabalho (isso soa como uma caixa-preta). Um ticket, uma coisa entregue.

Isso é a Regra #5, e é o motivo pelo qual o session-start se recusa a rodar sem um ticket válido.

O cronômetro é a prova

O FlowForge vende rastreamento de tempo: seus clientes registram horas para gerar relatórios para os clientes deles. Então o FlowForge registra as próprias horas do mesmo jeito — comendo da própria comida.

• Sem cronômetro, sem registro. Uma hora não rastreada é uma hora que você não pode faturar nem defender.
• O cronômetro inicia automaticamente no session-start, então o caminho honesto não lhe custa nada.
• Tempo é dinheiro: isso não é um slogan, é a promessa central do produto voltada para dentro.

Branch, nunca a main

A Regra #18 é absoluta: nunca faça commit diretamente na main ou na develop. O session-start sempre coloca você em uma branch de feature (feature/<ticket>-work, ou uma branch com escopo de milestone quando o modo milestone está ativo). Branches protegidas permanecem limpas, os releases permanecem seguros e cada mudança chega por meio de um pull request revisável.

O checklist de pré-decolagem

Uma sessão saudável, sempre:

• Ticket aberto e verificado
• Cronômetro correndo
• Em uma branch de feature (não na main/develop)
• Então — e somente então — construa

O session-start roda este checklist por você. Se algum item não puder ser satisfeito, ele para e diz o porquê, em vez de iniciar um trabalho desonesto.

Por que isso importa

A disciplina de sessão é o que converte esforço em evidência. Um mês de sessões é um histórico consultável do que você fez, de quanto tempo levou e de por que importou — a matéria-prima para relatórios, retrospectivas e para o argumento de que você merece ser bem pago. Pule a sessão e o trabalho ainda acontece; ele apenas deixa de contar.