pcliangx/AppGenesisForge

AI Agent Team scaffold for Claude Code — 19 roles collaborate through stage gates, enforced by mandatory skills + blocking hooks + DoD checklists. Spec-driven change folders, SIT-audited code reviews, 4-layer hook defense, multi-LLM (DeepSeek/Doubao/Qwen/MiniMax). Tracks: Web · WeChat Mini Program · Apple native (macOS/iOS). 中文/EN README.

What it solves

AppGenesisForge (AGF) 解决了单个 AI agent 在漫长且复杂的开发周期中失去控制的问题。AGF 并不依赖于单个“更聪明”的模型，而是为软件开发实现了一种结构化的、精益的流水线方法，确保缺陷不会流向流程的后续阶段。

How it works

AGF 作为基于 Claude Code Agent Teams 的 AI agent 团队脚手架。它将 19 个专门的 AI 角色（例如 Product Lead, Frontend/Backend Dev, Reviewer, 和 QA）组织进一个严格的 7 阶段流水线：

  1. Requirement Clarification (通过 change folders/OpenSpec)
  2. Task Assignment (AC extraction 和 worktree isolation)
  3. TDD Implementation (先进行 Unit 和 SIT tests)
  4. Code Review (带有 SIT evidence auditing)
  5. UAT Deployment (隔离的 stacks 和 smoke tests)
  6. E2E Testing (浏览器控制遍历)
  7. UAT Sign-off (用户验证的 test cases)

它通过三种机制强制执行质量：强制技能、硬性阻断的安全钩子 (security hooks) 以及完成定义 (Definition of Done, DoD) 清单。它还包含一个实时的 HTML dashboard 来跟踪这些阶段的任务进度。

Who it’s for

构建 Web 全栈应用（默认使用 React + FastAPI + Postgres）、AI Agents/RAG 系统、微信小程序或原生 Apple 应用（使用 Swift 6 和 SwiftUI 的 macOS/iOS）的开发者。

Highlights

  • Multi-Role Orchestration: 19 个不同的 AI 角色，职责锁定以防止利益冲突（例如，Reviewers 不能修改源代码）。
  • TDD Enforcement: 强制执行 "red $\rightarrow$ green $\rightarrow$ refactor" 循环；跳过测试是拒绝评审的理由。
  • Security Guardrails: 四层安全钩子 (security hooks) 以阻断危险命令（例如， rm -rf）并扫描泄露的 secrets。
  • Cross-Platform Support: 为 Web、微信小程序和 Apple 原生应用提供专用轨道，并为每个轨道配备专门的角色。
  • Real-time Monitoring: 一个零依赖的 HTML board，每 3 秒更新一次，以可视化团队的进度。
  • Design Discipline: 通过禁止特定的 UI 模式（例如，通用的紫色渐变）并强制执行设计读取，来防止出现“AI 风格”的美学。
  • Multi-LLM Compatibility: 支持多种模型，包括 DeepSeek, Doubao, Qwen, 和 MiniMax。