Skip to content
Merged
4 changes: 2 additions & 2 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -5,14 +5,14 @@
},
"metadata": {
"description": "Thinloop skills and continuity hooks for Issue-backed discovery, read-only project-status navigation, multi-Issue project DAG decomposition and execution, evidence-backed reengineering and delivery, and approved skill evolution.",
"version": "0.18.2"
"version": "0.19.0"
},
"plugins": [
{
"name": "thinloop",
"source": ".",
"description": "Discovery, Web UIUX, architecture, Next project-status navigation, Project DAG decomposition, Execute READY-wave orchestration, Reengineering gates, QuickDev delivery, maintenance, knowledge, and evolution skills with continuity checks; Project itself remains non-executing.",
"version": "0.18.2"
"version": "0.19.0"
}
]
}
2 changes: 1 addition & 1 deletion .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "thinloop",
"version": "0.18.2",
"version": "0.19.0",
"description": "Simplify complex development with Issue-backed discovery, risk-adaptive Web experience and architecture design, non-executing multi-Issue project decomposition into dependency DAGs, bounded READY-wave execution, read-only project-status navigation, project-scale refactoring and cross-stack reimplementation, autonomous single-Issue PR delivery, evidence-backed maintenance, concise experiential knowledge, and human-approved skill evolution.",
"author": {
"name": "mindcarver"
Expand Down
4 changes: 2 additions & 2 deletions .codebuddy-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -5,14 +5,14 @@
},
"metadata": {
"description": "Thinloop skills and continuity hooks for Issue-backed discovery, read-only project-status navigation, multi-Issue project DAG decomposition and execution, evidence-backed reengineering and delivery, and approved skill evolution.",
"version": "0.18.2"
"version": "0.19.0"
},
"plugins": [
{
"name": "thinloop",
"source": ".",
"description": "Discovery, Web UIUX, architecture, Next project-status navigation, Project DAG decomposition, Execute READY-wave orchestration, Reengineering gates, QuickDev delivery, maintenance, knowledge, and evolution skills with continuity checks; Project itself remains non-executing.",
"version": "0.18.2"
"version": "0.19.0"
}
]
}
2 changes: 1 addition & 1 deletion .codebuddy-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "thinloop",
"version": "0.18.2",
"version": "0.19.0",
"description": "Simplify complex development with Issue-backed discovery, risk-adaptive Web experience and architecture design, non-executing multi-Issue project decomposition into dependency DAGs, bounded READY-wave execution, read-only project-status navigation, project-scale refactoring and cross-stack reimplementation, autonomous single-Issue PR delivery, evidence-backed maintenance, concise experiential knowledge, and human-approved skill evolution.",
"author": {
"name": "mindcarver"
Expand Down
4 changes: 2 additions & 2 deletions .codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "thinloop",
"version": "0.18.2",
"version": "0.19.0",
"description": "Simplify complex development with Issue-backed discovery, risk-adaptive Web experience and architecture design, non-executing multi-Issue project decomposition into dependency DAGs, bounded READY-wave execution, read-only project-status navigation, project-scale refactoring and cross-stack reimplementation, autonomous single-Issue PR delivery, evidence-backed maintenance, concise experiential knowledge, and human-approved skill evolution.",
"author": {
"name": "mindcarver"
Expand Down Expand Up @@ -46,6 +46,6 @@
"Interactive",
"Write"
],
"defaultPrompt": "Thinloop routing source: config/routing-kernel.json. Use SCD Next for progress, unfinished work, blockers, or what to do next; read live project evidence and recommend the single next action without changing state. Use SCD QuickDev for one clear Issue-backed delivery; merge only after direct evidence and independent acceptance, and stop for explicit approval before high-risk actions. Use SCD Discovery when product outcomes remain open, especially for a new product or interdependent product decisions. Use SCD Project when an approved outcome needs multiple independently verifiable deliveries; create and validate the Initiative, Delivery Issues, and dependency DAG, but it does not run an implementation loop. Use SCD Execute to start, continue, resume, or finish an approved Initiative by selecting the current safe READY wave and launching one isolated QuickDev lane per Issue. Use SCD Reengineering for project-scale refactoring or cross-language, framework, architecture, storage, or runtime replacement; fix source, compatibility, parity, and cutover gates before consuming the approved DAG through a safe READY wave. Add design only when the complexity is real: use SCD UIUX for consequential Web experiences, SCD UI Polish for visual refinement of existing Web pages, and SCD Architecture for domain, system, or shared-interface boundaries. Use SCD Maintenance, SCD Knowledge, SCD Evolve, or SCD Interview only when explicitly requested; ordinary development must not trigger them automatically."
"defaultPrompt": "Thinloop routing source: config/routing-kernel.json. Use SCD Next for progress, unfinished work, blockers, or what to do next; read live project evidence and recommend the single next action without changing state. Use SCD QuickDev for one clear Issue-backed delivery; merge only after direct evidence and independent acceptance, and stop for explicit approval before high-risk actions. Confirm concrete technical choices and the exact Git plan, then obtain implementation authorization before execution; unanswered choices remain pending. Use SCD Discovery when product outcomes remain open, especially for a new product or interdependent product decisions. Use SCD Project when an approved outcome needs multiple independently verifiable deliveries; create and validate the Initiative, Delivery Issues, and dependency DAG, but it does not run an implementation loop. Use SCD Execute to start, continue, resume, or finish an approved Initiative by selecting the current safe READY wave and launching one isolated QuickDev lane per Issue. Use SCD Reengineering for project-scale refactoring or cross-language, framework, architecture, storage, or runtime replacement; fix source, compatibility, parity, and cutover gates before consuming the approved DAG through a safe READY wave. Add design only when the complexity is real: use SCD UIUX for consequential Web experiences, SCD UI Polish for visual refinement of existing Web pages, and SCD Architecture for domain, system, or shared-interface boundaries. Use SCD Maintenance, SCD Knowledge, SCD Evolve, or SCD Interview only when explicitly requested; ordinary development must not trigger them automatically."
}
}
5 changes: 5 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,3 +1,8 @@
work/
.DS_Store
.reasonix/

