Communitygithub.com

samuelaure/engineering-protocols

Registro completo del repositorio, consistencia del stack tecnológico, estándar de calidad que hace que un proyecto sea digno de portafolio y publicación del proyecto en el sitio personal. Cárgalo antes de iniciar un nuevo proyecto, elegir un stack, decidir si algo ya existe o presentar trabajo públicamente.

¿Qué es engineering-protocols?

Este skill proporciona a Samuel un registro completo y actualizado de todos sus repositorios (activos, inactivos, en GitHub no clonados y sin versionar), junto con reglas estrictas de consistencia tecnológica y un estándar de calidad que garantiza que cualquier repositorio pueda ser encontrado, entendido y ejecutado por otros sin necesidad de preguntarle a él. Está diseñado para su uso con asistentes de IA como Claude Code y agentes similares, y se carga automáticamente antes de tomar decisiones sobre nuevos proyectos o stacks. El skill define que el portfolio ha convergido en un stack específico (TypeScript, React, Vite, Next, NestJS, Postgres, Prisma, Docker, Remotion, Tailwind) y advierte contra la divergencia; también establece una barra de calidad que incluye README completos, CI funcional, ausencia de secretos, sin artefactos de agente IA en los repositorios de proyectos, estado honesto y documentación equilibrada. Además, exige mantener sincronizado este archivo con `global/CLAUDE.md` para evitar la deriva de información.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Portafolio

40 repositorios en GitHub, 25 clonados en ~/code, más trabajo sin versionar. Samuel trabaja solo en dominios muy diferentes, por lo que los dos modos de fallo son duplicación (construir algo que ya existe en otra parte del portafolio) y divergencia (un nuevo framework para el mismo tipo de producto). Lee esto antes de cualquiera de los dos.

⚠️ Pregunta abierta — la presentación aún no está definida

Samuel no ha decidido cómo se presentan los proyectos en la sección de portafolio de samuelaure-web, ni cómo deberían aparecer en nau-web, ni si la agencia necesitará su propia variante.

Hasta que eso se decida, este skill puede hacer cumplir la mitad de calidad (estándares del repositorio, documentación) pero no la mitad de publicación. Si el trabajo toca la sección de portafolio de samuelaure-web, o un proyecto alcanza un estado que vale la pena mostrar, plantea la pregunta entonces — ese es el momento de diseñarlo, y debe ser diseñado una vez y aplicado de manera consistente en lugar de improvisado por proyecto.

Activos (últimos 90 días)

RepoStackQué es
naupnpm monorepo · NestJS · Next 14 · Postgres · BullMQ · RemotionPlataforma naŭ. 2055 commits. El sistema principal
nau-mobileExpo SDK 50 · React Native · SQLiteAplicación de captura tipo Instagram. Repo independiente, local-first
groovyGrails → NestJS · DockerLaboratorio de migración de API — patrón strangler sobre una API Grails heredada
websites/nau-webAstro · ExpressSitio de marketing de naŭ
websites/karenexplora-webVite · ExpressSitio de cliente
websites/violetacuesta-webVite · TS · DockerSitio de cliente, desplegado en el VPS
websites/samuelaure-webVite · TSSitio personal — aloja la sección de portafolio
websites/andiuniverso-webVite · TSSitio de cliente
karenexplora-freescoutDockerDespliegue de helpdesk autoalojado
countdown-videoReact · RemotionGeneración de video programática
nispirasKotlin · Android nativoAplicación de superposición de respiración. Trae su propio keystore — no lo regeneres
engineering_protocolsMarkdownEstos protocolos. Fuente de verdad para ~/.claude/

Inactivos

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 — sin remoto) · video-generator (NestJS) · whatsapp-number-checker (Express) · youtube-downloader (TS — sin remoto) · websites/polar-web (último toque 2025-12)

Obsoletos

En ~/code/deprecated/: echonau, komunikadoj, nau-ig, r2-asset-manager.

