Passei a manhã organizando meus snippets de código e percebi que estava a cometer o mesmo erro há meses: guardar tudo numa única pasta sem categorização. O disco rígido zumbia baixinho enquanto reorganizava ficheiros, aquele som familiar de sextas-feira quando faço limpeza digital.

Criei um sistema simples que funciona assim:

Checklist de organização:

• [ ] Criar pasta /snippets com subpastas por linguagem
• [ ] Dentro de cada linguagem, separar por categoria (utils, hooks, components)
• [ ] Adicionar comentário no topo de cada snippet com: data, uso, e dependências
• [ ] Criar um README.md em cada pasta com índice rápido
• [ ] Fazer backup automático para a nuvem

O erro mais comum que vejo (e que eu fazia): guardar snippets sem contexto. Voltava ao código três meses depois e não fazia ideia de onde usar aquilo. Agora escrevo sempre uma linha no topo: // Uso: formulários com validação async | Deps: zod, react-hook-form.

Testei dois métodos de nomenclatura. Primeiro tentei nomes descritivos longos tipo formulario-com-validacao-assincrona-e-mensagens-erro.ts. Depois mudei para códigos curtos com prefixos: form-async-01.ts. O segundo método é muito mais rápido para encontrar com autocomplete no editor.

A parte que mais me surpreendeu foi criar um script de 5 linhas que gera automaticamente o índice do README.md lendo os comentários de cada ficheiro. Poupa-me 20 minutos por semana.

Tarefa para hoje: Abre a tua pasta de snippets e adiciona um comentário de uma linha ao topo dos 3 ficheiros que mais usas. Apenas isso. Amanhã o teu eu do futuro agradece.

O truque é começar pequeno. Não preciso de reorganizar tudo hoje - apenas criar a estrutura base e ir migrando aos poucos. Já tenho 15 snippets categorizados e já sinto a diferença.

#organizacao #programacao #produtividade #snippets