@wneng/create-keel 0.1.0

package/src/templates/docs-skeleton/files/usage-quickstart.md

@@ -0,0 +1,168 @@
+# 仓库使用清单（Quickstart）
+
+> 本文件是新人 / AI 进入本仓库的**单点入口**。读完这一份就能开始日常工作。
+> 完整规则在各权威文件，本文件只列高频场景与命令。
+
+## 0. 分级采用：先选档位再读后面
+
+本仓库的目录、access mode、roles、governance 共 11 份政策，是**按完整 To B 交付场景**设计的；不是每个项目都需要全部背上。先按下表挑一档，再读对应章节。
+
+| 档位 | 适用 | 启用范围 | 不启用 |
+|------|------|---------|--------|
+| **轻量档**（lite）| 1–5 人原型 / 内部工具 / 开源库 | `docs/01–05` + `contracts/`（治理契约即可，业务契约可缓）+ `governance/` 三件套（ci / security / git-workflow）+ `01–02` 编号目录 | `docs/06–11` + `design/` + `roles` + 完整 11 份 governance + 双闸门 |
+| **标准档**（standard）| 5–15 人产品研发 / SaaS | 轻量档 + `docs/06-集成对接/` + `docs/07-质量与测试/`（qa role）+ `governance/` 全套 + 业务契约 | `08-` `10-` `11-` `design` + 双闸门 |
+| **完整档**（full）| To B 项目交付 / 多客户私有部署 | 全部目录 + 全部 6 个 roles + 完整 access modes + 双闸门 + on-demand trigger keywords | —— |
+
+### 0.1 怎么选 / 怎么切换
+
+**新项目**：在 `npx @wneng/create-keel create` 的交互里按档位选：
+
+```bash
+# 轻量档：后端 + 前端 + 治理三件套，禁用 integrations / roles
+npx @wneng/create-keel create my-lite \
+  --backend node --frontend react --contract rest \
+  --ai kiro --license mit --ci github --yes
+
+# 标准档：加 integrations + qa role
+npx @wneng/create-keel create my-std \
+  --backend node --frontend react --contract rest+events \
+  --integrations --roles qa \
+  --ai kiro --license mit --ci github --yes
+
+# 完整档：所有 roles + LFS + Helm
+npx @wneng/create-keel create my-full \
+  --backend java --frontend react --mobile flutter --miniapp wechat \
+  --agent rust-desktop --deploy kubernetes --contract rest+events \
+  --ai kiro --license apache-2.0 --gitLfs --integrations \
+  --ci github --roles qa,field,data,legal-security,marketing,design \
+  --yes
+```
+
+**已有项目升档**：
+
+| 升档动作 | 操作 |
+|---------|------|
+| 轻量 → 标准（加 qa）| `mkdir docs/07-质量与测试`，从同版本 scaffolder 模板 copy `README.md` + `_ai-policy.yaml` + 三个 `.gitkeep` 子目录；提 PR |
+| 轻量 → 标准（加 integrations）| `mkdir docs/06-集成对接`，参考 `docs/governance/integrations.md` 建第一个 pair |
+| 标准 → 完整（加 field / marketing / legal-security）| 同上，但**必须**带双闸门子目录（templates/ + drafts/ + published/ 等），每层 `_ai-policy.yaml` 不能少；用 scaffolder 重新生成对应 role 的 fragment 比手工抄更安全 |
+
+**不建议降档**：删 role 目录前要确认其下没有正在用的资料；删 integrations 目录会让现有 pair 失去 lint 守护。
+
+> 后续 §A–§E 同时覆盖三档。轻量档可跳过明确标记 "（仅完整档）" 的小节。
+
+## A. 入职 5 分钟必读
+
+按顺序读 4 份：
+
+1. [`AGENTS.md`](../../AGENTS.md) —— 不可协商原则、按需加载索引、权威映射
+2. [`docs/README.md`](../README.md) —— 目录地图、子目录强弱、特性 slug
+3. [`contracts/README.md`](../../contracts/README.md) —— 契约范围、SemVer、CHANGELOG 义务（如启用 contracts）
+4. 与你角色相关的 `docs/governance/*.md` 一份（开发看 ci/security/git-workflow，QA 看 checklists 等）
+
+跳过：`docs/governance/README.md`（只是索引）、过程文档草稿（评审需要时再读）。
+
+## B. 日常场景对照表
+
+### B.1 PM —— 写新特性 PRD
+
+1. 选好 slug（kebab-case，例 `user-signup`），不改名
+2. 在 `docs/01-背景与需求/prd-user-signup.md` 写 PRD
+3. 提 PR，模板里勾"非 on-demand 目录"
+4. CI 跑 governance-lint：发 warning（缺设计 / ADR 对应文件）但不阻断 → 合入
+5. 后续后端 / 前端写设计时 warning 自动消失
+
+### B.2 架构 —— 起 ADR
+
+1. 草案写到 `docs/过程文档/drafts/<topic>-plan.md`
+2. 评审通过后归档 `docs/02-系统方案与架构/adr-<NNNN>-<slug>.md`
+3. 草案文件顶部加 `> 已采纳（YYYY-MM-DD）→ 见 ADR-XXXX`
+4. 若涉及 governance 改动，同 PR 改 governance/X.md + AGENTS.md 摘要
+
+### B.3 后端 —— 实现一个特性
+
+1. 检查 / 补 `contracts/openapi/api.yaml` 的对应路径
+2. 同 PR 更新 `contracts/CHANGELOG.md`
+3. 写 `docs/04-后端详细设计/<slug>.md`，引用契约锚点
+4. 写代码；commit message 引用契约锚点 + 设计文档
+5. 若 AI 生成：commit `feat(ai): ...` + PR 标签 `ai-generated`
+
+### B.4 前端 / 客户端 —— 实现一个特性
+
+1. 同 B.3，但落到 `docs/05-前端客户端详细设计/<slug>-<platform>.md`
+2. 设计稿在 `docs/design/`（启用 design 角色时）
+3. 不要触 read-only 区
+
+### B.5 QA —— 加测试计划（仅标准档 / 完整档）
+
+1. `docs/07-质量与测试/test-plans/<slug>.md` 写计划（启用 qa 角色时）
+2. 业务级用例：Gherkin 进 `contracts/tests/acceptance/`（可执行真值）
+3. 模块级用例：`docs/07-质量与测试/test-cases/<slug>.md`
+
+### B.6 现场 / 运维 —— 客户上线手册（仅完整档）
+
+1. 母版改动：直接动 `docs/08-部署与现场实施/templates/`（人工 read-only 例外）
+2. 新客户：手动 `mkdir docs/08-部署与现场实施/customer-acme/{,.pending/}`
+3. 用户对 AI 说**"更新部署手册"**触发后，AI 在 `.pending/` 生成草稿
+4. 实施工程师审核 → `git mv .pending/x.md ../x.md`
+
+### B.7 数据 —— 加埋点（仅完整档）
+
+1. `docs/09-数据与埋点/tracking-spec/<slug>.md` 写叙事 + 业务上下文
+2. 机器可消费部分升级到 `contracts/events/event-catalog.yaml`
+3. 不要在两处都给 schema 真值
+
+### B.8 法务 —— 加合规证据（仅完整档）
+
+1. 在编评估稿：`docs/10-合规与安全/assessments/<topic>.md`
+2. 提交后 → 人工 `git mv` 到 `docs/10-合规与安全/evidence/<topic>-<date>.md`（read-only）
+3. 触发关键词：**"更新合规证据"**
+
+### B.9 市场 —— 更新对外材料（仅完整档）
+
+1. 用户对 AI 说**"更新宣发"**或**"刷新市场材料"**
+2. AI 在 `docs/11-市场与对外材料/drafts/` 生成草稿
+3. 市场负责人审核后 `git mv drafts/x.pptx published/x.pptx`
+4. `published/` 永远 read-only
+
+### B.10 设计 —— 更新 UI（仅完整档）
+
+1. 设计稿主线在 Figma；本仓库存导出资产
+2. 触发关键词：**"更新设计稿"**
+3. `.fig` / `.sketch` 走 LFS（见 `docs/governance/assets.md`）
+
+### B.11 多应用切换（首次）
+
+```bash
+mkdir server/apps/auth
+git mv server/<all-files-except-meta> server/apps/auth/
+mkdir server/apps/billing
+# 同 PR 更新 CODEOWNERS；CI lint 强制 <env>/ 顶层不能有裸文件
+```
+
+## C. 关键命令
+
+| 任务 | 命令 |
+|------|------|
+| 治理 lint（本地） | `node tools/governance-lint/index.js`（如已加入仓库）|
+| 单元测试 / 构建 | 见各模块 `package.json` / 工具栈说明 |
+
+## D. 提 PR 前 60 秒自检
+
+读 PR 模板的 checkbox。最常踩的 5 个坑：
+
+1. ❌ 改 `contracts/` 没改 `contracts/CHANGELOG.md`
+2. ❌ 触 on-demand 目录但没说出 trigger keyword
+3. ❌ 直接写 `published/` / `evidence/`（read-only）
+4. ❌ AI 生成 commit 没用 `feat(ai):` 前缀
+5. ❌ 改 `docs/governance/X.md` 没同步 AGENTS.md §7 摘要
+
+## E. 速查锚点
+
+| 想查 | 去 |
+|-----|----|
+| 改 X 时该读哪些 | `AGENTS.md` §6.1 路径触发表 |
+| 每类规则的唯一权威 | `AGENTS.md` §7 权威映射 |
+| 子目录硬约定 vs 软建议 | `docs/README.md` §5 |
+| 特性 slug 命名规则 | `docs/README.md` §6 |
+| 五档 access mode 定义 | `docs/governance/ai-access-modes.md` §2 |
+| 完整 6 类 checklist | `docs/governance/checklists.md` |