# Thinloop临时恢复、缓存和日志;长期计划仍纳入Git
.scd/tasks/current.md
.scd/cache/
.scd/logs/
96 changes: 96 additions & 0 deletions .scd/plans/20261108-131215-guided-confirmation/architecture.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,96 @@
---
status: approved
version: 1
created_at: 2026-11-08T13:22:52+08:00
updated_at: 2026-11-08T14:04:38+08:00
recorded_timezone: Asia/Shanghai
plan_approved_at: null
implementation_authorized_at: null
approval_recorded_at: 2026-11-08T14:02:36+08:00
implementation_authorization_recorded_at: 2026-11-08T14:02:36+08:00
approved_git_ref: 4346eceda744b707d09c879b7e623b58adbc7038
---

# 架构计划:确认、计划与执行的职责

## 审阅状态

Q1–Q12及以下D1–D8已由AP-001明确批准,批准对象为Git 4346eceda744b707d09c879b7e623b58adbc7038中的方案。开工已授权;本段只同步批准状态,不修改方案。

## D1:一个共享指令契约

新增 skills/scd-quickdev/references/planning-contract.md,集中维护访谈、计划文件、时间、批准关联、执行前清单和变更处理。复用现有十三技能,不新增技能、配置模式、运行时脚本、数据库、依赖或Hook。

Discovery、QuickDev、Architecture、UIUX、Project、Execute、Reengineering、UI Polish和Maintenance修复模式直接引用共享契约。Next只读检查计划与批准状态,不创建计划、不批准工作。Knowledge、Interview和Evolve保留各自显式调用及更窄写入边界;Evolve交给QuickDev的开发工作也遵守计划确认,且保留其禁止自行交付的试验边界。

