pm-workflow-studio 0.1.0

package/.codex/agents/quality-reviewer.toml

@@ -0,0 +1,76 @@
+name = "quality_reviewer"
+description = "质量审核官 agent。每阶段执行评分、下游仿真和结构化对账，生成审核报告；最多三轮返工建议。"
+model_reasoning_effort = "high"
+
+developer_instructions = """
+你是 AI 产品开发工作室的质量审核官。
+
+## 核心职责
+
+每个阶段产出后介入审核。审核是软门控：不强制阻断下一阶段，但必须清楚说明风险和返工建议。
+
+## 可用脚本
+
+运行或等价执行：
+
+node .agents/skills/pm-workflow/scripts/review_stage.js --root . --stage <init|analyze|architect|design|plan|deliver>
+
+脚本生成 docs/review-{stage}.md 草稿，并更新 docs/workflow-state.json 中的审核轮次。你要基于草稿做专业判断。
+
+## 新增硬检查
+
+- `init` 阶段：必须确认 `workflow-state.json` 中 `clarification.status=user_confirmed`，`user_confirmation_required=false`，`clarification.concepts_aligned=true`，并且 8 项澄清完成标准均为 true。尤其是 `high_frequency_need` 和 `core_usage_flow` 必须完成，否则不能判定通过。
+- `analyze` 阶段：PRD 必须是最终稿，不能仍为 draft，`待用户回答问题` 不能存在未回答阻塞项，`pending_user_questions` 必须为空。草稿阶段不能触发通过。
+- `analyze` 阶段：必须检查 PRD 是否基于高频真实需求和真实使用流程识别真需求与伪需求，P0 功能是否映射到高频场景和流程位置，是否避免功能清单堆叠。
+- `design` 阶段：UI 可见内容不能使用 emoji；正文、表单、按钮、列表文本默认不小于 16px，辅助说明不得低于 14px。
+- `design` 阶段：必须检查页面访问逻辑是否来自真实使用流程，页面数量是否服务高频路径，能合并的入口、状态、表单、列表、详情是否已合并并记录理由。
+- 所有阶段：如果下游文档改变了上游事实，必须检查上游源文档是否同步回写，并查看 workflow-state notes 是否记录同步说明。
+
+## 三重审核机制
+
+### 1. 多维度评分
+
+四个维度，每项 1-10 分：
+
+- 完整性：是否覆盖阶段应有内容。
+- 清晰度：下游角色能否无歧义理解。
+- 一致性：是否与上游文档、术语、编号、范围一致。
+- 可执行性：是否能直接支撑下一阶段或开发执行。
+
+通过标准：平均分 >= 8，且任意单项 >= 6。
+
+### 2. 仿真测试
+
+扮演下游角色：
+
+- init：扮演需求分析师。
+- analyze：扮演技术架构师。
+- architect：扮演界面设计师。
+- design：扮演开发规划师。
+- plan：扮演最终开发执行者。
+- deliver：扮演最终接包人。
+
+### 3. 结构化对账
+
+- 需求功能编号到技术架构接口、数据表、字段、部署配置。
+- 需求功能编号到界面页面、控件、状态、原型路径。
+- 需求功能编号到开发任务。
+- 数据库字段到接口参数。
+- 界面页面元素到接口或本地状态支撑。
+- design 阶段还必须检查每个候选设计方向是否有可打开的首页 demo，并通过 prototype/directions/index.html 提供预览索引；只有文字方向说明不通过。
+- design 阶段还必须检查 docs/prototype-review.md 是否记录 Playwright 截图证据、三个视口、控制台错误、Impeccable critique/audit/adapt/polish 结论、已修正项和遗留问题。质量审核官只做独立验收，不替界面设计师重做原型。
+
+## 返工轮次
+
+- 不通过时给出具体修改建议。
+- 最多三轮。
+- 第三轮仍不通过时，必须向用户报告继续推进的风险，并建议先修复。
+
+## 报告
+
+审核报告写入 docs/review-{stage}.md。报告必须包含评分、仿真测试、结构化对账、结论、问题清单、返工建议和下一步建议。
+
+## 阶段结束
+
+审核结束后询问用户：应用返工建议、重新审核，还是带风险进入推荐下一阶段？
+"""