package/src/templates/docs-skeleton/fragment.yaml

@@ -0,0 +1,129 @@
+name: docs-skeleton
+version: 1.1.0
+appliesWhen: {}
+priority: 15
+files:
+  - from: files/README.md
+    to: docs/README.md
+    render: true
+  # 01-背景与需求/
+  - from: files/bg-README.md
+    to: docs/01-背景与需求/README.md
+    render: false
+  - from: files/bg-_ai-policy.yaml
+    to: docs/01-背景与需求/_ai-policy.yaml
+    render: false
+  # 02-系统方案与架构/
+  - from: files/arch-README.md
+    to: docs/02-系统方案与架构/README.md
+    render: false
+  - from: files/arch-_ai-policy.yaml
+    to: docs/02-系统方案与架构/_ai-policy.yaml
+    render: false
+  # 03-工程规范与研发基础设施/
+  - from: files/eng-README.md
+    to: docs/03-工程规范与研发基础设施/README.md
+    render: false
+  - from: files/eng-_ai-policy.yaml
+    to: docs/03-工程规范与研发基础设施/_ai-policy.yaml
+    render: false
+  - from: files/usage-quickstart.md
+    to: docs/03-工程规范与研发基础设施/usage-quickstart.md
+    render: false
+  # 04-后端详细设计/
+  - from: files/be-README.md
+    to: docs/04-后端详细设计/README.md
+    render: false
+  - from: files/be-_ai-policy.yaml
+    to: docs/04-后端详细设计/_ai-policy.yaml
+    render: false
+  # 05-前端客户端详细设计/
+  - from: files/fe-README.md
+    to: docs/05-前端客户端详细设计/README.md
+    render: false
+  - from: files/fe-_ai-policy.yaml
+    to: docs/05-前端客户端详细设计/_ai-policy.yaml
+    render: false
+  # archive/
+  - from: files/archive-README.md
+    to: docs/archive/README.md
+    render: false
+  - from: files/archive-_ai-policy.yaml
+    to: docs/archive/_ai-policy.yaml
+    render: false
+  # assets/
+  - from: files/assets-README.md
+    to: docs/assets/README.md
+    render: false
+  - from: files/assets-_ai-policy.yaml
+    to: docs/assets/_ai-policy.yaml
+    render: false
+  - from: files/assets-diagrams-gitkeep
+    to: docs/assets/diagrams/.gitkeep
+    render: false
+  - from: files/assets-images-gitkeep
+    to: docs/assets/images/.gitkeep
+    render: false
+  - from: files/assets-design-gitkeep
+    to: docs/assets/design/.gitkeep
+    render: false
+  # references/
+  - from: files/references-README.md
+    to: docs/references/README.md
+    render: false
+  - from: files/references-_ai-policy.yaml
+    to: docs/references/_ai-policy.yaml
+    render: false
+  - from: files/references-standards-source.yaml
+    to: docs/references/standards/_source.yaml.template
+    render: false
+  - from: files/references-vendors-source.yaml
+    to: docs/references/vendors/_source.yaml.template
+    render: false
+  - from: files/references-legal-source.yaml
+    to: docs/references/legal/_source.yaml.template
+    render: false
+  # governance/
+  - from: files/governance-README.md
+    to: docs/governance/README.md
+    render: false
+  - from: files/governance-ci.md
+    to: docs/governance/ci.md
+    render: true
+  - from: files/governance-security.md
+    to: docs/governance/security.md
+    render: true
+  - from: files/governance-git-workflow.md
+    to: docs/governance/git-workflow.md
+    render: true
+  - from: files/governance-assets.md
+    to: docs/governance/assets.md
+    render: true
+  - from: files/governance-docs-references.md
+    to: docs/governance/docs-references.md
+    render: true
+  - from: files/governance-integrations.md
+    to: docs/governance/integrations.md
+    render: true
+  - from: files/governance-deploy-ops.md
+    to: docs/governance/deploy-ops.md
+    render: true
+  - from: files/governance-tools-scripts.md
+    to: docs/governance/tools-scripts.md
+    render: true
+  - from: files/governance-ai-access-modes.md
+    to: docs/governance/ai-access-modes.md
+    render: true
+  - from: files/governance-checklists.md
+    to: docs/governance/checklists.md
+    render: true
+  - from: files/governance-_ai-policy.yaml
+    to: docs/governance/_ai-policy.yaml
+    render: false
+  # 过程文档/
+  - from: files/process-docs-README.md
+    to: docs/过程文档/README.md
+    render: false
+  - from: files/process-docs-_ai-policy.yaml
+    to: docs/过程文档/_ai-policy.yaml
+    render: false

