docs(blog): explain LoopX development practices across its evolution

[huangruiteng]

The Agentic Software essay describes foundations for sustained autonomous development but gives readers little evidence of how LoopX applies them. Add paired Chinese and English practice sections grounded in the project's broader development, from its June Meta Goal and repository self-iteration to capability composition, typed control-plane migration, collaboration and long-horizon evaluation.

The addition covers:

• Using LoopX to develop LoopX, with human feedback connecting design, implementation and acceptance. Link the primary June 1 Meta Goal and public self-iteration case, with the existing RSI essay owning the detailed history.
• Atomic CLIs and thin skills around capability/provider/Kernel ownership, illustrated by Explore and version-specific PR review.
• Continuous maintainability through complete transaction cutovers and retirement of duplicated Python/TypeScript rules. The broader migration remains unfinished.
• Review and publication boundaries, plus the bounded three-agent artifact-adoption, correction and independent-verification demo. Its controller-driven, same-host scope is explicit.
• Executable self-constraints for actual CLI output, semantic vocabulary ownership, maintainability debt, and bounded state-composition recovery. A four-row comparison names each mechanism and its evidence limits, with linked negative tests.
• Layered evaluation and the five-arm, 46-task LHTB comparison. Report both mean reward and equal strict solve counts against Plain, with single effective trials, replacements and unequal budgets disclosed.
• The current local/cloud boundary, with full two-host/cloud-worker qualification still open.

Include the repository's existing synthetic Goal-workspace screenshot, labeled as presentation data. Sources are commit-pinned; the screenshot is byte-identical to its existing public source. This is an editorial addition, with no runtime or authority behavior change.

Validation:

• npm run build --prefix apps/presentation/site

• npm run smoke:seo --prefix apps/presentation/site

• node examples/blog-bilingual-index-smoke.mjs — 7 paired articles

• git diff --check

• Desktop (1280×900) and narrow-screen (390×844) browser inspection of both editions: six figures and no page-level horizontal overflow.

• Verified new commit-pinned source targets/fragments and checked added text for public safety. No private Goal state, company conversations, local paths or credentials introduced.

• Focused existing counterexample tests: 6 parameterized cases passed for semantic removal despite output shrinkage, scan-scope/twin-budget bypass, and reviewed debt growth.

Local checks passed. Maintainer review and repository CI remain separate; no new model calls or benchmark reruns were performed for this editorial change.

[loopx-agent]

Reviewer: model_agent; gpt-6.1-sol; OpenAI; runtime_reported; reasoning_effort=xhigh.

Exact head: 770d2b5.

动机

阅读 Agentic Software 文章的开发者需要知道 LoopX 如何把长程研发原则落到具体交付和验收。原文讲三个基础，却缺少 LoopX 自身实践的具体证据；当前双语新增六组实践、固定版本资料和一张明确标为合成的工作区图，读者可以追溯机制，同时看到未验证的边界。实际构建页面从五图变为六图，双语六组新增段落可读、来源目标和片段可核对，图在桌面与手机可查看；首屏截图 PNG 与不可变基线完全相同。交付是公开说明与阅读路径，不是安装现场、业务结果、模型理解、token 收益、跨云部署或父路线图的资格证明。 这项改动的价值是让读者从“有这些原则”走到“可以核对这些具体实践”，同时看到资格限制。不能把多写六段、复用图或文章上线算成长程系统已经成功。

改动思路

复用现有文章结构、共享图框和公开合成素材，固定版本引用承担证据链接；不增加运行时、权限服务、组件或配置。完整边界是两份静态 HTML 各25行和一张既有公开图的副本；源码、页面呈现、运行中系统和独立资格的层次仍分开。 当前目标是已有文章中的实践说明，六组主题共享一条验收链：用户反馈、CLI 与 skill、类型归属、评审发布、评价分层和云端范围。用现有文章和图框比另造页面或组件更容易理解和维护；相关 future-facing pass 已核对，没有重复权限 owner 或值得顺带抽象的运行时机制。

规范依据为 docs/development/design.md，固定 revision f713e0f。逐项核对原文标题 Earn The User's Attention、Source Of Truth、Accessibility、UI Reproduction Workflow：新增内容有具体信息价值，保持现有结构与公开边界，保留语义 HTML/键盘/双语阅读，并实际检查桌面与窄屏。没有改规范来适配候选输出，也没有把作者声明当作浏览器证据。

