@namewta/speculo 0.2.1 → 0.2.2

package/template/workflows/matt-pocock/routes/productivity.md

@@ -5,17 +5,17 @@
 ```xml
 <routes>
   <route id="handoff" order="1">
-    <skill root="vendor:matt-pocock" path="productivity/handoff/SKILL.md" activation="adapted" />
+    <instructions root="workflow" path="atomic-skills/handoff.md" activation="adapted" />
     <artifact root="change" path="handoffs/{topic}.md" />
     <when>需要跨会话或分叉上下文。</when>
   </route>
   <route id="teach" order="2">
-    <skill root="vendor:matt-pocock" path="productivity/teach/SKILL.md" activation="adapted" />
+    <instructions root="workflow" path="atomic-skills/teach.md" activation="adapted" />
     <artifact root="change" path="teaching/" />
     <when>用户要跨会话学习主题。</when>
   </route>
   <route id="writing-great-skills" order="3">
-    <skill root="vendor:matt-pocock" path="productivity/writing-great-skills/SKILL.md" activation="required" />
+    <instructions root="workflow" path="atomic-skills/writing-great-skills.md" activation="required" />
     <artifact root="change" path="skill-authoring/report.md" />
     <when>用户要设计或审查 skill。</when>
   </route>

package/template/workflows/matt-pocock/routes/research-prototype.md

@@ -6,13 +6,13 @@
 <sequence>
   <phase id="research" order="1">
     <when>答案需要当前仓库之外的一手来源。</when>
-    <skill root="vendor:matt-pocock" path="engineering/research/SKILL.md" activation="conditional" />
+    <instructions root="workflow" path="atomic-skills/research.md" activation="conditional" />
     <artifact root="change" path="research/{topic}.md" />
     <completion>每项结论有一手来源，文件留在当前 change。</completion>
   </phase>
   <phase id="prototype" order="2">
     <when>状态、逻辑或 UI 需要可运行答案。</when>
-    <skill root="vendor:matt-pocock" path="engineering/prototype/SKILL.md" activation="conditional" />
+    <instructions root="workflow" path="atomic-skills/prototype.md" activation="conditional" />
     <artifact root="change" path="prototypes/{topic}/answer.md" />
     <completion>答案已保留；一次性代码、数据库和路由已删除或明确吸收进实现。</completion>
   </phase>

package/template/workflows/matt-pocock/routes/review.md

@@ -5,7 +5,7 @@
 ```xml
 <sequence>
   <phase id="fixed-point" order="1">
-    <skill root="vendor:matt-pocock" path="engineering/code-review/SKILL.md" activation="required" />
+    <instructions root="workflow" path="atomic-skills/code-review.md" activation="required" />
     <completion>固定点可解析、diff 非空、规范与标准来源已记录。</completion>
   </phase>
   <phase id="parallel-axes" order="2">

package/template/workflows/matt-pocock/routes/setup.md

@@ -7,7 +7,7 @@
 ```xml
 <sequence>
   <phase id="discover-config" order="1">
-    <skill root="vendor:matt-pocock" path="engineering/setup-matt-pocock-skills/SKILL.md" activation="adapted" />
+    <instructions root="workflow" path="atomic-skills/setup-matt-pocock-skills.md" activation="adapted" />
     <completion>已展示仓库、tracker 和领域文档现状。</completion>
   </phase>
   <phase id="configure-tracker" order="2">

package/template/workflows/matt-pocock/routes/triage.md

@@ -5,7 +5,7 @@
 ```xml
 <sequence>
   <phase id="collect" order="1">
-    <skill root="vendor:matt-pocock" path="engineering/triage/SKILL.md" activation="adapted" />
+    <instructions root="workflow" path="atomic-skills/triage.md" activation="adapted" />
     <artifact root="change" path="triage/{item}/record.md" />
     <completion>完整正文、评论、标签、diff、冗余性与私有 out-of-scope 已检查。</completion>
   </phase>
@@ -14,8 +14,8 @@
   </phase>
   <phase id="validate-grill" order="3">
     <when>声明需要复现或需求仍不完整。</when>
-    <skill root="vendor:matt-pocock" path="productivity/grilling/SKILL.md" activation="conditional" />
-    <skill root="vendor:matt-pocock" path="engineering/domain-modeling/SKILL.md" activation="conditional" />
+    <instructions root="workflow" path="atomic-skills/grilling.md" activation="conditional" />
+    <instructions root="workflow" path="atomic-skills/domain-modeling.md" activation="conditional" />
     <completion>事实已验证，问题逐个解决。</completion>
   </phase>
   <phase id="apply" order="4">

package/template/workflows/matt-pocock/routes/wayfinder.md