package/src/templates/integrations-docs/files/README.md

@@ -0,0 +1,53 @@
+# 06-集成对接
+
+跨执行环境的对接文档（例如 `agent` ↔ `server`、`web` ↔ `server`、`mobile` ↔ `server`）。
+
+## 本目录的存在是**显式启用**的
+
+本仓库创建时选择了 `integrations = true`，所以你会看到这个目录。
+如果整个系统只在**本仓库内部**互相调用（例如前后端同仓库、无外部协作方），
+就不需要启用本目录。
+
+初始化没有任何 pair 子目录；只有当你主动建立与外部仓库 / 外部团队的
+对接时，才创建 `<consumer>-to-<producer>/`。
+
+## 与 `contracts/` 的边界
+
+- `contracts/` 是**机器可验证的权威契约**（OpenAPI、Schema、错误码）。
+- 本目录是**契约没说、但双方都必须知道**的事情（鉴权流程、连接生命周期、重试策略、版本兼容矩阵、联调 checklist）。
+
+不要把契约复制进本目录；始终通过**锚点引用**指向契约，例如：
+
+```
+contracts/openapi/api.yaml#/paths/~1auth~1login
+```
+
+## 目录命名
+
+- 格式：`<consumer>-to-<producer>/`
+- 名字用执行环境名（`server` / `web` / `mobile` / `miniapp` / `agent`）或具体应用名
+- 多应用模式下可细化到应用：`agent-cli-to-server-auth/`
+- 例：`web-to-server/`、`mobile-to-server/`、`miniapp-to-server/`
+
+## 每个 pair 的骨架
+
+复制本目录下的 `_template.md`，改名为 `README.md` 或拆成多个 md 文件。
+7 章结构：
+
+1. 概览
+2. 鉴权与会话
+3. 连接与生命周期
+4. 数据流与一致性约束
+5. 错误分支与降级
+6. 版本兼容矩阵
+7. 联调 checklist
+
+## 维护义务（存在即维护）
+
+一旦某 pair 目录存在，修改 `contracts/` 且影响到它时必须：
+
+- 在 PR 描述中引用对应 `docs/06-集成对接/<pair>/` 文档
+- 在同一 PR 同步更新该文档（至少更新版本兼容矩阵与受影响章节）
+- 在 `contracts/CHANGELOG.md` 条目中反向链接到更新后的集成文档
+
+否则 PR 不得合入。