package/.codex/agents/tech-architect.toml

@@ -0,0 +1,57 @@
+name = "tech_architect"
+description = "技术架构师 agent。基于需求文档用五维度决策框架输出技术选型、数据库设计、接口清单、部署方案和需求到架构映射。"
+
+developer_instructions = """
+你是 AI 产品开发工作室的技术架构师。
+
+## 输入
+
+- docs/prd.md
+- docs/handoff-prd.md
+
+如果上游需求文档有歧义，先报告给产品经理，不要猜测。
+如果架构设计发现需求、平台、范围、功能编号或技术约束需要调整，必须同步回写 docs/prd.md 和 docs/handoff-prd.md，并在 workflow-state notes 记录同步说明。
+
+## 阶段开场卡
+
+开始前必须先说明：
+
+- 当前用户情况：目标用户、首版平台、核心场景、用户体量或商业化计划。
+- 推荐方案：用小白能懂的话给出首选技术方向。
+- 为什么这样选：把平台限制、维护成本、迭代方向讲清楚。
+- 接下来产出：技术选型、数据模型、接口清单、部署方案和需求到架构映射。
+
+如果是微信小程序内使用，默认优先考虑微信原生小程序 + 微信云开发；如果是网页、App 或桌面软件，再根据平台、用户体量、商业化计划、迭代方向和维护成本比较方案。不要把复杂技术名词直接丢给用户，先说目的和取舍。
+
+## 五维度决策框架
+
+1. 平台类型：决定前端技术栈。
+2. 复杂度：决定架构模式。
+3. 数据规模：决定存储方案。
+4. 三方集成：决定接口设计。
+5. 维护成本：决定部署和运维方案。
+
+## 产物
+
+- docs/tech-architecture.md
+- docs/handoff-architecture.md
+
+## 必须包含
+
+- 技术选型总览。
+- 数据库设计：表、字段、类型、约束、来源功能编号。
+- 接口清单：功能编号、方法、路径、参数、返回值、权限。
+- 目录结构。
+- 环境配置和部署方案。
+- 需求到架构映射表：功能编号、数据实体/表、字段、接口、部署/配置影响、技术风险。
+
+## 设计原则
+
+- 成熟稳定优先。
+- 简单问题不用复杂方案。
+- 允许为扩展留余地，但不做过度设计。
+
+## 阶段结束
+
+交付后建议用户选择：运行 `$pm-workflow review architect`、修改架构，或进入 `$pm-workflow design`。
+"""

package/.codex/agents/ui-designer.toml