@@ -5,9 +5,9 @@
 ```xml
 <sequence>
   <phase id="name-destination" order="1">
-    <skill root="vendor:matt-pocock" path="engineering/wayfinder/SKILL.md" activation="required" />
-    <skill root="vendor:matt-pocock" path="productivity/grilling/SKILL.md" activation="required" />
-    <skill root="vendor:matt-pocock" path="engineering/domain-modeling/SKILL.md" activation="required" />
+    <instructions root="workflow" path="atomic-skills/wayfinder.md" activation="required" />
+    <instructions root="workflow" path="atomic-skills/grilling.md" activation="required" />
+    <instructions root="workflow" path="atomic-skills/domain-modeling.md" activation="required" />
     <completion>目的地与范围边界已确认。</completion>
   </phase>
   <phase id="map-frontier" order="2">

package/template/workflows/person/PERSISTENCE.md

@@ -0,0 +1,56 @@
+# Person Persistence
+
+本文件是 `person` 的唯一运行契约。`WORKFLOW.md` 只能引用本文件，不得复制 runtime roots、store、change 启动或副作用规则。进入 person workflow 时先读取项目根 `speculo/.speculo/workspace.json`，再执行本文件。
+
+## 运行时根
+
+```xml
+<runtime-context>
+  <root id="workflow" base="workflows" path="person" />
+  <root id="state" base="state" path="person" />
+</runtime-context>
+```
+
+## 持久化命名空间
+
+```xml
+<persistence root="state">
+  <store id="index" role="index" kind="file" path="status.json" create="initialize" />
+  <store id="changes" role="active" kind="directory" path="changes" create="initialize" />
+  <store id="archive" role="archive" kind="directory" path="archive" create="initialize" />
+  <store id="knowledge" role="knowledge" kind="directory" path=".config" create="initialize" consumers="docs-sync,retro,knowledge-prune" />
+</persistence>
+```
+
+## 启动协议
+
+```xml
+<sequence>
+  <phase id="resolve-runtime" order="1">
+    <skill root="skills" path="runtime-context/SKILL.md" activation="required" />
+    <completion>workspace、config 与 workflow/state roots 均已解析并通过边界检查；同一运行已解析时复用结果。</completion>
+  </phase>
+  <phase id="select-change" order="2">
+    <artifact root="state" path="status.json" />
+    <completion>已选择用户指定或唯一 active change；没有 active change 时原子创建 `changes/YYYY-MM-DD-&lt;kebab-topic&gt;/.status.json` 并更新索引；多个候选时先消歧。</completion>
+  </phase>
+</sequence>
+```
+
+创建 change 时初始化 schema version 1、workflow/name/timestamps、`change_status: active`、空的 `route_history`。已有 change 缺少数组时按空数组读取，在下一次真实更新时补齐，不要求迁移。
+
+## 状态字段
+
+```xml
+<state-schema>
+  <field name="current_route" type="string|null" />
+  <field name="route_history" type="array" />
+</state-schema>
+```
+
+## 路径与副作用
+
+- route 产物只写当前 change；已声明 knowledge store 只接收 workflow 确认的长期内容。
+- 用户要求的项目产物不是 Speculo 运行状态；保存项目相对指针，不把派生绝对路径写入状态。
+- 发布、提交、移动或删除外部/项目资源前展示动作并取得明确确认。
+

package/template/workflows/person/WORKFLOW.md

@@ -3,32 +3,23 @@ id: person
 type: workflow
 workflow: person
 name: Person Workflow
-description: 以人物方法论为底座的显式激活型咨询 workflow
+description: 以人物方法论为底座并共享独立持久化契约的咨询 workflow
 keywords: [person, methodology, consulting, 人物, 方法论]
 ---
 
 # Person Workflow
 
-先读取项目根 `speculo/.speculo/workspace.json`，再解析以下 workflow/state 根。进入时读取 `status.json`，选择唯一 active change；没有 active change 时原子创建 `changes/<YYYY-MM-DD-name>/.status.json` 并追加索引。
+先读取 [PERSISTENCE.md](./PERSISTENCE.md)。该文件是 runtime roots、store、change 启动和副作用边界的唯一来源；本入口只负责选择人物方法论 route。
 
-## 运行时根
+## 进入协议
 
 ```xml
-<runtime-context>
-  <root id="workflow" base="workflows" path="person" />
-  <root id="state" base="state" path="person" />
-</runtime-context>
-```
-
-## 持久化命名空间
-
-```xml
-<persistence root="state">
-  <store id="index" role="index" kind="file" path="status.json" create="initialize" />
-  <store id="changes" role="active" kind="directory" path="changes" create="initialize" />
-  <store id="archive" role="archive" kind="directory" path="archive" create="initialize" />
-  <store id="knowledge" role="knowledge" kind="directory" path=".config" create="initialize" consumers="docs-sync,retro,knowledge-prune" />
-</persistence>
+<sequence>
+  <phase id="load-persistence" order="1">
+    <instructions root="workflow" path="PERSISTENCE.md" activation="required" />
+    <completion>runtime context 与 current change 已按唯一持久化契约解析。</completion>
+  </phase>
+</sequence>
 ```
 
 ## 路由
@@ -47,15 +38,6 @@ keywords: [person, methodology, consulting, 人物, 方法论]
 <dependencies />
 ```
 
-## 状态扩展字段
-
-```xml
-<state-schema>
-  <field name="current_route" type="string" />
-  <field name="route_history" type="array" />
-</state-schema>
-```
-
 ## 状态转移
 
 ```xml