package/src/templates/integrations-docs/files/_template.md

@@ -0,0 +1,63 @@
+# <consumer> ↔ <producer> 集成说明
+
+> 复制本文件到 `docs/06-集成对接/<consumer>-to-<producer>/README.md`，替换占位符后使用。
+> 本文件**不是契约**。契约的唯一权威在 `contracts/`，这里只写"契约没说但必须知道"的事。
+
+## 0. 文档元信息
+
+- 消费端：`<consumer>`（owner：@team-a）
+- 生产端：`<producer>`（owner：@team-b）
+- 当前适用契约版本：`contracts/openapi/api.yaml @ v<x.y.z>`
+- 最近联调日期：YYYY-MM-DD
+
+## 1. 概览
+
+这对集成解决的业务问题是什么？为什么不用现有的其它通道？
+
+## 2. 鉴权与会话
+
+- 鉴权方式：<例如 OAuth2 / 签名 / 设备指纹>
+- Token 生命周期、刷新策略、失效处理
+- 多端并发登录的约束
+
+引用契约锚点：`contracts/openapi/api.yaml#/paths/~1auth~1...`
+
+## 3. 连接与生命周期
+
+- 连接建立顺序（握手、能力协商、订阅）
+- 心跳策略（频率、超时、服务端容忍值）
+- 断线重连策略（退避、上限、幂等保证）
+- 优雅关闭
+
+## 4. 数据流与一致性
+
+- 幂等键规则
+- 顺序保证（是否保序 / 乱序可接受性）
+- 离线队列与重放
+- 去重窗口
+
+## 5. 错误分支与降级
+
+| 错误码 | 消费端应对 | 是否重试 | 降级路径 |
+| ------ | ---------- | -------- | -------- |
+| `AUTH.TOKEN_EXPIRED` | 刷新 token 后重试 | 是（一次） | 让用户重新登录 |
+| `RATE.LIMITED` | 指数退避 | 是 | 本地缓存提供降级数据 |
+| ...    | ...        | ...      | ...      |
+
+## 6. 版本兼容矩阵
+
+| <consumer> 版本 | <producer> 版本 | 兼容 | 备注 |
+| --------------- | --------------- | ---- | ---- |
+| v1.0.x          | v1.0.x – v1.3.x | ✅   | 初始协议 |
+| v1.1.x          | v1.2.x+         | ✅   | 新增字段 `xxx` |
+| v2.0.x          | v2.x            | ✅   | 破坏性变更 |
+
+破坏性变更的迁移路径另附 `migration-<from>-to-<to>.md`。
+
+## 7. 联调 checklist
+
+- [ ] 本地 mock server 可用（`tools/contract/mock` 或 `contracts/resources/mocks/`）
+- [ ] 测试账号 / 测试设备准备就绪
+- [ ] 抓包环境就绪（mitmproxy / Charles）
+- [ ] 预期错误场景已测（至少 §5 的每种错误码触发一次）
+- [ ] 已在目标环境跑通 happy path

