为什么值得关注

它提供了锁定的架构决策、操作手册和配置模板，消除了昂贵的启动选择，使 AI 代理能够生成一致且可用于生产的脚手架。

适合谁使用

AI 编码代理开发者
构建全栈移动端+网页产品的创业公司创始人
采用 Firebase 构建跨平台应用的团队
希望获得经过验证的、强规范项目结构的开发者

典型使用场景

使用 Firebase 启动新的 Next.js 和 Android 产品
标准化网页和移动应用的项目配置
利用 Zod 确保 TypeScript 和 Kotlin 之间的合约一致性
自动化 Firebase 托管和 Play Store 部署的 CI/CD 设置

项目优势

预定义且文档化的架构决策记录（ADR），避免昂贵的重新发现
跨平台合约生成（Zod 到 TypeScript、Kotlin、JSON Schema），并带有 CI 漂移检测
61 个即用型配置文件，一条命令即可生成
专为代理设计的 AGENTS.md 合约，确保 AI 行为一致

使用前须知

严格绑定到 Next.js、Android 和 Firebase 技术栈，无法灵活替换
不支持现有代码库的迁移，仅适用于全新仓库的初始化
高度强规范，只提供唯一的方式，替代方案仅作为被拒绝的 ADR 存在

README 快速开始

GreenField

Ship a Next.js + Android product on Firebase without spending your first week deciding auth, quotas, billing and CI.

GreenField is an operating manual for AI coding agents: 104 notes of prescriptive standards, 22 decision records, and 61 copy-ready configuration files. You point an agent at it; the agent builds the product.

The problem

Starter kits hand you a running page and leave every expensive decision open:

How does auth work across a browser and an Android app, from one user record?
Where are model provider keys allowed to exist, and who enforces the spend limit?
What happens when a billing webhook is delivered twice?
Which side owns the schema when the web app and the Android app disagree?
What has to be true before the Play Store lets you publish at all?

You answer these under deadline pressure, once per product, usually wrong the first time. An AI agent asked to answer them will invent something plausible and different every run.

GreenField answers them once, in writing, and hands the answers to the agent as a contract.

What GreenField is

Not a demo app. Not a one-click starter that pretends to ship a finished product.

It is a manual with a materializer: locked architectural decisions, runbooks whose order matters, and templates that write your repository's configuration contract.

GreenField gives you	Your agent builds next
Standards, ADRs, and runbooks	Domain schemas and product UI
Materialized config and CI contracts	Web routes, Android modules, tests
Security rules, Auth/App Check posture	Capability phases (billing, AI, voice)
An `AGENTS.md` the agent must obey	The product itself

What actually lands in your repository

Materialization writes 61 files. No application source — configuration, contracts, and the agent's instructions:

my-product/
├── AGENTS.md                     the contract your agent must obey
├── package.json                  pnpm workspace + Turborepo pipeline
├── packages/contracts/           Zod + JSON Schema — cross-platform source of truth
├── apps/web/                     Next.js: middleware, Vitest, Playwright, App Hosting
│   ├── apphosting.yaml           production back

项目描述

Ship a Next.js + Android product on Firebase without spending your first week deciding auth, quotas, billing and CI.

greenfield