具体改动

完整差异三条路径：两份既有 EN/中文 HTML 各 +25 行，一张 211,904 bytes 的 PNG。没有新增 CSS、脚本、导航、运行时或配置。英文前 21,392 字符、中文前 11,641 字符与不可变基线 prefix 一致，首屏实际截图 PNG 也逐字节相同；这一中段添加没有触发新的首屏改变。

关键代码讲解

• English practice groups L82 与中文对应段落给六组实践附固定来源，解释当前 interaction_contract、薄 skill、独立判断和发布权限。文章是面向人的说明，没有安装为新 agent 指令或修改机器义务。
• 双语 figure L85 复用 focusable architecture-viewport、alt、ARIA label、原图 anchor 与 caption。1440×1000 图与基线公开 overview-desktop.png 完全相同（SHA-256 834966703b11cbd4fbe855a6ffd00ee74f83bb7947d95afb1e80ba5761178128）；PNG 没有文本 metadata。实际图和上下文明确写着合成展示，数字不是业务现场或效果实验。
• Measurement / local-cloud clauses L89–105 保留范围：36 Todo/12 run 的 48,418 → 39,726 是字符测量、解码值相同，不是 token 或模型收益；R6 仍需真实两个 host、云 worker 与权限/故障负例，不由一个可独立写的克隆数据库证明。

七处新增 immutable blob 目标和所有 fragment 已逐项核对。测量表位于固定版本 interface-budget contract，R6 的真实-host exit 和单一 authority 过渡限定也在原 roadmap；#6375/#6311 已读主来源并确认合并，前者保留未分类/过期/非法分类失败且导出不授分类，后者保留完整归档成员/selected source 证明与 16 MiB 边界。正文解释这些源码变化，没有重新认证其完整安装、模型或研究结果。

对主干的风险

最强反例是“SEO 都绿，但图打不开、窄屏挤出整页，或文案把演示数据和源代码夸为实测能力”。当前独立证据覆盖阅读与声明两部分：正常 site build（含 TS noEmit）、SEO 的 20 canonical targets 和 7 paired articles smoke 全部通过；advisory 先执行，风险 canary 为 3 direct / 3 selected / 3 executed / 0 failures / 0 manual holds。

真实 Ego 浏览器检查两语言 × 1280×900 / 390×844。六图与新增段落实际存在，桌面整页宽1280、手机390；手机图框宽348、内容960，滚动留在图框。实际键盘 ArrowRight 在 focusable region 内移动，Enter 打开1440×1000原图，关闭自有 popup 后回到同一文章。初次按键后的立即采样仍为0，随后等待实际滚动状态再验证，没有把尚未完成的动画当成产品失败或用强写 scrollLeft 冒充键盘行为。

另临时删除仅自有 ignored build 中的新图，真实 HTTP 返回404；恢复完全相同 bytes 后返回200，浏览器真实 reload 重新加载原图。source asset、活跃 Goal 和用户浏览器 profile 都没有修改。基线呈现使用真正的不可变 B HTML 配合字节未变的公开 assets，明确不是一次完整 baseline build。可选 PIL pixel probe 缺库，未安装依赖；首屏 PNG 文件本身完全相同，已足以证明这张截图的同一性。

没有查询、轮询或等待 GitHub CI，没有跑完整仓库、真实模型或云端。静态内容没有 default-off、state classifier、权限名称或协议 owner 的变化；引用的规则没有把强制条件说成可忽略建议。文章中的解释不能授予新执行权限，合成截图也不能进入真实运行状态判断。阅读结果已实际回读，理解改善和长期净效仍未实验资格化。

我的整体评价

APPROVE，没有阻塞发现，仅绑定 770d2b5。这项公开说明 goal_achieved：提供可核对的实践与边界，保留现有阅读入口，双语/图/键盘与恢复路径可用。user_experience improved；运行时 long_horizon 不适用，因为未改变执行或持久状态。部署、完整能力采用、R6 与模型净效仍独立；本评审和通过的检查不授予合并或发布权限。