package/src/templates/integrations-docs/fragment.yaml

@@ -0,0 +1,12 @@
+name: integrations-docs
+version: 1.0.0
+appliesWhen:
+  integrations: true
+priority: 20
+files:
+  - from: files/README.md
+    to: docs/06-集成对接/README.md
+    render: true
+  - from: files/_template.md
+    to: docs/06-集成对接/_template.md
+    render: false

package/src/templates/license-apache-2/files/LICENSE

@@ -0,0 +1,15 @@
+Apache License, Version 2.0
+
+Copyright (c) <%= it.year %> <%= it.options.projectName %> authors
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not
+use this file except in compliance with the License. You may obtain a copy of
+the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+License for the specific language governing permissions and limitations under
+the License.

package/src/templates/license-apache-2/fragment.yaml

@@ -0,0 +1,9 @@
+name: license-apache-2
+version: 1.0.0
+appliesWhen:
+  license: apache-2.0
+priority: 20
+files:
+  - from: files/LICENSE
+    to: LICENSE
+    render: true

package/src/templates/license-mit/files/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) <%= it.year %> <%= it.options.projectName %> authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/src/templates/license-mit/fragment.yaml

@@ -0,0 +1,9 @@
+name: license-mit
+version: 1.0.0
+appliesWhen:
+  license: mit
+priority: 20
+files:
+  - from: files/LICENSE
+    to: LICENSE
+    render: true

package/src/templates/miniapp-wechat/files/README.md

@@ -0,0 +1,10 @@
+# miniapp/
+
+WeChat Mini Program for **<%= it.options.projectName %>**.
+
+Import this directory in WeChat Developer Tools ("导入项目") and supply
+your own AppID (replace `touristappid` in `project.config.json`).
+
+Contract-first: all network code should consume the contracts under
+`contracts/`. Generated bindings live in `miniapp/generated/` and must
+not be hand-edited.

package/src/templates/miniapp-wechat/files/app.js

@@ -0,0 +1,5 @@
+App({
+  onLaunch() {
+    // entry point; fill in global init here
+  },
+});

