Architecture

                    ┌─────────────┐
                    │   PLANNER   │
                    │  (Opus 4.6) │
                    └──────┬──────┘
                           │ Product Spec
                           │ (features, sprints, design direction)
                           ▼
              ┌────────────────────────┐
              │                        │
              │   GENERATOR-EVALUATOR  │
              │      FEEDBACK LOOP     │
              │                        │
              │  ┌──────────┐          │
              │  │GENERATOR │--build-->│──┐
              │  │(Opus 4.6)│          │  │
              │  └────▲─────┘          │  │
              │       │                │  │ live app
              │    feedback             │  │
              │       │                │  │
              │  ┌────┴─────┐          │  │
              │  │EVALUATOR │<-test----│──┘
              │  │(Opus 4.6)│          │
              │  │+Playwright│         │
              │  └──────────┘          │
              │                        │
              │   5-15 iterations      │
              └────────────────────────┘

The Three Agents

1. Planner Agent

Role: Product manager — expands a brief prompt into a full product specification.

Key behaviors:

• Takes a one-line prompt and produces a 16-feature, multi-sprint specification
• Defines user stories, technical requirements, and visual design direction
• Is deliberately ambitious — conservative planning leads to underwhelming results
• Produces evaluation criteria that the Evaluator will use later

Model: Opus 4.6 (needs deep reasoning for spec expansion)

2. Generator Agent

Role: Developer — implements features according to the spec.

Key behaviors:

• Works in structured sprints (or continuous mode with newer models)
• Negotiates a "sprint contract" with the Evaluator before writing code
• Uses full-stack tooling: React, FastAPI/Express, databases, CSS
• Manages git for version control between iterations
• Reads Evaluator feedback and incorporates it in next iteration

Model: Opus 4.6 (needs strong coding capability)

3. Evaluator Agent

Role: QA engineer — tests the live running application, not just code.

Key behaviors:

• Uses Playwright MCP to interact with the live application
• Clicks through features, fills forms, tests API endpoints
• Scores against four criteria (configurable):
  1. Design Quality — Does it feel like a coherent whole?
  2. Originality — Custom decisions vs. template/AI patterns?

…

bun-runtime

帮助开发者使用 Bun 进行运行、打包、测试与依赖管理，并评估替代 Node 的时机。

harness-fe

连接浏览器与服务端运行时，支持实时调试、监控并自动修复问题。