Loadedvibes

🚀 Loaded Vibes框架

Loaded Vibes是一個企業級的Agentic TypeScript Web開發框架，此工作空間用於框架的開發、測試和維護，為最終用戶提供高質量的框架產品。

🚀 快速開始

前提條件

• Node.js ≥ 20
• pnpm（包管理器）
• 安裝了GenAIScript擴展的VS Code
• 啟用了Agent Mode的GitHub Copilot

環境搭建

# 克隆倉庫
git clone https://github.com/DigitalHerencia/LoadedVibes.git
cd LoadedVibes

# 安裝依賴
pnpm install

# 本地運行營銷網站
pnpm dev

# 驗證框架清單
pnpm run build

關鍵命令

✨ 主要特性

• 框架核心：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擴展

📦 安裝指南

克隆倉庫

git clone https://github.com/DigitalHerencia/LoadedVibes.git
cd LoadedVibes

安裝依賴

pnpm install

📚 詳細文檔

🌎 關於此工作空間

這是Loaded Vibes的框架開發環境，Loaded Vibes是一個企業級的Agentic TypeScript Web開發框架。在將框架交付給最終用戶之前，使用此工作空間來編寫、測試和維護框架本身。

⚠️ 僅維護人員可見：本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擴展

📁 目錄結構

開發文件夾

├── .github/          # Copilot指令與治理（僅開發環境）
├── .vscode/          # 編輯器設置與擴展（僅開發環境）
├── docs/             # 產品需求文檔、技術要求、架構指南
├── spec/             # SPEC-ARCH、SPEC-CLI、SPEC-ENGINE等
├── templates/        # 用於生成交付工件的資產模板
├── decisions/        # 架構決策記錄（ADRs）
└── 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
• 參考：TECH_REQUIREMENTS §7，SPEC-ARTIFACTS §3

設置防護

確保VS Code設置僅引用開發層資產（從不引用dist/**）。

• 觸發條件：推送到或拉取請求到.vscode/settings.json
• 參考：PRD §4.3，SPEC-ARCH §3

🤝 貢獻指南

請參閱獲取指南。所有貢獻必須：

1. 遵循規範驅動的工作流程
2. 包含需求引用（PRD/TECH條款）
3. 更新TODO.md和CHANGELOG.md
4. 通過CI驗證

📚 資源

"Bad Vibes, Clean Code, Solid Infra, Sharded Loads."