Communitygithub.com

samuelaure/engineering-protocols

完全なリポジトリレジストリ、テクノロジースタックの一貫性、ポートフォリオにふさわしい品質基準、そしてプロジェクトを個人サイトに公開する方法。新しいプロジェクトを開始する前や、スタックを選択する前、既存のものがないか判断する前、または作品を公開する前に読み込んでください。

engineering-protocols とは?

このスキルは、Samuel Laureのエンジニアリングポートフォリオ全体を管理するための中心的な知識ベースです。40を超えるGitHubリポジトリ、`~/code`にクローンされた25以上のプロジェクト、およびバージョン管理されていない作業を網羅し、重複の防止、スタックの一貫性の確保、そしてポートフォリオにふさわしい品質基準の維持を支援します。Claude CodeやCursorなどのAIエージェントと連携し、新しいプロジェクトの開始前や既存のリソースの評価時にこのスキルを読み込むことで、エージェントが一貫性のある技術選定と高品質な出力を実現できるようになります。スキルマークダウンには、アクティブ、休止中、非推奨、未クローン、バージョン管理外のリポジトリ一覧、推奨スタック、READMEやCI、機密情報管理、エージェント成果物の扱いに関する詳細な品質基準が含まれています。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ポートフォリオ

GitHubに40のリポジトリ、~/code以下に25のクローン、さらにバージョン管理外の作業があります。Samuelは一人で非常に異なるドメインを横断して作業しているため、2つの障害モードは重複(ポートフォリオの別の場所に既に存在するものを構築すること)と乖離(同じ種類の製品に対して新しいフレームワークを使うこと)です。どちらかの作業を始める前にこれを読んでください。

⚠️ 未解決の課題 — プレゼンテーションはまだ定義されていません

Samuelは、samuelaure-webのポートフォリオセクションでプロジェクトをどのように表示するか、nau-webでどのように表示するか、そしてエージェンシーが独自のバリアントを必要とするかどうかをまだ決定していません。

それが決定されるまで、このスキルは品質の部分(リポジトリ標準、ドキュメント)は強制できますが、公開の部分はできません。作業がsamuelaure-webのポートフォリオセクションに影響する場合、またはプロジェクトが表示に値する状態に達した場合、その時点で問題を提起してください。その瞬間に設計する必要があり、プロジェクトごとに即興で行うのではなく、一度設計して一貫して適用する必要があります。

アクティブ(過去90日間)

リポジトリスタック説明
naupnpm monorepo · NestJS · Next 14 · Postgres · BullMQ · Remotionnaŭプラットフォーム。2055コミット。メインシステム
nau-mobileExpo SDK 50 · React Native · SQLiteInstagramキャプチャアプリ。独立リポジトリ、ローカルファースト
groovyGrails → NestJS · DockerAPI移行ラボ — レガシーGrails API上のストラングラーパターン
websites/nau-webAstro · Expressnaŭマーケティングサイト
websites/karenexplora-webVite · Expressクライアントサイト
websites/violetacuesta-webVite · TS · Dockerクライアントサイト、VPSにデプロイ済み
websites/samuelaure-webVite · TS個人サイト — ポートフォリオセクションをホスト
websites/andiuniverso-webVite · TSクライアントサイト
karenexplora-freescoutDockerセルフホスト型ヘルプデスクデプロイメント
countdown-videoReact · Remotionプログラムによる動画生成
nispirasKotlin · Android native呼吸オーバーレイアプリ。独自のキーストアを同梱 — 再生成しないでください
engineering_protocolsMarkdownこれらのプロトコル。~/.claude/の信頼できる情報源

休止中

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 — リモートなし) · video-generator (NestJS) · whatsapp-number-checker (Express) · youtube-downloader (TS — リモートなし) · websites/polar-web (最終更新 2025-12)

非推奨

~/code/deprecated/内: echonau, komunikadoj, nau-ig, r2-asset-manager。

nau-igはnau-mobileの先祖です — アプリは抽出され、モノレポに吸収され、その後再び引き出されました。この3つを混同しないでください。

