Communitygithub.com

samuelaure/engineering-protocols

Das vollständige Repository-Register, Tech-Stack-Konsistenz, die Qualitätslatte für portfolio-würdige Projekte und die Veröffentlichung eines Projekts auf der persönlichen Website. Vor dem Start eines neuen Projekts, der Wahl eines Stacks, der Entscheidung, ob etwas bereits existiert, oder der öffentlichen Präsentation von Arbeit laden.

Was ist engineering-protocols?

Dieses Skill definiert die technischen und organisatorischen Protokolle für Samuel Aures Entwicklungsportfolio. Es dient als zentrales Register aller ~40 GitHub-Repositories, ~25 lokalen Klone und unversionierter Arbeiten und verhindert Duplikation und technische Divergenz zwischen Projekten. Das Skill beschreibt die aktiven, ruhenden und veralteten Projekte der letzten 90 Tage, definiert den konsolidierten Tech-Stack (TypeScript, React, Vite, Next.js, NestJS, Postgres, Docker, Remotion) und setzt eine klare Qualitätslatte für portfolio-würdigen Code: aussagekräftige READMEs, funktionierende CI, keine Secrets, keine Agenten-Artefakte und ehrliche Zustandsangaben. Es ist für die Nutzung mit Claude Code, Cursor oder anderen KI-Agenten konzipiert, die auf `~/.claude/` und die Protokolldateien zugreifen, und muss vor jedem neuen Projekt oder Architekturentscheidungen geladen werden. Das Skill enthält außerdem einen offenen Hinweis, dass das Präsentationssystem für die Portfolio-Seite noch nicht definiert ist; die Qualitätsanforderungen können bereits durchgesetzt werden, die Veröffentlichungslogik muss jedoch später gemeinsam entworfen werden.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Portfolio

40 Repositories auf GitHub, 25 geklont unter ~/code, plus unversionierte Arbeit. Samuel arbeitet allein über sehr unterschiedliche Domänen hinweg, daher sind die zwei Fehlermodi Duplikation (etwas bauen, das bereits woanders im Portfolio existiert) und Divergenz (ein neues Framework für die gleiche Art von Produkt). Lese dies vor beidem.

⚠️ Offene Frage — Präsentation ist noch nicht definiert

Samuel hat noch nicht entschieden, wie Projekte präsentiert werden im Portfolio-Bereich von samuelaure-web, noch wie sie auf nau-web erscheinen sollen, noch ob die Agentur eine eigene Variante benötigt.

Bis dies entschieden ist, kann dieses Skill die Qualitäts-Hälfte (Repo-Standards, Dokumentation) durchsetzen, jedoch nicht die Veröffentlichungs-Hälfte. Wenn Arbeiten den Portfolio-Bereich von samuelaure-web berühren oder ein Projekt einen vorzeigbaren Zustand erreicht, dann die Frage stellen – das ist der Moment, es zu entwerfen, und es sollte einmal entworfen und konsistent angewendet werden, anstatt pro Projekt improvisiert zu werden.

Aktiv (letzte 90 Tage)

RepoStackWas es ist
naupnpm monorepo · NestJS · Next 14 · Postgres · BullMQ · Remotionnaŭ-Plattform. 2055 Commits. Das Hauptsystem
nau-mobileExpo SDK 50 · React Native · SQLiteInstagram-Capture-App. Eigenständiges Repo, local-first
groovyGrails → NestJS · DockerAPI-Migrationslabor – Strangler-Pattern über einer Legacy-Grails-API
websites/nau-webAstro · Expressnaŭ-Marketing-Website
websites/karenexplora-webVite · ExpressKunden-Website
websites/violetacuesta-webVite · TS · DockerKunden-Website, deployed auf dem VPS
websites/samuelaure-webVite · TSPersönliche Website – beherbergt den Portfolio-Bereich
websites/andiuniverso-webVite · TSKunden-Website
karenexplora-freescoutDockerSelbst gehostetes Helpdesk-Deployment
countdown-videoReact · RemotionProgrammgesteuerte Videoerstellung
nispirasKotlin · Android nativeAtem-Overlay-App. Liefert einen eigenen Keystore – nicht neu generieren
engineering_protocolsMarkdownDiese Protokolle. Source of Truth für ~/.claude/

Ruhend

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 — kein Remote) · video-generator (NestJS) · whatsapp-number-checker (Express) · youtube-downloader (TS — kein Remote) · websites/polar-web (zuletzt bearbeitet 2025-12)