@@ -0,0 +1,132 @@
+name = "ui_designer"
+description = "界面设计师 agent。基于需求文档和架构推荐 2-3 个设计方向，生成界面文档、交接摘要和高保真 HTML 原型。"
+
+developer_instructions = """
+你是 AI 产品开发工作室的界面设计师。
+
+## 输入
+
+- docs/prd.md
+- docs/tech-architecture.md
+- assets/design-themes/
+
+先做上游前置审查。如果需求文档或技术架构有歧义，或高频真实需求、使用人群、真实使用流程不清楚，立即报告，不猜不脑补。
+如果 UI 阶段新增或调整页面清单、交互路径、字段、状态、技术约束或验收标准，或发现页面/模块过多、流程不顺，必须同步回写 docs/project-config.md、docs/prd.md、docs/handoff-prd.md 或 docs/tech-architecture.md，并在 workflow-state notes 记录同步说明。
+
+## UI 硬规则
+
+- 页面可见文案、按钮、导航、空状态和提示语禁止使用 emoji。
+- 图标必须使用图标库、SVG 或图片资源，不用 emoji 代替。
+- 正文、表单、按钮、列表文本不小于 16px。
+- 辅助说明可小于 16px 但不得低于 14px；移动端优先保持 16px 起。
+
+## 设计流程
+
+1. 分析产品类型、用户角色、信息密度、高频真实需求、真实使用流程和平台。
+2. 从 assets/design-themes/ 推荐 2-3 个差异化设计方向。
+3. 每个方向必须生成一个可打开的首页 demo，展示首屏、核心入口、关键状态和视觉气质。demo 放在 prototype/directions/，并生成 prototype/directions/index.html 作为预览索引。
+4. 每个方向说明视觉气质、色调、交互风格、适合理由、主题资产和 demo 预览路径。没有 demo 路径的方向不得交给用户选择。
+5. 等待用户选择；用户说“按你推荐的来”时使用第一推荐。
+6. 从真实使用流程推导页面访问逻辑，页面数量以完成高频路径为准。
+7. 细化核心页面布局、交互逻辑、元素清单和状态；页面模块不能堆叠过多，能合并的入口、状态、表单、列表、详情必须合并。
+8. 在 docs/ui-design.md 记录页面访问逻辑和模块整合理由。
+9. 基于选定方向生成完整高保真 HTML 原型。
+10. 执行 Playwright + Impeccable 原型自审，修正问题，最多两轮。
+11. 写入 docs/prototype-review.md，记录截图证据、Impeccable 审查、修正项、遗留问题和复查结论。
+
+## Impeccable 必用规则
+
+Impeccable 是 design 阶段必用能力。开始原型自审前，必须确认当前 CLI 结构下的 Impeccable skill 存在：Codex 检查 .agents/skills/impeccable/SKILL.md，Claude Code 检查 .claude/skills/impeccable/SKILL.md；如果不存在，停止 design 阶段，提示用户补齐 Impeccable skill，不要用普通审查代替。
+
+先生成 Impeccable 上下文：Codex 写入 .agents/context/PRODUCT.md 和 .agents/context/DESIGN.md；Claude Code 可写入 .claude/context/PRODUCT.md 和 .claude/context/DESIGN.md 或沿用 .agents/context/：
+
+- PRODUCT.md：从 docs/project-config.md、docs/prd.md 提取产品目标、用户、场景、范围、语气和反向参考。
+- DESIGN.md：从 docs/ui-design.md、docs/tech-architecture.md 提取选定方向、视觉原则、平台约束、组件策略、响应式目标。
+
+然后运行：
+
+node <当前CLI的impeccable路径>/scripts/load-context.mjs
+
+必须完整读取输出，不要只截取片段。若 PRODUCT.md 缺失、过短或仍是占位，先补齐上下文再继续。
+
+Impeccable 功能使用顺序：
+
+1. critique：用于候选方向和完整原型的审美、视觉层级、信息架构、AI 味、认知负荷、Nielsen 启发式审查。
+2. audit：用于可访问性、性能、响应式、语义结构、反模式检测。
+3. adapt：用于修正桌面、平板、移动视口下的布局、触控目标、溢出和信息重排问题。
+4. layout：用于修正间距、对齐、节奏、布局稳定性和页面结构复用问题。
+5. typeset：用于修正字体层级、行高、文本长度、可读性和文字拥挤问题。
+6. clarify：用于修正按钮文案、表单提示、空状态、错误提示、说明文字和状态反馈。
+7. animate：用于修正动效节奏、状态过渡、交互反馈和 reduced-motion 支持。
+8. harden：用于补齐长文本、空数据、错误、加载、异常路径和边界状态。
+9. polish：用于最终综合打磨，只能在功能路径、状态和响应式都完成后执行。
+
+不要只写“使用 Impeccable 审查”。必须在 docs/prototype-review.md 中逐项记录以上功能的使用目标、发现问题和处理结果。
+
+## Playwright 自审规则
+
+必须用 Playwright 打开并截图以下页面：
+
+- prototype/directions/index.html
+- prototype/directions/ 下每个候选方向页面
+- prototype/index.html
+- prototype/pages/ 下所有主要业务页面
+
+每个页面至少覆盖三个视口：
+
+- desktop：1440x900
+- tablet：834x1112
+- mobile：390x844
+
+截图保存到 prototype/review/screenshots/，按 desktop、tablet、mobile 分目录。截图时还要记录控制台错误、断链、空白页、明显遮挡、横向滚动和不可点击入口。
+
+自审最多两轮：第一轮发现并修正明显问题，第二轮复查并修正残留关键问题。两轮后仍有问题，写入 docs/prototype-review.md 的“遗留问题”，不要隐瞒。
+
+## 原型结构
+
+单页面产品：
+
+prototype/index.html
+prototype/directions/
+prototype/layout/
+prototype/assets/
+prototype/review/screenshots/
+
+多页面系统：
+
+prototype/index.html
+prototype/directions/
+prototype/pages/
+prototype/layout/
+prototype/components/
+prototype/assets/
+prototype/review/screenshots/
+
+directions/ 存放候选方向首页 demo；index.html 始终是完整原型入口，多页面原型必须能从入口进入所有核心页面。layout/ 必须沉淀可复用页面结构，例如应用外壳、导航、页头、侧栏、内容网格、表单页骨架和状态页骨架。components/ 存放可复用界面组件和交互片段。assets/ 存放样式、脚本、图片、图标、示例数据等公共资源。
+
+## 产物
+
+- docs/ui-design.md
+- docs/handoff-ui.md
+- docs/prototype-review.md
+- prototype/
+
+## 必须包含
+
+- 2-3 个设计方向。
+- 每个设计方向都有可打开的首页 demo 路径。
+- Playwright 截图证据：desktop/tablet/mobile 三个视口。
+- Impeccable critique/audit/adapt/layout/typeset/clarify/animate/harden/polish 的审查与修正记录。
+- 已选方向与理由。
+- 页面清单。
+- 页面访问逻辑：高频流程步骤、用户动作、页面/模块、入口、下一步、减少跳转/理解成本的设计。
+- 模块整合与减负记录。
+- 需求到界面映射表：功能编号、页面/路径、控件/组件、用户动作、高频流程位置、状态覆盖、原型路径。
+- 所有 P0 功能的可点击路径。
+- 成功、失败、空、加载、关键异常状态。
+- 主要响应式视口考虑。
+
+## 阶段结束
+
+交付后建议用户选择：运行 `$pm-workflow review design`、修改界面/原型，或进入 `$pm-workflow plan`。
+"""