English verdict: APPROVE — 770d2b5. Both article editions add six source-backed practice themes and an explicitly synthetic public image without changing chrome, runtime or authority. The built desktop/mobile pages, keyboard image navigation, missing-asset recovery, seven fixed-source targets/fragments, SEO/bilingual smoke and all selected canary checks pass. The actual first-screen PNG is byte-identical to the immutable baseline rendering. Character measurements, source behavior and open local/cloud qualification are scoped accurately; no model, installed adoption or merge authority is claimed.

[loopx-agent]

Reviewer: model_agent · gpt-6.1-sol · OpenAI · runtime_reported · reasoning_effort=xhigh

动机

阅读 Agentic Software 的开发者需要沿公开来源理解 LoopX 从早期自迭代到能力、事务迁移、协作和研究的实践。 770d 只举近期局部修改；当前 head 改为贯穿研发阶段的六组实践，连接历史材料、协作演示和五臂研究，并明确展示、源码、试验和未完成资格各自的范围。 当前正常构建的双语页面显示更新后的实践和来源，四个桌面/窄屏视图无整页横向溢出；15个固定来源及片段通过，公开46任务数据重算与正文的两均值/两个7/46一致。 交付仅为有来源和限制的公开说明；不重跑历史模型/benchmark，不认证无人值守调度、迁移完成、模型因果收益或完整R6，不授合并发布权限。

本结论仅绑定 db7a595，基线 f713e0f。此前770d的评审已被外部操作 DISMISSED；旧 head 的就绪结果不适用于本次。既读770d→当前的修改，也重新检查完整 base→当前3路径；没有继承旧批准。

改动思路

复用现有双语文章、ARIA图框和公开合成图；fixed-source引用解释实践，不增加运行时、组件、权限服务或第二决策owner。 完整3路径为两份HTML各26新增行及既有公开图的副本；新段落全读、旧review作废，仅不变图框/原图/键盘与404恢复证据按source invalidation复用。

规范仍为 docs/development/design.md，固定 revision f713e0f。按已有标题 Earn The User's Attention、Source Of Truth、Accessibility、UI Reproduction Workflow 检查新增信息价值、源事实/展示边界、语义图框/双语可读性和实际桌面/窄屏。规范没有为本候选改写。现有图框足够，有界 future-facing pass 未发现需要增加组件、服务或重复权威的理由。首屏前缀、导航、样式和图框未变，未触发新的首屏改动批准门槛。

具体改动

完整 PR 为两份既有 EN/中文 HTML 各 +26 行，加一张 211,904 bytes、1440×1000 PNG。770d→当前只改文章段落/来源，图、图框、ARIA、caption与样式保持；原图 SHA-256 仍为 834966703b11cbd4fbe855a6ffd00ee74f83bb7947d95afb1e80ba5761178128。

关键符号是英文 L82 起的六组 h3/p 与中文 L86 的 architecture-viewport / figure：前者解释实践与限制，后者复用可聚焦、可横向滚动及原图 anchor。没有新脚本、配置、worker 或权限操作。

六组内容全部核对：

• 六月 Meta Goal 的固定公开 source 保留可运行性、接续和验证意图；6月自迭代案例给研发线与公开历史。正文不把提交数当能力收益，历史材料不被本评审重新认证为模型因果实验。
• Capability → Provider 与 Kernel 分工、可选 Explore 和精确版本 PR Review 复用既有边界；Explore 规划建议不启动 worker、不加预算。
• August 2026 的渐进 TS 迁移来源日期/架构与完整事务、删除旧规则的原则对应；Python保留必要适配，整项迁移明确未完成。
• 三 Agent demo 的 source/独立 oracle 规定两个输入版本与精确期望，controller负责阶段及输入，产物采用/纠偏/返回为同主机同Goal范围；正文没有把它说成无人值守调度或完整跨host协作。
• 五臂 LHTB 的公开46任务数据独立重算：Plain mean 0.4217604153755719，1.0.3 Heartbeat 0.494832860222451，reward>=0.95 均 7/46，与四位小数文案一致。单次有效 trial、replacement、预算差异仍写在双语正文中；没有把均值提高说成更多严格完成、等预算效率或独立机制因果。
• R6 保留单一authority/混合执行前置边界与至少两个真实host、云worker和权限/故障负例；完整资格仍未完成。

