Communitygithub.com

samuelaure/engineering-protocols

Registro completo do repositório, consistência de tech stack, padrão de qualidade que torna um projeto digno de portfólio e publicação de projeto no site pessoal. Carregue antes de iniciar um novo projeto, escolher uma stack, decidir se algo já existe ou apresentar trabalho publicamente.

O que é engineering-protocols?

Este skill define os protocolos de engenharia para o portfólio de Samuel Laure, fornecendo um registro centralizado de todos os repositórios ativos, dormentes e descontinuados, além de orientações sobre consistência de tech stack e padrões de qualidade. Ele é útil para evitar duplicação e divergência ao iniciar novos projetos, garantindo que a escolha de frameworks seja coerente com a stack já consolidada (TypeScript, React, Vite, Next.js, NestJS, Postgres, Prisma, Docker, Remotion, Tailwind). O skill também estabelece critérios rigorosos para que um repositório seja considerado digno de portfólio, incluindo README completo, CI funcional, ausência de segredos e de artefatos de agente de IA, além de documentação objetiva. Ele é usado principalmente no Claude Code e deve ser carregado sempre que Samuel for iniciar um novo projeto, escolher uma tecnologia ou decidir sobre a apresentação pública de um trabalho.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/samuelaure/engineering-protocols/tree/HEAD/skills/portfolio

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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)

RepoStackO que é
naupnpm monorepo · NestJS · Next 14 · Postgres · BullMQ · RemotionPlataforma naŭ. 2055 commits. O sistema principal
nau-mobileExpo SDK 50 · React Native · SQLiteAplicativo de captura do Instagram. Repositório independente, local-first
groovyGrails → NestJS · DockerLaboratório de migração de API — padrão strangler sobre uma API Grails legada
websites/nau-webAstro · ExpressSite de marketing da naŭ
websites/karenexplora-webVite · ExpressSite de cliente
websites/violetacuesta-webVite · TS · DockerSite de cliente, implantado no VPS
websites/samuelaure-webVite · TSSite pessoal — hospeda a seção de portfólio
websites/andiuniverso-webVite · TSSite de cliente
karenexplora-freescoutDockerImplantação de helpdesk auto-hospedada
countdown-videoReact · RemotionGeração programática de vídeos
nispirasKotlin · Android nativoAplicativo de sobreposição de respiração. Envia seu próprio keystore — não o regenere
engineering_protocolsMarkdownEstes 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 em engineering_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-mobile passou 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.

Habilidades Relacionadas