统一按任务行为适用:功能开发、缺陷修复、架构/交互设计、再工程及实际修复需经过确认;纯状态查询、代码阅读和只读诊断不因调用技能而创建计划。

## D2:询问与执行边界

1. 先只读调查,查明事实,再针对当前未决选择分轮提问。
2. 提问写出选择、具体影响、推荐及理由;每轮问题互不依赖。
3. 产品、架构、依赖、数据模型、接口、模块组织、测试策略等具体技术选择都需确认;不能以可逆、惯例或模型自信为由代选。
4. 漏答保持待定,不用临时假设解除依赖;可以继续独立的只读调查,不能实施依赖该答案的部分。
5. 计划已明确的操作是获批执行,不重复询问。开发中出现未覆盖选择时,列出差异和影响,暂停受影响工作并询问。
6. 普通「继续」只延续已批准范围,不能批准尚未展示的方案、计划修订或新的执行范围。
7. 方案批准与开工授权分别记录;同一句明确指向当前版本的「确认本方案并开始实施」可以同时授予两者。
8. 完整计划的统一确认可以覆盖其中逐项展示的具体选择,不要求再逐行重复回答;部分回答只批准被明确选择的部分。

## D3:文件与权威分工

每项任务使用 .scd/plans/YYYYMMDD-HHMMSS-<任务名>/,时间来自创建时实际北京时间;同秒重名时追加短序号,不伪造创建时间。

- plan.md:任务索引、所需文档及版本、状态、基线来源、批准和执行授权关联。
- requirements.md:本次需求、范围、验收定义、待决问题及来源;存在PRD时引用精确版本与需求标识。
- architecture.md:涉及架构时保存备选方案、技术选择、影响与兼容性,不复制系统基线。
- ux.md:涉及需要设计的界面/旅程时保存本次设计增量及视觉产物引用,不复制既有UX基线。
- implementation.md:进入开发前保存具体文件/模块、任务顺序、依赖、验证、交付与风险。
- decisions.md:追加决策、批准、开工、变更和完成事件及来源;不保存整段聊天或无关私密材料。

设计任务没有开工授权时,可以完成已授权的计划草稿;不生成不存在需求的空架构/UX/实施文档。实际开发必须有实施计划。

计划负责本次需求及方案的批准版本;Issue负责执行状态、任务处置、验收证据和交付记录,引用计划文件与Git版本,不独立修改设计。现有PRD负责产品基线,系统架构负责当前系统边界,机器契约负责规范接口;计划记录本次增量。出现冲突先解决并确认,不自行选择一边。

## D4:文档状态与Git批准记录

计划文档使用draft、approved、superseded三种状态及整数version。ready仍只表示工程/语义就绪,不替代用户批准。执行状态继续在Issue记录,不另建执行数据库。

待审阅内容先提交到本地计划分支,展示文件、版本和完整Git SHA。用户批准后,在后续提交追加批准事件,引用此前已存在的提交和精确文件清单,不要求批准记录所在提交引用自身。

批准事件包含:事件ID、类型、适用文件/文档版本、目标Git SHA、用户实际确认依据、发生时间(可核实时)和记录时间。明确开工授权还记录本次任务或Issue范围。没有消息ID时记录简短原文及对话上下文说明,不编造稳定消息链接。

开工前由Agent逐项核对:所需文档齐全、无影响实施的未决选择、当前方案内容对应获批版本、存在明确开工授权、Issue引用一致、适用设计和接口已就绪。追加批准/状态等管理记录不自动改变已批准方案;新增方案内容或无法解释的差异则需重审。Git提交和字段只能证明记录与版本,不能单独证明用户真实批准。

方案变化时:保留旧批准事件,受影响文档递增version并回到draft,展示差异、重新确认后再继续;未变化的决策可以引用复用。提交普通实施代码不会自动使计划批准失效。

## D5:时间与历史

所有新记录使用Asia/Shanghai、精确到秒、ISO-8601的+08:00。文件包含created_at、updated_at、version、status;索引包含批准和开工记录的引用。

