Loadedvibes

🚀 Loaded Vibes Framework

Loaded Vibesは、エンタープライズグレードのAgentic TypeScript Web開発フレームワークで、クリーンなコード、堅牢なインフラ、分散負荷を実現します。

🚀 クイックスタート

これはLoaded Vibesのフレームワーク開発環境です。エンタープライズグレードのAgentic TypeScript Web開発フレームワークであるLoaded Vibesを開発、テスト、メンテナンスするためのワークスペースです。エンドユーザーに提供する前に、このワークスペースを使用してフレームワーク自体を作成、テスト、メンテナンスします。

⚠️ 重要提示

このREADMEはフレームワークの作成に関するものです。エンドユーザー向けのドキュメントは、を参照してください。

✨ 主な機能

• フレームワークコア：GenAIScriptオーケストレーター、DevCycleエンジン、CLIツール
• フロントエンド：Next.js 15 (App Router, RSC)、React 19、Tailwind CSS 4、shadcn/ui
• データ：PostgreSQL (Neon)、Prisma ORM、Redisキャッシュレイヤー
• 認証とセキュリティ：Clerk、JWT、ABAC/RBAC、Bad Vibesファイアウォール
• ツール：Vitest、Playwright、ESLint、Prettier、GitHub Actions CI/CD
• AI統合：GitHub Copilot Agent Mode、MCPサーバー、GenAIScript拡張機能

📦 インストール

前提条件

• Node.js ≥ 20
• pnpm (パッケージマネージャー)
• GenAIScript拡張機能付きのVS Code
• GitHub Copilot (Agent Mode有効)

セットアップ

# リポジトリをクローン
git clone https://github.com/DigitalHerencia/LoadedVibes.git
cd LoadedVibes

# 依存関係をインストール
pnpm install

# マーケティングサイトをローカルで実行
pnpm dev

# フレームワークマニフェストを検証
pnpm run build

主要コマンド

📚 ドキュメント

📁 ディレクトリ構造

開発フォルダ

├── .github/          # Copilotの指示とガバナンス (開発専用)
├── .vscode/          # エディタ設定と拡張機能 (開発専用)
├── docs/             # PRD、技術要件、アーキテクチャガイド
├── spec/             # SPEC-ARCH、SPEC-CLI、SPEC-ENGINEなど
├── templates/        # 配布アーティファクトを生成するためのアセットテンプレート
├── decisions/        # アーキテクチャ決定レコード (ADR)
└── app/              # マーケティングサイト (loadedvibes.vercel.app)

配布アーティファクト (dist/)

dist/
├── .github/          # エンドユーザー用のエージェント、プロンプト、指示、ツールセット
├── .vscode/          # エンドユーザーのVS Code設定とMCP構成
├── genaiscript/      # オーケストレーターエンジンとDevCycleマニフェスト
├── cli/              # CLIコマンド (init、doctor、dashboard、devcycle)
├── docs/             # エンドユーザー向けのドキュメント
└── src/              # 生成されたユーザープロジェクト出力

🧭 仕様駆動型ワークフロー

すべてのフレームワーク開発は、分析 → 設計 → 実装 → 検証 → 反省 → 引き渡しのループに従います。

🔧 DevCycleガバナンス

Loaded Vibesは、18の標準DevCycleを通じて開発をオーケストレートします。

マニフェスト: dist/genaiscript/devcycles.config.json

🔒 セキュリティと品質ゲート

• Bad Vibesファイアウォール：破壊的な操作には、ログ付きの署名付きの人間の承認が必要です。
• SHA256検証：すべてのリリースは暗号的に署名されています。
• シークレット削除：テレメトリエクスポートは機密データをサニタイズします。
• ABAC/RBAC：全体でロールベースのアクセス制御が行われます。

🤖 CIワークフロー

マニフェスト検証

すべてのDevCycleエントリが有効な指示/ツールセット/プロンプトファイルに解決されることを検証します。

• トリガー：dist/genaiscript/devcycles.config.jsonへのPush/PR
• 参照：TECH_REQUIREMENTS §7、SPEC-ARTIFACTS §3

設定ガード

VS Codeの設定が開発レイヤーのアセットのみを参照することを保証します (dist/**を参照しない)。

• トリガー：.vscode/settings.jsonへのPush/PR
• 参照：PRD §4.3、SPEC-ARCH §3

🤝 コントリビューション

ガイドラインについては、を参照してください。すべてのコントリビューションは以下の条件を満たす必要があります。

1. 仕様駆動型ワークフローに従う
2. 要件引用 (PRD/TECH条項) を含む
3. TODO.mdとCHANGELOG.mdを更新する
4. CI検証に合格する

📚 リソース