新增 15 个固定blob目标及所有片段已验证，两个语言专用Explore/TS链接也分别核对；相对 RSI 链接在实际浏览器返回200。这里验证公开材料和已发布aggregate的一致性，不重新建立实验评分、integrity或历史运行资格。

对主干的风险

当前 normal site build（含 TS noEmit）、SEO 20 canonical targets、7 paired articles smoke 通过；advisory先执行，当前 canary 3 direct /3 selected /3 executed /0 failures /0 holds。没有删断言、改预算或缩扫描。

真实 Ego TaskSpace62 检查双语 × 1280×900 /390×844：当前六图、研究数字和新段落实际可读，图1440×1000加载；整页宽分别1280/390，手机图框348、内容960，横滚留在图框。桌面英文与中文手机截图已目检。当前源码与B的插入前prefix及原有chrome/样式相同；本轮没有声称重新做了首屏PNG的逐字节比较。

770d上的真实键盘横滚、Enter原图/返回和移除自有built asset→404→同bytes200→reload只复用到未变的原图/markup/style/请求路径，已列source失效检查；它们不证明当前新增文案或来源。当前正文、数据重算、四视图、build/SEO/canary都是新证据。一个自有静态服务器在快速导航取消旧lazy资源时记录BrokenPipe，已保留为client-abort诊断；当前新图、正文及RSI检查通过。浏览器TaskSpace已finish，自己的预览服务器已停止。

无CI查询/等待，无模型或benchmark重跑，无安装/云端/全平台/实验integrity资格宣称。图明确是合成展示；源码、公开报告、运行采用和因果收益仍分开。公开文本不带私有Goal、路径、凭据或日志。

我的整体评价

APPROVE，无阻塞发现，仅绑定 db7a595。当前公开说明的 goal_achieved 是可核对且可读的实践说明，不是父路线图、迁移、协作或研究资格关闭。阅读体验得到可检查改善，未修改运行时long_horizon，所以该维度不适用；没有实验性理解/净效结论。架构保留现有article/design，完整边界是paired prose/公开image/source readback，符合有界、可逆交付。本评审不授予合并或发布权限。

English verdict: APPROVE — db7a595. The full three-path editorial proposal and770d-to-current rewrite were independently reviewed. Fifteen pinned source targets/fragments and the public46-task arithmetic support the scoped history, migration, collaboration and study claims; mean rewards0.4948/.4218 coexist with7/46 strict solves and trial/budget limits. Current normal build, SEO, bilingual smoke, four real desktop/mobile views and all3 selected canaries pass. Historical image keyboard/404 evidence is reused only after unchanged-source invalidation; old approval is retired. No runtime, installed adoption, experiment-integrity, causal utility or merge authority is claimed.

[loopx-agent]

Reviewer: model_agent | gpt-6.1-sol | OpenAI | runtime_reported | reasoning_effort=xhigh

Exact head: 33c4960451a8616f06b295663518d3b7edea99eb；完整审阅 3 个路径（双语各 +29 行及一张图片）、3 个 DCO commit。两条 DISMISSED 旧 review 的 head 均不同，本次未继承其结论。

动机

阅读 LoopX 长程自主研发文章、想知道工程约束如何落地的中英文读者。旧文章主要解释原则，读者需要自行拼接研发流程和验证边界；新段落在原文章里列出实际做法、可打开的源码与反例，并逐项说明不能据此推出什么。正常构建的双语页面通过 HTTP 比较，新增内容可达；390px 的表格可用键盘横移读完证据边界，页面宽度仍为 390px，合成截图可打开原图。这是公开文章补充，不是新运行能力，不新增 benchmark 实验，也不证明模型理解或完整跨宿主恢复。

改动思路

继续复用文章既有 development 段落、滚动表格和 figure，补齐“做什么、看什么证据、哪些仍未证明”三者，比另建一套页面或组件更合适。六组实践连接早期自举、CLI/Capability/Provider/Kernel 分工、完整事务迁移、独立评审、分层评价和 local/cloud；四行护栏把机器检查与仍需人和模型判断的部分并列，避免用测试数量替代成果。没有新增配置开关、自动执行或权限。全文较长是这里的主要取舍，但内容集中在已有章节，原目录和开场保持，读者无需重填信息或通过新增确认步骤。