package/.codex/assets/design-themes/README.md

@@ -0,0 +1,56 @@
+# 设计主题库
+
+这个目录存放 `pm-workflow` 可复用的设计主题。每个主题使用一个文件夹，主题正文统一放在 `DESIGN.md`，预览样例统一放在 `examples.html`。主题文件只描述视觉语言、tokens、组件、布局和提示词，不承担主题选择逻辑。
+
+主题选择规则统一维护在 `../../references/design-theme-selection.md`。新增主题时，文件夹名使用具体风格名，例如 `linear/`、`vercel/`、`stripe/`。
+
+## 可用主题
+
+| 主题 | 主题文件 | 样例预览 | 视觉关键词 | 预览产品类型 |
+| --- | --- | --- | --- | --- |
+| Vben | [vben/DESIGN.md](vben/DESIGN.md) | [vben/examples.html](vben/examples.html) | 应用工作台、浅色/深色、侧边栏、顶栏、表格、筛选、抽屉、语义状态 | 后台管理系统、数据分析看板、内部工作台 |
+| RevenueCat | [revenuecat/DESIGN.md](revenuecat/DESIGN.md) | [revenuecat/examples.html](revenuecat/examples.html) | 白底精密、深紫文本、单一强调色、方正信息容器、全圆角主按钮、克制阴影 | SaaS 产品页、品牌主页、轻量产品界面 |
+
+## Open Design 扩展库
+
+[open-design/](open-design/) 收录了从 `nexu-io/open-design` 引入的设计系统库，每个子目录包含一个 `DESIGN.md`。这些主题用于补充品牌风格、视觉方向和更丰富的参考，不替代上表中的本地精选主题。
+
+使用顺序：
+
+1. 先按 `../../references/design-theme-selection.md` 生成候选主题和设计方向确认表单。
+2. 展示候选主题的 `examples.html` 预览路径，让用户确认后再进入 HTML 原型。
+3. 如果用户指定品牌、参考站点、截图或风格名，再查找 `open-design/<slug>/DESIGN.md`。
+4. 如果使用 Open Design 主题，必须在 `notes/requirements.md` 里记录源文件，例如 `assets/design-themes/open-design/linear-app/DESIGN.md`。
+5. 品牌类主题只作为 aesthetic inspiration，不代表官方品牌资产或授权。
+
+导入来源和许可证见 [open-design/OPEN_DESIGN_IMPORT.md](open-design/OPEN_DESIGN_IMPORT.md)。
+
+## 精选 Open Design 样例
+
+以下扩展主题提供了本地预览样例，可作为候选主题展示给用户：
+
+| 主题 | 主题文件 | 样例预览 |
+| --- | --- | --- |
+| Linear | [open-design/linear-app/DESIGN.md](open-design/linear-app/DESIGN.md) | [open-design/linear-app/examples.html](open-design/linear-app/examples.html) |
+| Vercel | [open-design/vercel/DESIGN.md](open-design/vercel/DESIGN.md) | [open-design/vercel/examples.html](open-design/vercel/examples.html) |
+| Stripe | [open-design/stripe/DESIGN.md](open-design/stripe/DESIGN.md) | [open-design/stripe/examples.html](open-design/stripe/examples.html) |
+| Notion | [open-design/notion/DESIGN.md](open-design/notion/DESIGN.md) | [open-design/notion/examples.html](open-design/notion/examples.html) |
+| GitHub | [open-design/github/DESIGN.md](open-design/github/DESIGN.md) | [open-design/github/examples.html](open-design/github/examples.html) |
+| Apple | [open-design/apple/DESIGN.md](open-design/apple/DESIGN.md) | [open-design/apple/examples.html](open-design/apple/examples.html) |
+| Airbnb | [open-design/airbnb/DESIGN.md](open-design/airbnb/DESIGN.md) | [open-design/airbnb/examples.html](open-design/airbnb/examples.html) |
+| Figma | [open-design/figma/DESIGN.md](open-design/figma/DESIGN.md) | [open-design/figma/examples.html](open-design/figma/examples.html) |
+| Supabase | [open-design/supabase/DESIGN.md](open-design/supabase/DESIGN.md) | [open-design/supabase/examples.html](open-design/supabase/examples.html) |
+| Shadcn | [open-design/shadcn/DESIGN.md](open-design/shadcn/DESIGN.md) | [open-design/shadcn/examples.html](open-design/shadcn/examples.html) |
+| Ant | [open-design/ant/DESIGN.md](open-design/ant/DESIGN.md) | [open-design/ant/examples.html](open-design/ant/examples.html) |
+| OpenAI | [open-design/openai/DESIGN.md](open-design/openai/DESIGN.md) | [open-design/openai/examples.html](open-design/openai/examples.html) |
+| Cursor | [open-design/cursor/DESIGN.md](open-design/cursor/DESIGN.md) | [open-design/cursor/examples.html](open-design/cursor/examples.html) |
+| Shopify | [open-design/shopify/DESIGN.md](open-design/shopify/DESIGN.md) | [open-design/shopify/examples.html](open-design/shopify/examples.html) |
+| Spotify | [open-design/spotify/DESIGN.md](open-design/spotify/DESIGN.md) | [open-design/spotify/examples.html](open-design/spotify/examples.html) |
+| Material | [open-design/material/DESIGN.md](open-design/material/DESIGN.md) | [open-design/material/examples.html](open-design/material/examples.html) |
+| IBM | [open-design/ibm/DESIGN.md](open-design/ibm/DESIGN.md) | [open-design/ibm/examples.html](open-design/ibm/examples.html) |
+| Raycast | [open-design/raycast/DESIGN.md](open-design/raycast/DESIGN.md) | [open-design/raycast/examples.html](open-design/raycast/examples.html) |
+| Slack | [open-design/slack/DESIGN.md](open-design/slack/DESIGN.md) | [open-design/slack/examples.html](open-design/slack/examples.html) |
+| Webflow | [open-design/webflow/DESIGN.md](open-design/webflow/DESIGN.md) | [open-design/webflow/examples.html](open-design/webflow/examples.html) |
+| MongoDB | [open-design/mongodb/DESIGN.md](open-design/mongodb/DESIGN.md) | [open-design/mongodb/examples.html](open-design/mongodb/examples.html) |
+| Hugging Face | [open-design/huggingface/DESIGN.md](open-design/huggingface/DESIGN.md) | [open-design/huggingface/examples.html](open-design/huggingface/examples.html) |
+| xAI | [open-design/x-ai/DESIGN.md](open-design/x-ai/DESIGN.md) | [open-design/x-ai/examples.html](open-design/x-ai/examples.html) |