Veraltet

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

nau-ig ist der Vorfahre von nau-mobile – die App wurde extrahiert, ins Monorepo aufgenommen und dann wieder herausgezogen. Nicht verwechseln.

Auf GitHub, nicht geklont

Service-Repos vor der Konsolidierung, jetzt im nau-Monorepo: 9nau, flownau, nauthenticity, whatsnau, zazu. Diese nicht klonen, um an diesen Services zu arbeiten – sie leben in nau/apps/. (Zwei von ihnen liegen auch als verschachtelte Git-Repos innerhalb von nau/tmp/, was Altlast ist.)

Andere nicht geklont: ai-mentor, astromatic, ecom, exercism, kinder-heldin, ludi9, project_1, samuel-aure, adventofcodeOLD, nau-storage.

Unversioniert – gefährdet

~/code/no-git/ enthält neun Verzeichnisse außerhalb von Git: build-mobile, chrome-extensions, flownau, gmb, kkj_db_backups, omniroute, repurpose, scripts, video-bank-script.

Ein Festplattenausfall und weg, und kkj_db_backups scheinen Datenbank-Backups ohne eigenes Backup zu sein. Ein Audit mit einer Empfehlung pro Verzeichnis ist genehmigt und steht aus.

Stack-Konsistenz

Das Portfolio hat sich auf Folgendes geeinigt: TypeScript · React · Vite für Websites · Next für Apps · NestJS für Services · Postgres + Prisma · Docker · Remotion für Video · Tailwind.

Wenn ein Projekt keine spezifischen technischen Anforderungen hat, wähle aus diesem Set. Konsistenz summiert sich zu Meisterschaft und macht jedes Projekt günstiger zu warten; ein neues Framework pro Projekt summiert sich zu Wartungsaufwand, für den niemand Zeit hat.

Bekannte zu lösende Divergenz: sechs Websites, vier Ansätze – karenexplora-web, samuelaure-web, violetacuesta-web und andiuniverso-web auf Vite, nau-web auf Astro, polar-web unbekannt. Dies sind die gleiche Art von Produkt. Vor dem Bau einer siebten eine auswählen und begründen; die Konvergenz der bestehenden sechs ist es wert, eingeplant zu werden.

Die Qualitätslatte

Ein Repository ist portfolio-würdig, wenn jemand es finden, verstehen und ausführen kann, ohne Samuel etwas zu fragen.

  • Eine README, die ihre Länge verdient. Was es ist, warum es existiert, wie man es ausführt, und die eine oder zwei Entscheidungen, die tatsächlich interessant waren. Kein Tutorial, kein Stub. Wenn ein Leser es nicht allein aus der README zum Laufen bringen kann, ist es nicht fertig.
  • Funktionierende CI, wo sinnvoll. Ein grünes Badge ist ein Beweis; ein kaputtes ist schlimmer als keines.
  • Keine Secrets, niemals – und auch keine in der Historie.
  • Keine Agenten-Artefakte. CLAUDE.md, .claude/, .agent/ sind global ignoriert und versioniert in engineering_protocols/projects/<repo>/. Ein Repo, das seine KI-Werkzeuge bewirbt, wirkt für jeden, der es evaluiert, wie KI-generiert. Es wegzulassen hält die Frage offen, und die ehrliche Antwort – ja, mit Engineering-Protokollen dahinter – kommt besser von Samuel als aus einer Datei.
  • Ehrlicher Zustand. Eine README, die Produktionsstatus für etwas Kaputtes behauptet, kostet mehr Glaubwürdigkeit als ein unfertiges Projekt. nau-mobile erklärte sich monatelang für veraltet, während es das aktive Repo war; das ist der zu vermeidende Fehlermodus.
  • Dokumentation weder spärlich noch übermäßig. Docs, die beschreiben, was der Code bereits sagt, sind Wartungsschulden; Docs, die die nicht offensichtliche Entscheidung, die Einschränkung oder den Stolperstein festhalten, zahlen sich aus. Wenn Docs und Code widersprechen, sind die Docs der Fehler.

Dies aktuell halten

Wenn ein Repository hinzugefügt, entfernt, umbenannt wird, den Stack wechselt oder zwischen aktiv und ruhend wechselt, diese Datei und die Tabelle in global/CLAUDE.md als Teil dieser Arbeit aktualisieren. Dann mit ~/.claude/ synchronisieren. Ein Register, das abweicht, ist schlimmer als keines, weil ihm vertraut wird.

Verwandte Skills