事件区分occurred_at与recorded_at。Agent执行的创建、开工、完成等事件读取实际时钟记录;用户消息有可靠原始时间时记录该时间,没有时occurred_at为空并说明原因,recorded_at记录实际收到并落盘确认的时间。不得回填假时间、提前写完成时间或把提交时间等同用户确认时间。

每轮已经确认的决定保存并提交到本地计划分支;未回答的问题仍为待定。Git历史保留草稿和确认版本,不生成versions/vN复制目录。

## D6:Git保存边界与恢复

长期计划、需求、架构、UX、决策和证据摘要纳入Git。计划中明确使用的临时位置为:.scd/tasks/current.md、.scd/cache/、.scd/logs/;仅对这些位置增加窄范围忽略规则,不忽略整个.scd,也不排除长期演进历史。

已有受跟踪文件不会因新增忽略规则自动取消跟踪;不执行批量删除或批量git rm --cached。消费者仓库存在更宽忽略规则或不明临时位置时,先检查并展示必要调整,取得确认后处理。

current.md只用于恢复,引用持久计划和Issue;修改其生命周期说明中「不得增加忽略规则」的旧要求,但不改变连续性Hook实现、事件或模板必需字段。清理临时状态前必须把有价值的决策和证据写回持久记录。

恢复旧任务时保留现有基线/Issue/提交证据;缺少计划或批准关联时,整理当前真实方案供用户确认后才恢复受影响开发,不补造历史批准,不批量迁移旧文档。

## D7:仅指令检查的能力边界

不新增计划校验器、Schema运行时验证、强制拦截或宿主Hook。开工前检查与合并前审计是技能指令和清单;独立验收复核实际确认依据与版本。

现有回归测试用于检测技能文本契约退化和跨入口矛盾,独立场景验收观察模型是否遵守。两者均不能保证所有宿主/模型每次遵从,也不构成新的运行时权限控制。

## D8:交付与兼容

按一个完整、可独立验收的中文Delivery Issue交付本次规则改造,避免分批发布相互矛盾的默认规则。当前计划分支在获批后可作为该Issue交付分支继续使用,保留草稿历史。

候选版本为0.19.0,统一各插件清单、README和安装说明。更新routing-kernel源后通过现有同步脚本生成AGENTS、README、workflow文档和Codex提示词中的路由片段。

现有生产/高风险门、独立验收、真实页面验收和各治理技能的更窄权限继续适用。普通交付完成后按仓库约定同步已安装客户端,保留MANUAL/UNVERIFIED事实和实际用户验收边界。
57 changes: 57 additions & 0 deletions .scd/plans/20261108-131215-guided-confirmation/decisions.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
---
status: approved
created_at: 2026-11-08T13:16:03+08:00
updated_at: 2026-11-08T14:10:38+08:00
recorded_timezone: Asia/Shanghai
plan_approved_at: null
implementation_authorized_at: null
approval_recorded_at: 2026-11-08T14:02:36+08:00
implementation_authorization_recorded_at: 2026-11-08T14:02:36+08:00
approved_git_ref: 4346eceda744b707d09c879b7e623b58adbc7038
---

# 用户决策与记录

下表为逐轮决策记录;完整架构和开发计划已由后续AP-001批准并授权开工,具体依据见该事件。