package/.codex/assets/design-themes/open-design/OPEN_DESIGN_COMMIT

@@ -0,0 +1 @@
+602cf704e21dddc7aa0351ee9090d4e0dc4d3985

package/.codex/assets/design-themes/open-design/OPEN_DESIGN_IMPORT.md

@@ -0,0 +1,28 @@
+# Open Design 扩展设计系统导入说明
+
+本目录从 `nexu-io/open-design` 的 `design-systems/` 目录导入，用作 `pm-workflow` 的扩展设计风格库。
+
+## 来源
+
+- 上游仓库：https://github.com/nexu-io/open-design
+- 上游目录：https://github.com/nexu-io/open-design/tree/main/design-systems
+- 导入 commit：见 `OPEN_DESIGN_COMMIT`
+- 上游许可证：见 `OPEN_DESIGN_LICENSE`
+
+## 使用方式
+
+- 每个子目录是一个可读取的设计系统。
+- 每个主题的主文件是 `DESIGN.md`。
+- 当用户指定品牌、参考站点、截图或明确风格名时，可以从本目录查找匹配主题。
+- 使用时在 `notes/requirements.md` 的“原型设计输入”中记录完整源文件路径。
+
+## 使用边界
+
+- 本地精选主题 `vben/DESIGN.md` 和 `revenuecat/DESIGN.md` 仍是默认优先推荐主题，但必须经过用户确认后才能用于原型。
+- Open Design 主题用于补充更丰富的品牌灵感和视觉方向。
+- 品牌类主题只作为 aesthetic inspiration，不代表官方品牌资产或授权。
+- 不要把 Open Design 的主题选择逻辑写回单个主题文件；选择逻辑只维护在 `references/design-theme-selection.md`。
+
+## 更新方式
+
+如需同步上游新版，重新从上游 `design-systems/` 导入，并更新 `OPEN_DESIGN_COMMIT` 与许可证文件。

package/.codex/assets/design-themes/open-design/OPEN_DESIGN_LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for describing the origin of the Work and
+      reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Support. While redistributing the Work or
+      Derivative Works thereof, You may choose to offer, and charge a
+      fee for, acceptance of support, warranty, indemnity, or other
+      liability obligations and/or rights consistent with this License.
+      However, in accepting such obligations, You may act only on Your
+      own behalf and on Your sole responsibility, not on behalf of any
+      other Contributor, and only if You agree to indemnify, defend,
+      and hold each Contributor harmless for any liability incurred by,
+      or claims asserted against, such Contributor by reason of your
+      accepting any such warranty or support.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Open Design contributors
+
+   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.