具体改动

关键代码讲解

• 实践段落 的六月 Meta Goal 引用固定 9bc8c22ca31f22782f4d3f6a6187155156abafd2；其余新增实现/RFC 引用固定 f713e0f07c571a78a7c4405ab647ba41dbc492ba。已按当前源文核对 Capability→Provider/Kernel、完整事务迁移与未完成边界，以及受 controller 安排的同宿主三 Agent 示例，未把它写成无人调度或完整跨机证明。
• 合成工作区 figure 的 PNG 与既有公开 donor 完全相同：211904 字节、1440×1000、SHA256 834966703b11cbd4fbe855a6ffd00ee74f83bb7947d95afb1e80ba5761178128。说明明确区分任务数、Goal 验收与人的决定；真实浏览器打开原图成功。
• 护栏表 逐行列出实际 stdout/语义检查、词表 drift、AST 可维护性与 Turn 恢复，并各给证明范围。region/tabindex、caption、列/行表头及窄屏横移均存在；中文镜像表达同一限制。
• LHTB 与 cloud 限制 保留一次有效 trial、替换试验、预算不等及 R6 未完成。独立从公开 46 行数据重算 Plain 0.4217604154、Heartbeat 0.4948328602，严格成功均 7/46，与文中四舍五入一致；没有重跑或验证整套轨迹/因果归因。

规格依据 AGENTS.md，修订 f713e0f07c571a78a7c4405ab647ba41dbc492ba：Public And Private Boundary 已实现（公开合成 donor、无私人运行材料）；First-Screen Review Gate 不适用（两语开场至 development 的前缀和共享 CSS 完全相同）；UI Design Standard 已实现于当前静态文章的可读、键盘和回读范围。

对主干的风险

主要风险是好看的文章过度承诺，或手机只看得到检查对象、看不到证据边界。已读取并核对引用的 accepted owner 合同和对应负例：缩小输出但移除必要语义、缩小词表扫描范围/放宽 twin budget、借旧 debt exception 继续增长，共 6 个针对性用例通过。恢复行明确只覆盖有限故障、真实 File journal 和合成 provider ledger，不声称断电、所有 lease 竞争或跨域活性；R6 仍需要真实两宿主含 cloud worker。

正常 base/head 构建和实际 HTTP 双语读回通过；当前 head SEO、7 篇双语索引以及 canary 的 3 项 direct、3 项 selected 均通过，零 failure/hold。Ego 实看 1280×900、390×844 两语视口：页面未横向撑宽；手机 table 720/client350，可通过键盘横移至 x370 阅读右列，原图加载和文章 reload 成功。初次构建缺 Vite 类型是依赖尚未准备，原 lockfile 的 npm ci 后正常通过，未改源码或放宽验证。没有读取 GitHub CI。

语义与 CI 对齐

新增四行是局部展示词汇，复述既有 owner 规则；没有新共享 Enum/Literal、状态分类器或 prose gate。机器强制检查仍称为门禁，同时明确尺寸达标不证明理解、低复杂度不证明设计好、有限恢复不证明完整长期工作。HTML 不在 Python/TS AST advisory 的支持范围，已通过全 diff、引用规则、正常构建及负例手工核对，不能拿空扫描当语义证明。

我的整体评价

APPROVE。long_horizon 的改善是把工程经验连接到可复核的检查和仍开放的验收，保留失败与限制；user_experience 的改善是在同一文章中直接获得做法和证据来源，窄屏与键盘能够到达右侧限制说明。边界适当：既有 wrapper 和公开合成图已够用，未来向重构不需要额外抽象。此结论只认可当前公开文章，不把未完成的 TS 迁移、R6、完整恢复或模型净效宣布完成，也不授予发布或合并权限。

English verdict: APPROVE - 33c4960; concrete bilingual practices and bounded guardrails match pinned public sources, aggregate values and six negative tests. Normal builds, SEO, bilingual smoke, real desktop/mobile keyboard/image/reload checks and local canary pass; full operational and causal qualification remains open.