Portfólio
40 repositórios no GitHub, 25 clonados em ~/code, mais trabalho sem versionamento. Samuel trabalha sozinho
em domínios muito diferentes, portanto os dois modos de falha são duplicação (construir algo que
já existe em outra parte do portfólio) e divergência (um novo framework para o mesmo tipo de
produto). Leia isto antes de qualquer um deles.
⚠️ Pergunta em aberto — apresentação ainda não definida
Samuel não decidiu como os projetos serão apresentados na seção de portfólio de samuelaure-web,
nem como eles devem aparecer em nau-web, nem se a agência precisará de sua própria variante.
Até que isso seja decidido, este skill pode reforçar a metade da qualidade (padrões de repositório, documentação), mas
não a metade da publicação. Se o trabalho tocar a seção de portfólio de samuelaure-web, ou um projeto
atingir um estado que valha a pena mostrar, levante a questão nesse momento — esse é o momento de projetá-lo, e deve
ser projetado uma vez e aplicado de forma consistente, em vez de improvisado por projeto.
Ativos (últimos 90 dias)
| Repo | Stack | O que é |
|---|---|---|
nau | pnpm monorepo · NestJS · Next 14 · Postgres · BullMQ · Remotion | Plataforma naŭ. 2055 commits. O sistema principal |
nau-mobile | Expo SDK 50 · React Native · SQLite | Aplicativo de captura do Instagram. Repositório independente, local-first |
groovy | Grails → NestJS · Docker | Laboratório de migração de API — padrão strangler sobre uma API Grails legada |
websites/nau-web | Astro · Express | Site de marketing da naŭ |
websites/karenexplora-web | Vite · Express | Site de cliente |
websites/violetacuesta-web | Vite · TS · Docker | Site de cliente, implantado no VPS |
websites/samuelaure-web | Vite · TS | Site pessoal — hospeda a seção de portfólio |
websites/andiuniverso-web | Vite · TS | Site de cliente |
karenexplora-freescout | Docker | Implantação de helpdesk auto-hospedada |
countdown-video | React · Remotion | Geração programática de vídeos |
nispiras | Kotlin · Android nativo | Aplicativo de sobreposição de respiração. Envia seu próprio keystore — não o regenere |
engineering_protocols | Markdown | Estes protocolos. Fonte da verdade para ~/.claude/ |
Dormentes
advent-of-code (TS) · obsidian · carrousel-automation (React/Remotion/Tailwind) ·
apify-actors (TS) · web-chatbot-widget (TS, Docker) · math-app (Vite) ·
topic-roulette (Next 16, Tailwind — sem remoto) · video-generator (NestJS) ·
whatsapp-number-checker (Express) · youtube-downloader (TS — sem remoto) ·
websites/polar-web (última modificação em 2025-12)
Descontinuados
Em ~/code/deprecated/: echonau, komunikadoj, nau-ig, r2-asset-manager.
nau-ig é o ancestral de nau-mobile — o aplicativo foi extraído, absorvido no monorepo e depois
retirado novamente. Não confunda os três.
No GitHub, não clonados
Repositórios de serviço pré-consolidação, agora dentro do monorepo nau: 9nau, flownau, nauthenticity,
whatsnau, zazu. Não clone estes para trabalhar nesses serviços — eles vivem em nau/apps/.
(Dois deles também estão como repositórios git aninhados dentro de nau/tmp/, o que é lixo.)
Outros não clonados: ai-mentor, astromatic, ecom, exercism, kinder-heldin, ludi9,
project_1, samuel-aure, adventofcodeOLD, nau-storage.
Sem versionamento — em risco
~/code/no-git/ contém nove diretórios fora do git: build-mobile, chrome-extensions, flownau,
gmb, kkj_db_backups, omniroute, repurpose, scripts, video-bank-script.
Uma falha de disco e desaparecem, e kkj_db_backups parece ser backups de banco de dados sem backup
próprio. Uma auditoria com recomendação por diretório está aprovada e pendente.
Consistência de stack
O portfólio convergiu para: TypeScript · React · Vite para sites · Next para aplicativos · NestJS para serviços · Postgres + Prisma · Docker · Remotion para vídeo · Tailwind.
Quando um projeto não tiver requisito técnico específico, escolha desse conjunto. Consistência se acumula em maestria e torna cada projeto mais barato de manter; um novo framework por projeto se acumula em manutenção para a qual ninguém tem tempo.
Divergência conhecida a resolver: seis sites, quatro abordagens — karenexplora-web,
samuelaure-web, violetacuesta-web e andiuniverso-web em Vite, nau-web em Astro,
polar-web desconhecido. Estes são o mesmo tipo de produto. Antes de construir um sétimo, escolha um e
diga por quê; convergir os seis existentes vale a pena agendar.
O padrão de qualidade
Um repositório é digno de portfólio quando alguém pode encontrá-lo, entendê-lo e executá-lo sem perguntar nada a Samuel.
- README que merece seu tamanho. O que é, por que existe, como executá-lo e a única ou duas decisões que foram realmente interessantes. Não um tutorial, não um esboço. Se um leitor não conseguir fazê-lo funcionar apenas com o README, não está pronto.
- CI funcional onde fizer sentido. Um badge verde é evidência; um quebrado é pior que nenhum.
- Sem segredos, nunca — e nenhum no histórico também.
- Sem artefatos de agente.
CLAUDE.md,.claude/,.agent/estão globalmente no .gitignore e versionados emengineering_protocols/projects/<repo>/. Um repositório que anuncia suas ferramentas de IA parece ter sido escrito por IA para qualquer um que o avalie. Deixá-los de fora mantém a questão em aberto, e a resposta honesta — sim, com protocolos de engenharia por trás — soa melhor vindo de Samuel do que de um arquivo. - Estado honesto. Um README que alega status de produção para algo quebrado custa mais credibilidade
que um projeto inacabado.
nau-mobilepassou meses se declarando descontinuado enquanto era o repositório ativo; esse é o modo de falha a evitar. - Documentação nem esparsa nem excessiva. Documentos que descrevem o que o código já diz são dívida de manutenção; documentos que capturam a decisão não óbvia, a restrição ou a pegadinha pagam por si mesmos. Quando docs e código discordam, os docs são o bug.
Mantendo isto atualizado
Quando um repositório for adicionado, removido, renomeado, mudar de stack ou se mover entre ativo e
dormente, atualize este arquivo e a tabela em global/CLAUDE.md, como parte desse trabalho. Em seguida, sincronize com
~/.claude/. Um registro que se desvia é pior que nenhum registro, porque as pessoas confiam nele.