package/src/templates/miniapp-wechat/files/app.json

@@ -0,0 +1,9 @@
+{
+  "pages": ["pages/index/index"],
+  "window": {
+    "navigationBarBackgroundColor": "#ffffff",
+    "navigationBarTextStyle": "black",
+    "navigationBarTitleText": "miniapp"
+  },
+  "style": "v2"
+}

package/src/templates/miniapp-wechat/files/app.wxss

@@ -0,0 +1,4 @@
+page {
+  font-family: -apple-system, BlinkMacSystemFont, sans-serif;
+  background: #f5f5f5;
+}

package/src/templates/miniapp-wechat/files/pages-index.js

@@ -0,0 +1,4 @@
+Page({
+  data: {},
+  onLoad() {},
+});

package/src/templates/miniapp-wechat/files/pages-index.json

@@ -0,0 +1,3 @@
+{
+  "usingComponents": {}
+}

package/src/templates/miniapp-wechat/files/pages-index.wxml

@@ -0,0 +1,3 @@
+<view class="container">
+  <text class="title">hello</text>
+</view>

package/src/templates/miniapp-wechat/files/pages-index.wxss

@@ -0,0 +1,10 @@
+.container {
+  padding: 40rpx;
+  display: flex;
+  justify-content: center;
+}
+
+.title {
+  font-size: 36rpx;
+  color: #333;
+}

package/src/templates/miniapp-wechat/files/project.config.json

@@ -0,0 +1,13 @@
+{
+  "description": "<%= it.options.projectName %> mini program",
+  "miniprogramRoot": "./",
+  "appid": "touristappid",
+  "projectname": "<%= it.options.projectName %>",
+  "setting": {
+    "es6": true,
+    "enhance": true,
+    "postcss": true,
+    "minified": true
+  },
+  "compileType": "miniprogram"
+}

package/src/templates/miniapp-wechat/files/sitemap.json

@@ -0,0 +1,8 @@
+{
+  "rules": [
+    {
+      "action": "allow",
+      "page": "*"
+    }
+  ]
+}

package/src/templates/miniapp-wechat/fragment.yaml

@@ -0,0 +1,39 @@
+name: miniapp-wechat
+version: 1.0.0
+appliesWhen:
+  miniapp: wechat
+priority: 30
+files:
+  - from: files/README.md
+    to: miniapp/README.md
+    render: true
+  - from: files/project.config.json
+    to: miniapp/project.config.json
+    render: true
+  - from: files/app.json
+    to: miniapp/app.json
+    render: false
+  - from: files/app.js
+    to: miniapp/app.js
+    render: false
+  - from: files/app.wxss
+    to: miniapp/app.wxss
+    render: false
+  - from: files/sitemap.json
+    to: miniapp/sitemap.json
+    render: false
+  - from: files/pages-index.wxml
+    to: miniapp/pages/index/index.wxml
+    render: false
+  - from: files/pages-index.wxss
+    to: miniapp/pages/index/index.wxss
+    render: false
+  - from: files/pages-index.js
+    to: miniapp/pages/index/index.js
+    render: false
+  - from: files/pages-index.json
+    to: miniapp/pages/index/index.json
+    render: false
+  - from: files/generated-gitkeep
+    to: miniapp/generated/.gitkeep
+    render: false

package/src/templates/mobile-flutter/files/README.md

@@ -0,0 +1,14 @@
+# mobile/
+
+Flutter app for **<%= it.options.projectName %>**.
+
+Contract-first: any code that talks to `server/` must be aligned with
+`contracts/openapi/api.yaml`. Generated network bindings live in
+`mobile/generated/` and are not hand-edited.
+
+## Build
+
+```
+flutter pub get
+flutter run
+```

package/src/templates/mobile-flutter/files/analysis_options.yaml

@@ -0,0 +1,6 @@
+include: package:flutter_lints/flutter.yaml
+
+linter:
+  rules:
+    avoid_print: true
+    prefer_const_constructors: true

package/src/templates/mobile-flutter/files/main.dart

@@ -0,0 +1,18 @@
+import 'package:flutter/material.dart';
+
+void main() {
+  runApp(const App());
+}
+
+class App extends StatelessWidget {
+  const App({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    return const MaterialApp(
+      home: Scaffold(
+        body: Center(child: Text('hello')),
+      ),
+    );
+  }
+}