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 (使用 isolated stacks 和 smoke tests)
  6. E2E Testing (瀏覽器控制遍歷)
  7. UAT Sign-off (使用者驗證的測試案例)

它透過三種機制強制執行品質：強制技能、硬性阻斷的安全鉤子 (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 $
    ightarrow$ refactor」週期；跳過測試將成為審查被拒絕的理由。
  • Security Guardrails: 四層安全鉤子以阻斷危險指令（例如，rm -rf）並掃描洩漏的 secrets。
  • Cross-Platform Support: 為 Web、微信小程式和 Apple 原生應用程式提供專用軌道，並為每個平台提供專業角色。
  • Real-time Monitoring: 一個零依賴的 HTML board，每 3 秒更新一次，以視覺化團隊的進度。
  • Design Discipline: 一個防止「AI 風格」美學的層級，透過禁止特定的 UI patterns（例如，通用的紫色漸層）並強制執行設計讀取。
  • Multi-LLM Compatibility: 支援多種模型，包括 DeepSeek、Doubao、Qwen 和 MiniMax。