Neste artigo
- O que o time faz por você sem você perceber
- README honesto: a documentação que o futuro você vai cobrar
- Issues como memória externa
- CI simples: os testes do futuro você
- Changelog: a memória do que mudou e por quê
- Editor e documentação offline: as ferramentas do plantão
- A rotina mínima em quatro rituais
- Vale abrir pull request em projeto solo?
- O que não pode faltar no README de um projeto solo?
- Quanto de teste é suficiente para um projeto de uma pessoa?
- Como manter o ritmo quando o projeto é apenas um side project?
Uma das discussões mais úteis da semana no r/github sobre workflow individual partiu de uma pergunta aparentemente pequena: quem mantém repositórios sozinho vale a pena abrir pull request em rascunho só para rodar a integração contínua antes de se sentir pronto para revisão, se ninguém vai olhar esses repositórios mesmo? O autor relatava que as verificações já rodavam no push de qualquer forma, que o selo de rascunho dava uma sensação boa de mexer sem pressão, e que ficava em dúvida se isso era processo de verdade ou só cerimônia herdada de quem trabalha em time. A dúvida condensa o dilema de todo dev solo: as cerimônias do time fazem sentido quando existe time?
A resposta que sustenta este guia é outra pergunta: sem segunda opinião, o processo é o que substitui o time. Revisão, memória, cadência e coragem de recomeçar são funções que um colega cumpre sem você perceber, e quem programa sozinho precisa pagar cada uma delas com hábito ou ferramenta. O que segue é o setup mínimo relatado pela comunidade para manutenção de projeto de uma pessoa só, com foco em manter o que já existe, não em lançar a primeira versão.
O que o time faz por você sem você perceber
Antes das ferramentas, o mapa das funções. Quem trabalha em time recebe de graça uma série de serviços que o dev solo precisa provisionar manualmente:
| Função que o time cumpre | O que substitui no setup solo |
|---|---|
| Revisão de código e segunda opinião | Integração contínua com testes e lint rodando a cada mudança |
| Memória compartilhada das decisões | README honesto e issues documentando contexto |
| Registro do que mudou e por quê | Changelog escrito em cadência fixa |
| Pressão social para não quebrar o principal | Ramo principal protegido e pipeline bloqueando merge |
| Retrospectiva periódica | Ritual semanal de triagem de issues |
Olhando a tabela, fica claro por que a dúvida do r/github merecia resposta afirmativa: o pull request em rascunho do dev solo não serve para revisão, serve para acionar a função de revisão que não existe em pessoa, ou seja, as verificações automatizadas. A cerimônia que sobra é a que substitui alguém.
README honesto: a documentação que o futuro você vai cobrar
O primeiro pilar do setup é o README, e o adjetivo que importa é honesto. Documentação de projeto solo não se escreve para visitante, se escreve para o futuro você, que em três meses será um estranho com acesso ao repositório e zero memória das decisões. O README mínimo de manutenção responde quatro perguntas: o que este projeto faz em uma frase, como rodar em ambiente novo do zero, o que está quebrado ou pendente agora, e quais decisões estruturais foram tomadas e por quê.
A parte que quase todo mundo pula é a terceira. Estado atual é a seção mais valiosa do README solo, porque ela evita o pior cenário do trabalho individual: reabrir o projeto depois de um mês e gastar a primeira tarde inteira decifrando em que pé estava. Uma linha de "pendências hoje" atualizada a cada sessão vale mais que um documento de arquitetura imponente e desatualizado. E honestidade aqui tem segunda camada: README que promete funcionalidade que não existe envenena a confiança do único leitor que importa. Escreva o que é, não o que você planeja que seja, e o plano fica nas issues.
💡 Dica: toda vez que você se pegar explicando em voz alta como rodar ou como uma parte funciona, pare e escreva isso no README. Explicação dada duas vezes é documentação pedindo para nascer.
Issues como memória externa
O segundo pilar é tratar a lista de issues como memória externa, não como quadro de tarefas corporativo. A cabeça de quem programa sozinho é um péssimo armazém: ela guarda a empolgação do momento e apaga o contexto de ontem. A disciplina que sustenta projeto longo é descarregar cada ideia, bug e dúvida em uma issue no dia em que eles aparecem, com o contexto escrito junto. Uma boa issue solo tem três campos: o problema ou ideia em uma frase, o contexto que faria diferença em três meses, e o próximo passo concreto.
O ganho silencioso desse hábito é a fila de retomada. Em time, quando alguém volta de férias, o quadro conta onde as coisas pararam. No solo, a issue cumpre esse papel: você senta, abre a lista, escolhe o item e recomeça em minutos em vez de horas. As issues fechadas, por sua vez, viram o histórico de decisões do projeto, aquele registro de por que determinado caminho foi escolhido que economiza reabrir discussão consigo mesmo. Quem mantém mais de um projeto sabe que o gargalo raramente é escrever código: é lembrar o que havia para fazer, e a memória externa resolve exatamente isso.
CI simples: os testes do futuro você
O terceiro pilar é a integração contínua, e aqui o relato do r/github entrega a melhor justificativa do setup. As verificações do projeto do autor rodavam no push de qualquer forma, com ou sem pull request aberto, e o valor real do rascunho era psicológico: um espaço com selo de não pronto, onde mexer não cobra imposto. Traduzido para o setup solo: o que importa não é a cerimônia do pull request, é existir um pipeline que roda os testes do futuro você a cada mudança, sem depender da disciplina de rodar na mão.
Porque é do futuro você que os testes cuidam. O teste automatizado é a única forma de revisão de código que um dev solo consegue contratar: ele revisa cada mudança com o mesmo rigor, nunca está ocupado e nunca esquece o caso borda. O conjunto mínimo relatado pela comunidade cabe em três itens: verificação de estilo com lint, suíte de testes cobrindo o caminho crítico e bloqueio do merge quando algo falha. Simples assim. A sofisticação vem depois, e o guia completo da ferramenta Git para desenvolvedores mostra como estruturar ramos e histórico de modo que o pipeline trabalhe a seu favor em vez de atrapalhar.
⚠️ Atenção: pipeline vermelho ignorado é pior que pipeline inexistente, porque ensina o cérebro a conviver com o problema. A regra do dev solo é dura e simples: principal sempre verde, e o que quebra volta ao topo da fila de issues no mesmo dia.
Changelog: a memória do que mudou e por quê
O quarto pilar é o changelog, a disciplina mais barata e mais abandonada do setup solo. A ideia não é burocracia de versão, é um diário curto do que mudou e do porquê, escrito em cadência fixa. Cada entrada soma duas linhas: o que passou a funcionar ou parou, e a razão da mudança. Em projeto de uma pessoa, esse registro cumpre três funções ao mesmo tempo: retrata o progresso nos dias em que a sensação é de estagnação, alimenta a comunicação com usuários quando o projeto tem público, e reconstrói a linha do tempo quando um comportamento estranho aparece e você precisa saber o que mudou antes dele.
A cadência importa mais que o formato. Anotar na sessão em que a mudança acontece leva um minuto; reconstruir três semanas de commits para escrever a entrada atrasada leva uma tarde. Vale escolher um gatilho fixo, o fim de cada semana ou o fechamento de cada versão pequena, e tratar a entrada do changelog como parte da tarefa, não como extra. Projeto que tem changelog tem, de brinde, material pronto para README atualizado e para a próxima issue.
Editor e documentação offline: as ferramentas do plantão
Com o processo coberto, o setup se completa com as ferramentas que economizam interrupção. A primeira é o editor bem configurado: no solo não existe o colega de plantão para perguntar atalho, padrão ou diagnóstico, e uma configuração enxuta de extensões cumpre parte desse papel. A casa já mantém a lista das extensões de VS Code que todo dev precisa, e vale revisar a sua instalação contra ela: cada extensão a mais que não trabalha é ruído, cada uma a menos que trabalharia é pergunta jogada fora.
A segunda ferramenta é a documentação offline. Perguntar ao engine é rápido, mas em manutenção o que resolve é a referência oficial aberta ao lado, sem depender de rede nem de resposta genérica. O passo a passo para usar o DevDocs e consultar documentação offline cobre o setup de um acervo pessoal de referências, que no dia a dia solo funciona como o colega sênior que responde sem julgar. Duas ferramentas, nenhum cerimonial: é o ponto exato onde setup solo deve parar de crescer.
A rotina mínima em quatro rituais
Setup sem cadência vira pilha de boas intenções. A rotina mínima que sustenta o pacote anterior cabe em quatro rituais de duração pequena:
- Diário: commit pequeno com mensagem honesta e README atualizado quando o estado do projeto muda. O commit de hoje é o contexto de amanhã.
- Semanal: triagem de issues em um bloco fixo, escolhendo as três prioridades da semana seguinte e arquivando o que perdeu o sentido. É a retrospectiva do time de um.
- Mensal: entrada consolidada no changelog, atualização de dependências e conferência de que o principal segue verde.
- Por entrega: tag na versão, nota no changelog e revisão rápida do README para o próximo visitante, que provavelmente será você.
Nenhum ritual passa de uma sessão curta, e é essa medida que faz o setup sobreviver à empolgação inicial. Quem quiser organizar a agenda em torno desses rituais encontra na casa o guia dos cinco segredos do setup dev produtivo, que cobre a camada de ambiente e foco que completa a de processo.
O projeto solo não afunda por falta de talento, afunda por falta de contexto: o código continua lá, o que se perde é a memória de como ele funciona e o reforço de que ele continua funcionando. README honesto, issues como memória externa, integração contínua simples e changelog em cadência são as quatro peças que substituem o time que você não tem. A pergunta do r/github, respondida com método, vira a resposta mais tranquilizadora possível: sim, o rascunho vale, porque tudo o que roda sozinho hoje é o colega que você não precisou contratar.
Perguntas frequentes
Vale abrir pull request em projeto solo?
Vale, mas pelo motivo certo: não para revisão humana, que não existe, e sim para acionar as verificações automatizadas e manter o histórico de mudanças organizado. O relato do r/github mostra que o selo de rascunho ainda adiciona a liberdade de mexer sem pressão de entrega.
O que não pode faltar no README de um projeto solo?
Uma frase com o que o projeto faz, o passo a passo para rodar em ambiente novo, a seção de estado atual com pendências de hoje e o registro das decisões estruturais. A seção de estado é a mais negligenciada e a mais valiosa na retomada.
Quanto de teste é suficiente para um projeto de uma pessoa?
O mínimo que trava o caminho crítico: os fluxos que, se quebrarem, tornam o projeto inútil. Cobertura total é objetivo de time grande; no solo, a meta é que a integração contínua confie o suficiente para você fazer mudança sem medo.
Como manter o ritmo quando o projeto é apenas um side project?
Reduzindo o ritual ao que cabe: um bloco semanal de triagem de issues, commits pequenos em qualquer dia livre e changelog por entrega. A cadência menor continua sendo cadência, e memória externa vale o mesmo em projeto grande ou pequeno.