@namewta/speculo 0.8.6 → 0.8.7

package/template/workflows/specdev/P-prototype/logic-prototype.md

@@ -1,24 +0,0 @@
-# Logic Prototype
-
-当问题涉及业务逻辑、状态转换或数据形态时使用。
-
-## 形态
-
-构建单个自包含 HTML/CSS/JS 文件，无框架、打包器或服务器，双击即可运行。顶部用领域语言写明唯一问题。
-
-实际逻辑放在独立纯模块中，可使用 reducer、状态机、纯函数集或有清晰方法面的模块；逻辑不得引用 DOM。页面只是调用模块的薄外壳。
-
-## 界面
-
-按顺序呈现：
-
-1. 问题与一行说明；
-2. 带字段标签的完整当前状态；
-3. 每个动作一个、始终可用的自由按钮；
-4. 至少 happy、edge、illegal 三个引导演练，每次从已知初始状态开始。
-
-每次操作后重绘完整相关状态，并说明刚发生的变化。标签使用业务语言，不显示 reducer/内部代码术语。
-
-## 边界
-
-默认内存状态；问题明确涉及持久化时才使用标记为 `PROTOTYPE - DELETE` 的临时本地数据。无测试、生产数据库、抽象层或超出问题的错误处理。答案确认后由 I 正式实现；HTML 外壳只保留在临时分支。

package/template/workflows/specdev/P-prototype/prototype-record-template.md

@@ -1,46 +0,0 @@
----
-schema_version: 1
-artifact: prototype-record
-change: <YYYY-MM-DD-topic>
-prototype_id: PROTO-001
-question: <one design question>
-branch: logic
-status: active
-workspace_ref: <portable-locator>
-project_paths: []
-assets: []
-winner: null
-promotion_target: null
-cleanup_status: pending
-updated_at: <ISO-8601>
----
-
-# Prototype PROTO-001: <问题短名>
-
-## Question and Assumption
-
-- **Question:**
-- **Why a prototype is needed:**
-- **Branch selection evidence:**
-- **Assumption when user was unavailable:** none / ...
-
-## Run and Assets
-
-- **Command or URL:**
-- **Branch / commit:**
-- **Workspace locator:**
-- **Project-relative assets:**
-
-## Evaluation
-
-- **Scenarios or variants reviewed:**
-- **Observed feedback:**
-- **Answer:** unresolved / ...
-- **Winner and rejected options:**
-
-## Promotion and Cleanup
-
-- **Promotion target:** none / `<Path>{roots.state}/specdev/changes/{change}/ticket/{ticket-file}.md</Path>`
-- **Main cleanup:** pending / clean
-- **Temporary branch retained:** yes / no / pending authorization
-- **Wayfinder solution comment:** not-applicable / `<Path>{roots.state}/specdev/changes/{change}/investigation/comments/{investigation-id}/NN-solution.md</Path>`

package/template/workflows/specdev/P-prototype/ui-prototype.md

@@ -1,21 +0,0 @@
-# UI Prototype
-
-当问题是页面外观、信息层级或交互布局时使用。
-
-## 选择宿主
-
-优先把变体嵌入现有页面，保留真实页头、侧栏、数据获取、参数和认证，只切换渲染子树。确实没有合理宿主时，才按项目约定创建明显标注 prototype 的临时路由。
-
-## 变体
-
-变体数量读取 `<Path>{roots.state}/specdev/config.json</Path>` 的 `planning.ui_prototype_default_variants` 与 `planning.ui_prototype_max_variants`。每个变体必须在布局、信息层级或主要操作入口上结构不同，不能只换颜色或文案。使用项目现有组件和样式系统，但不要共享会限制结构探索的布局抽象。
-
-## 切换器
-
-使用 `?variant=` 保存并分享选择。浮动底栏提供前一项、当前名称、后一项和循环切换；左右方向键可切换，但 input、textarea 或 contenteditable 聚焦时不截获。切换器必须在 production build 隐藏。
-
-变更操作使用桩；UI 原型不写生产数据。完整相关状态在每个变体中可见。
-
-## 收束
-
-记录赢家、组合选择和理由。I 依据答案正确重写生产实现；落选变体、临时路由和 switcher 从 main 删除，完整集合保留在临时分支作为一手资料。

package/template/workflows/specdev/common/schemas/prototype-record.schema.json

@@ -1,24 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "urn:speculo:specdev:prototype-record:v1",
-  "title": "SpecDev Prototype Record Frontmatter",
-  "type": "object",
-  "required": ["schema_version", "artifact", "change", "prototype_id", "question", "branch", "status", "workspace_ref", "project_paths", "assets", "winner", "promotion_target", "cleanup_status", "updated_at"],
-  "properties": {
-    "schema_version": {"const": 1},
-    "artifact": {"const": "prototype-record"},
-    "change": {"type": "string", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9]+(?:-[a-z0-9]+)*$"},
-    "prototype_id": {"type": "string", "pattern": "^PROTO-[0-9]{3,}$"},
-    "question": {"type": "string", "minLength": 1},
-    "branch": {"enum": ["logic", "ui"]},
-    "status": {"enum": ["active", "answered", "blocked", "discarded"]},
-    "workspace_ref": {"type": "string", "minLength": 1, "pattern": "^(?!/)(?![A-Za-z]:[\\\\/]).+"},
-    "project_paths": {"type": "array", "items": {"type": "string"}, "uniqueItems": true},
-    "assets": {"type": "array", "items": {"type": "string"}, "uniqueItems": true},
-    "winner": {"type": ["string", "null"]},
-    "promotion_target": {"type": ["string", "null"]},
-    "cleanup_status": {"enum": ["pending", "clean", "registered"]},
-    "updated_at": {"type": "string", "minLength": 1}
-  },
-  "additionalProperties": true
-}