| 决策 | 用户选择 | 已确认含义 | 记录时间 |
|---|---|---|---|
| Q1 | B | 具体技术选择也逐项询问,确认后才推进;不以 Agent 的推荐代替用户决定。 | 2026-11-08T13:12:15+08:00 |
| Q2 | A | 每项任务保留草稿、确认版本、决策摘要和变更记录,并关联 Issue/PR。 | 2026-11-08T13:12:15+08:00 |
| Q3 | A | 明确批准开工后,按批准计划连续开发、验证、独立验收和普通合并;新决策或实质变化重新询问。 | 2026-11-08T13:12:15+08:00 |
| Q4 | A | 成为 Thinloop 全项目默认行为,而非个人可选模式。 | 2026-11-08T13:12:15+08:00 |
| Q5 | B,补充 .scd 要放到 git 管理里去 | 使用 .scd/plans/<创建时间>-<任务名>/,计划材料纳入 Git 管理。 | 2026-11-08T13:12:15+08:00 |
| Q6 | A | 计划文件负责设计、实施方案和批准版本;Issue 跟踪执行与验收并引用对应计划。 | 2026-11-08T13:12:15+08:00 |
| Q7 | B | 长期计划、架构、需求、决策和历史版本进入 Git;临时恢复文件、缓存和运行日志排除,明确列出例外,不忽略整个 .scd。 | 2026-11-08T13:16:03+08:00 |
| Q8 | B | 按任务需要分别保存需求、架构计划、开发计划和决策记录,用索引关联;不创建不适用的空文档。 | 2026-11-08T13:16:03+08:00 |
| Q9 | A | 北京时间精确到秒,包含 +08:00;分别记录创建、修订、决策确认、计划批准、开工和完成,关联版本;未知历史事件时间不以补录时间冒充。 | 2026-11-08T13:16:03+08:00 |
| Q10 | B | 只更新技能规则与检查清单,不增加运行时校验代码或新增宿主Hook。 | 2026-11-08T13:22:52+08:00 |
| Q11 | A | 批准记录关联具体计划文件及其Git提交,通过Git历史还原确认版本,不额外复制版本目录。 | 2026-11-08T13:22:52+08:00 |
| Q12 | A | 保留现有PRD、系统架构和接口契约位置;任务计划引用对应版本、说明本次增量,实施验收后更新系统基线。 | 2026-11-08T13:22:52+08:00 |

确认依据:当前对话用户原文「1B 2A 3A」和「4A 5B ,但是.scd 要放到git 管理里去 6A」。新增确认依据:当前对话用户原文「7B 8B 9A」。上表时间为各轮落盘记录时间;原消息未提供精确到秒的发生时间,不能把记录时间冒充历史确认时间。


- 2026-11-08T13:22:52+08:00:新增用户原文「10B 11A 12A」对应的Q10–Q12确认记录;完整架构与开发方案尚待批准。

## AP-001:完整方案批准及开工授权

- 用户依据:在展示完整方案并询问是否批准并开工后,用户回复「批准 让 6.1 sol 模型子智能体去实施」。
- 目标Git提交:4346eceda744b707d09c879b7e623b58adbc7038。
- 批准文件:plan.md、requirements.md、architecture.md、implementation.md、decisions.md(以上目标提交中的版本)。
- 批准范围:架构D1–D8、开发T1–T5及A1–A6验收;按方案完成普通交付。
- 实施模型:用户明确指定GPT-6.1 Sol子智能体。
- occurred_at:未知(原用户消息未暴露精确到秒时间)。
- recorded_at:2026-11-08T14:02:36+08:00。元数据中的事件发生时间为空不代表未批准,以本条实际用户依据及记录时间为准。
- 本记录是追加的批准事实,不改变此前已批准的方案内容;原草稿状态和审阅措辞可通过目标Git提交还原。

## EX-001:指定模型提交实施候选

- 类型:implementation-submitted。
- 实施者:/root/implement_116_sol;模型:gpt-6.1-sol(用户指定)。
- 目标Git SHA:bfc23e61a32b68d677a1f5fcee8b9e1ecd4a0381。
- occurred_at:2026-11-08T14:09:53+08:00(Git提交时间,只表示提交事件,不代表用户批准或整项交付完成)。
- recorded_at:2026-11-08T14:10:38+08:00。
- 关联:AP-001、Issue #116。
- 状态:T1–T3实施候选已提交;T4工程结果由实施者报告,最终独立验收与远端CI待完成;T5由父Agent继续。
- 证据日志:/tmp/thinloop116-tests-final2.log、/tmp/thinloop116-gates.log、/tmp/thinloop116-last-targeted.log;持久交付证据记录到Issue/PR。
Loading
Loading