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."