GitHub上、未クローン

統合前のサービスリポジトリで、現在はnauモノレポ内にあります: 9nau, flownau, nauthenticity, whatsnau, zazu。これらのサービスを扱うためにクローンしないでください — それらはnau/apps/にあります。(そのうち2つはnau/tmp/内のネストされたgitリポジトリとしても存在しており、これはガラクタです。)

その他未クローン: ai-mentor, astromatic, ecom, exercism, kinder-heldin, ludi9, project_1, samuel-aure, adventofcodeOLD, nau-storage。

バージョン管理外 — リスクあり

~/code/no-git/にはgit管理外の9つのディレクトリがあります: build-mobile, chrome-extensions, flownau, gmb, kkj_db_backups, omniroute, repurpose, scripts, video-bank-script。

ディスク障害が1回発生すれば消滅し、kkj_db_backupsはそれ自体のバックアップがないデータベースバックアップと思われます。ディレクトリごとの推奨事項を含む監査が承認され、保留中です。

スタックの一貫性

ポートフォリオは以下に収束しています: TypeScript · React · Vite(サイト向け) · Next(アプリ向け) · NestJS(サービス向け) · Postgres + Prisma · Docker · Remotion(動画向け) · Tailwind。

プロジェクトに特定の技術要件がない場合、そのセットから選択してください。一貫性は習熟へと積み重なり、すべてのプロジェクトの保守コストを下げます。プロジェクトごとに新しいフレームワークを使うと、誰も対応する時間がないメンテナンスが積み重なります。

解決すべき既知の乖離: 6つのウェブサイト、4つのアプローチ — karenexplora-web, samuelaure-web, violetacuesta-web および andiuniverso-web(Vite)、nau-web(Astro)、 polar-web(不明)。これらは同じ種類の製品です。7つ目を構築する前に、1つを選んでその理由を説明してください。既存の6つを収束させることはスケジュールを組む価値があります。

品質基準

リポジトリがポートフォリオにふさわしい状態とは、誰でもそれを見つけ、理解し、Samuelに何も尋ねずに実行できる場合です。

  • 長さに見合う価値のあるREADME。 それが何か、なぜ存在するか、実行方法、そして実際に興味深い1つか2つの決断。チュートリアルでも、スタブでもありません。読者がREADMEだけでそれを実行できないなら、完成していません。
  • 適切な場所に機能するCI。 グリーンバッジは証拠です。壊れたものはないより悪いです。
  • 機密情報は絶対に厳禁 — 履歴にもありません。
  • エージェントの成果物は禁止。 CLAUDE.md, .claude/, .agent/はグローバルにgitignoringされ、engineering_protocols/projects/<repo>/にバージョン管理されています。AIツールを宣伝するリポジトリは、評価する誰にとってもAI作成と読まれます。それを除外することで問題は未解決のままになり、正直な答え — そうです、背後にエンジニアリングプロトコルがあります — は、ファイルからよりもSamuelから出た方がより効果的です。
  • 正直な状態。 壊れているものに本番環境ステータスを主張するREADMEは、未完成のプロジェクトよりも信頼性を損なうコストがかかります。nau-mobileはアクティブなリポジトリである間、何ヶ月も自分を非推奨と宣言していました。それが避けるべき障害モードです。
  • ドキュメントは疎でも過剰でもない。 コードが既に述べていることを説明するドキュメントは保守の負債です。明白でない決断、制約、または落とし穴を捉えたドキュメントは、それ自体で価値を生みます。ドキュメントとコードが矛盾する場合、ドキュメントがバグです。

これを最新に保つ

リポジトリが追加、削除、名前変更されたり、スタックが変更されたり、アクティブと休止中の間で移動した場合、その作業の一環としてこのファイルおよびglobal/CLAUDE.mdのテーブルを更新してください。その後、~/.claude/に同期してください。乖離したレジストリはレジストリがないよりも悪いです。なぜなら、それが信頼されるからです。

関連スキル