nau-ig es el ancestro de nau-mobile — la aplicación fue extraída, absorbida en el monorepo y luego sacada de nuevo. No confundas los tres.

En GitHub, no clonados

Repositorios de servicio de preconsolidación, ahora dentro del monorepo nau: 9nau, flownau, nauthenticity, whatsnau, zazu. No los clones para trabajar en esos servicios — viven en nau/apps/. (Dos de ellos también están como repositorios git anidados dentro de nau/tmp/, lo cual es basura).

Otros no clonados: ai-mentor, astromatic, ecom, exercism, kinder-heldin, ludi9, project_1, samuel-aure, adventofcodeOLD, nau-storage.

Sin versionar — en riesgo

~/code/no-git/ contiene nueve directorios fuera de git: build-mobile, chrome-extensions, flownau, gmb, kkj_db_backups, omniroute, repurpose, scripts, video-bank-script.

A una falla de disco de desaparecer, y kkj_db_backups parece ser copias de seguridad de base de datos sin copia de seguridad propia. Una auditoría con una recomendación por directorio está aprobada y pendiente.

Consistencia del stack

El portafolio ha convergido en: TypeScript · React · Vite para sitios · Next para aplicaciones · NestJS para servicios · Postgres + Prisma · Docker · Remotion para video · Tailwind.

Cuando un proyecto no tenga un requisito técnico específico, elige de ese conjunto. La consistencia se acumula en maestría y hace que cada proyecto sea más barato de mantener; un nuevo framework por proyecto se acumula en mantenimiento que nadie tiene tiempo para hacer.

Divergencia conocida a resolver: seis sitios web, cuatro enfoques — karenexplora-web, samuelaure-web, violetacuesta-web y andiuniverso-web en Vite, nau-web en Astro, polar-web desconocido. Estos son el mismo tipo de producto. Antes de construir un séptimo, elige uno y di por qué; converger los seis existentes vale la pena programarlo.

El estándar de calidad

Un repositorio es digno de portafolio cuando alguien puede encontrarlo, entenderlo y ejecutarlo sin preguntarle nada a Samuel.

  • README que se gana su extensión. Qué es, por qué existe, cómo ejecutarlo y las una o dos decisiones que fueron realmente interesantes. Ni un tutorial, ni un esbozo. Si un lector no puede ponerlo en marcha solo con el README, no está terminado.
  • CI funcional donde tenga sentido. Una insignia verde es evidencia; una rota es peor que ninguna.
  • Sin secretos, nunca — y tampoco en el historial.
  • Sin artefactos de agente. CLAUDE.md, .claude/, .agent/ están globalmente en .gitignore y versionados en engineering_protocols/projects/<repo>/. Un repositorio que anuncia sus herramientas de IA se lee como generado por IA para cualquiera que lo evalúe. Dejarlos fuera mantiene la pregunta abierta, y la respuesta honesta — sí, con protocolos de ingeniería detrás — cae mejor viniendo de Samuel que de un archivo.
  • Estado honesto. Un README que reclama estado de producción para algo roto cuesta más credibilidad que un proyecto sin terminar. nau-mobile pasó meses declarándose obsoleto mientras era el repositorio activo; ese es el modo de fallo a evitar.
  • Documentación ni escasa ni excesiva. La documentación que describe lo que el código ya dice es deuda de mantenimiento; la documentación que captura la decisión no obvia, la restricción o el problema que dio guerra se paga sola. Cuando la documentación y el código no coinciden, la documentación es el error.

Manteniendo esto actualizado

Cuando se añada, elimine, renombre, cambie de stack o mueva un repositorio entre activo e inactivo, actualiza este archivo y la tabla en global/CLAUDE.md, como parte de ese trabajo. Luego sincroniza con ~/.claude/. Un registro que se desvía es peor que ningún registro, porque se confía en él.

Skills relacionados