Skip to content

Commit 8e33258

Browse files
committed
feat: release TFD v3.5.0 with AUTO_REVIEW
1 parent b666b06 commit 8e33258

11 files changed

Lines changed: 657 additions & 76 deletions

File tree

.agents/plugins/marketplace.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@
99
"source": {
1010
"source": "local",
1111
"path": "./plugins/tfd",
12-
"version": "3.4.1"
12+
"version": "3.5.0"
1313
},
1414
"policy": {
1515
"installation": "AVAILABLE",

CHANGELOG.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,15 @@ All notable public changes to Team First Development are documented here.
44

55
## Unreleased
66

7+
## 3.5.0 - 2026-08-13
8+
9+
- Add opt-in, session-only `AUTO_REVIEW` with one confirmed Autonomy Envelope,
10+
Orchestrator approval for in-envelope gates, bounded repair and evidence
11+
recovery, and no repeated user reply between approved steps.
12+
- Keep independent review as risk-scaled evidence, preserve exact external
13+
targets, and leave out-of-envelope, production, destructive, privileged,
14+
messaging, security, and structural Wiki changes human-gated.
15+
716
## 3.4.1 - 2026-08-05
817

918
- Remove all Superpowers Skill bindings from TFD documentation and example

README-CN.md

Lines changed: 37 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
Team First Development(TFD)是一套选择性使用的 Codex 团队开发方法。它通过
88
目标对齐、模型与职责匹配、聚焦上下文和独立审核,改善一个边界明确的开发结果。
99

10-
当前源码版本为 `3.4.1`。是否已发布以 `v3.4.1` 标签和 GitHub Release 为准;
10+
当前源码版本为 `3.5.0`。是否已发布以 `v3.5.0` 标签和 GitHub Release 为准;
1111
本地检出本身不能证明已经安装、部署或发布。
1212

1313
## 使用
@@ -32,6 +32,26 @@ workstream。精确确认方案必须展示每个 workstream 的责任成员、
3232
Agent。只有无依赖且写入范围不重叠的 workstream 才可并行;`BLOCKER` 会停止
3333
下游,Coordinator 最后把已接受的产出整合成一个不可变审核候选。
3434

35+
## AUTO_REVIEW 模式
36+
37+
默认仍是人工确认。用户显式选择 `AUTO_REVIEW` 后,只需先确认一个会话级
38+
Autonomy Envelope,其中列明范围、Roster、workstream、可自动审核的 Gate、有界修复
39+
策略、证据要求和精确外部目标。当前 Coordinator 随即成为 Orchestrator,自动审核
40+
并通过每个 Envelope 内 Gate,不再等待用户逐次回复。只有风险或 Envelope 要求时
41+
才调用独立 reviewer;reviewer 提供证据,Orchestrator 才是审批权威。
42+
43+
只有证据充分的 Orchestrator `PASS` 会推进。`BLOCKER` 可以进入 Envelope 内的
44+
有界修复循环,`UNVERIFIED` 可以触发已列明的补证,但都不能直接释放下游。Envelope
45+
可以预先授权精确 commit、non-force merge、branch/tag-ref push、tag、Release、本地
46+
first install/reinstall 和 non-production deployment。production deployment、破坏性
47+
或 force 操作、付费资源、提权、外部消息、安全或身份变更、用户验收、扩大范围,
48+
以及修改 Envelope/Orchestrator,始终只能由用户确认;宿主或平台确认也不能绕过。
49+
50+
未来才产生的 candidate、commit、tag、Release、artifact、install 和 deployment 值,
51+
必须用 late-bound 引用绑定到一个命名 Gate 输出。Orchestrator 在下游 Gate 前冻结完整
52+
digest/OID 并校验 lineage,因此一次确认即可驱动完整链路,不会依赖可漂移的
53+
`latest`,也不必在每个产物出现后再次询问。有界修复会作废并重算全部下游派生输出。
54+
3555
## 工程合同
3656

3757
凡是修改源码或软件架构的任务,TFD 都必须在最终确定 `PLAN` 前完整读取
@@ -144,11 +164,16 @@ daemon、远程存储、进度状态或恢复权威。可以把 Obsidian 当作
144164

145165
### 知识确认
146166

147-
初始化、摄取、修复、冲突解决和 schema 变更都遵循
148-
`PROPOSE -> CONFIRM -> APPLY`。确认前,`wiki/` 下任何文件都不能变化。TFD
149-
展示团队、来源与摘要、页面差异、冲突、index/log 影响、当前 Wiki baseline、
150-
完整 SHA-256 和 12 字符指纹。自然语言确认可以引用短指纹,但 Guard 只接受
151-
完整匹配摘要。提案或 baseline 的任何实质变化都需要重新确认。
167+
人工模式下,初始化、摄取、修复、冲突解决和 schema 变更都遵循
168+
`PROPOSE -> CONFIRM -> APPLY`。已确认 `AUTO_REVIEW` Envelope 时,初始化和常规
169+
add-only ingest 可以用 Guard 校验加 Orchestrator `PASS` 代替逐次人工确认;修复、
170+
冲突解决和 schema 变更仍只能由用户确认。在取得其中一种授权前,`wiki/` 下任何
171+
文件都不能变化。TFD 展示团队、来源与摘要、页面差异、冲突、index/log 影响、
172+
当前 Wiki baseline、完整 SHA-256 和 12 字符指纹。自然语言确认可以引用短指纹,
173+
但 Guard 只接受完整匹配摘要。提案或 proposal-local Wiki baseline 的实质变化,
174+
在人工模式下需要重新确认;仍在 Envelope 内的 initialization 或常规 add-only ingest
175+
则要重新通过 Guard 并取得绑定新摘要的 Orchestrator `PASS`。只要混入 conflict、repair、schema 或其他
176+
human-only effect,整个提案都回到人工确认。Envelope 字段变化始终要用户确认。
152177

153178
来源只增不改。新版本创建新的摘要寻址快照,绝不覆盖旧版本。相互冲突且都有
154179
来源的结论保留在 `disputed` 页面,直到用户单独确认解决方案。
@@ -206,18 +231,21 @@ Wiki 存在后,最终交付只记录一个 `delivery` activity,不再创建
206231

207232
## 授权边界
208233

209-
团队确认只授权方案中列明的本地资料写入和/或成员激活,不授权安装、合并、
234+
人工团队确认只授权方案中列明的本地资料写入和/或成员激活,不授权安装、合并、
210235
推送、打标签、发布、部署、对外消息、破坏性清理、特权命令、付费动作或扩大
211-
范围;这些动作继续遵循各自的正常审批边界。
236+
范围。`AUTO_REVIEW` 只能预授权已确认 Envelope 定义的精确内部与外部 Gate 和目标;
237+
Orchestrator 随后无需用户再次回复即可完成 TFD 审批。其他动作继续保留人工审批边界。
212238

213-
本地检出目录中的版本号本身不能证明已经安装或部署。请以 `v3.4.1` 标签和
239+
本地检出目录中的版本号本身不能证明已经安装或部署。请以 `v3.5.0` 标签和
214240
GitHub Release 作为发布证据。
215241

216242
## 仓库结构
217243

218244
```text
219245
plugins/tfd/.codex-plugin/plugin.json 插件清单
220246
plugins/tfd/skills/using-tfd/SKILL.md 唯一用户 Skill
247+
plugins/tfd/skills/using-tfd/references/auto-review.md
248+
按需加载的 AUTO_REVIEW 协议
221249
plugins/tfd/skills/using-tfd/references/engineering-constraints.md
222250
按需加载的工程合同
223251
plugins/tfd/skills/using-tfd/references/team-wiki.md

README.md

Lines changed: 50 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ Team First Development (TFD) is a selective Codex team-development method.
88
It improves a bounded development result through alignment, model-role fit,
99
focused context, and independent review.
1010

11-
This source tree is version `3.4.1`. The `v3.4.1` tag and GitHub Release are
11+
This source tree is version `3.5.0`. The `v3.5.0` tag and GitHub Release are
1212
the publication evidence; a local checkout alone does not prove installation,
1313
deployment, or publication.
1414

@@ -37,6 +37,33 @@ unconfirmed helper Agents. Dependency-free workstreams may run in parallel only
3737
when their write scopes do not overlap; a blocker stops its dependents, and the
3838
Coordinator integrates accepted outputs into one immutable review candidate.
3939

40+
## AUTO_REVIEW mode
41+
42+
Manual confirmation remains the default. With explicit `AUTO_REVIEW`, the user
43+
confirms one session-only Autonomy Envelope containing the scope, roster,
44+
workstreams, eligible gates, bounded repair policy, evidence requirements, and
45+
exact external targets. The current Coordinator becomes the Orchestrator and
46+
auto-approves each in-envelope Gate; there is no repeated user reply between
47+
those Gates. Independent review supplies evidence only when risk or the
48+
Envelope requires it.
49+
50+
Only an evidence-bound Orchestrator `PASS` advances. A `BLOCKER` may enter an
51+
in-envelope bounded repair loop, and `UNVERIFIED` may trigger named evidence
52+
collection; neither advances dependent work or becomes success. The Envelope
53+
may pre-authorize exact commit, non-force merge, branch/tag-ref push, tag,
54+
Release, local first install/reinstall, and non-production deployment Gates.
55+
Production deployment, destructive or force operations, paid resources,
56+
privileges, external messages, security or identity changes, user acceptance,
57+
scope expansion, and Envelope/Orchestrator changes remain human-only. Host or
58+
platform confirmations still apply.
59+
60+
Future candidate, commit, tag, Release, artifact, install, and deployment values
61+
use an exact late-bound reference to one named Gate output. The Orchestrator
62+
freezes the full digest or OID, validates lineage, and then reviews the dependent
63+
Gate. This lets one confirmed Envelope drive the complete chain without using a
64+
mutable `latest` value or asking for another reply after each artifact appears.
65+
Bounded repair invalidates and recomputes every downstream derived output.
66+
4067
## Engineering contract
4168

4269
For every source-code or architecture change, TFD reads
@@ -165,13 +192,20 @@ runtime or write authority.
165192

166193
### Knowledge confirmation
167194

168-
Initialization, ingest, repair, conflict resolution, and schema changes use
169-
`PROPOSE -> CONFIRM -> APPLY`. Before confirmation, no file under `wiki/`
170-
changes. TFD displays the team, sources and digests, page differences,
171-
conflicts, index/log effects, current Wiki baseline, complete SHA-256, and
172-
12-character fingerprint. Natural-language confirmation may cite the short
173-
fingerprint; only the complete matching digest authorizes the Guard. Any
174-
material proposal or baseline change requires renewed confirmation.
195+
In manual mode, initialization, ingest, repair, conflict resolution, and schema
196+
changes use `PROPOSE -> CONFIRM -> APPLY`. Under a confirmed `AUTO_REVIEW`
197+
envelope, initialization and routine add-only ingest may replace the per-proposal
198+
human confirmation with Guard validation plus an Orchestrator `PASS`; repair,
199+
conflict resolution, and schema changes stay human-only. Before either authority
200+
is present, no file under `wiki/` changes. TFD displays the team, sources and
201+
digests, page differences, conflicts, index/log effects, current Wiki baseline,
202+
complete SHA-256, and 12-character fingerprint. Natural-language confirmation
203+
may cite the short fingerprint; only the complete matching digest authorizes
204+
the Guard. A material proposal or proposal-local Wiki baseline change requires
205+
new manual confirmation, or fresh Guard validation plus a new Orchestrator `PASS`
206+
for still-in-envelope initialization or routine add-only ingest. A mixed proposal with any conflict,
207+
repair, schema, or other human-only effect returns as a whole to manual
208+
confirmation. Changing an Envelope field always requires user confirmation.
175209

176210
Sources are add-only. A revision creates a new digest-addressed snapshot and
177211
never overwrites an earlier version. Conflicting sourced claims remain on a
@@ -240,20 +274,24 @@ recovery system, or management control plane.
240274

241275
## Authority boundary
242276

243-
Team confirmation authorizes only the named local profile writes and/or member
277+
Manual team confirmation authorizes only the named local profile writes and/or member
244278
activation. It does not authorize installation, merge, push, tag, release,
245279
deployment, publication, external messages, destructive cleanup, privileged
246-
commands, paid actions, or scope expansion. Each keeps its normal approval
247-
boundary.
280+
commands, paid actions, or scope expansion. `AUTO_REVIEW` can pre-authorize only
281+
the exact internal and external Gates and targets defined in its confirmed
282+
Envelope; the Orchestrator then supplies their TFD approval without another
283+
user reply. Everything outside it keeps its normal human approval boundary.
248284

249285
A version in a local checkout does not by itself prove installation or
250-
deployment. Use the `v3.4.1` tag and GitHub Release as publication evidence.
286+
deployment. Use the `v3.5.0` tag and GitHub Release as publication evidence.
251287

252288
## Repository layout
253289

254290
```text
255291
plugins/tfd/.codex-plugin/plugin.json Plugin manifest
256292
plugins/tfd/skills/using-tfd/SKILL.md Single user-facing Skill
293+
plugins/tfd/skills/using-tfd/references/auto-review.md
294+
On-demand AUTO_REVIEW protocol
257295
plugins/tfd/skills/using-tfd/references/engineering-constraints.md
258296
On-demand engineering contract
259297
plugins/tfd/skills/using-tfd/references/team-wiki.md

plugins/tfd/.codex-plugin/plugin.json

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "tfd",
3-
"version": "3.4.1",
4-
"description": "Session-first development with Coordinator-decomposed workstreams, YAML team profiles, member-selected Codex Runtimes, a progressively loaded engineering contract, and a per-team Markdown Team Wiki.",
3+
"version": "3.5.0",
4+
"description": "Session-first development with Coordinator-decomposed workstreams, Orchestrator-approved AUTO_REVIEW, YAML team profiles, member-selected Codex Runtimes, a progressively loaded engineering contract, and a per-team Markdown Team Wiki.",
55
"author": {
66
"name": "Howe829",
77
"url": "https://github.com/Howe829"
@@ -13,8 +13,8 @@
1313
"skills": "./skills/",
1414
"interface": {
1515
"displayName": "Team First Development",
16-
"shortDescription": "按需求拆分 workstream 并组建最小团队",
17-
"longDescription": "Route simple work to one Agent, or decompose TEAM work into confirmed workstreams assigned to the minimum configured members with exact Codex Runtime bindings; apply one progressively loaded engineering contract to code changes; and retain session-scoped delivery, independent review, and a Git-native per-team Markdown Team Wiki.",
16+
"shortDescription": "拆分 workstream,由 Orchestrator 自动过 Gate",
17+
"longDescription": "Route simple work to one Agent, or decompose TEAM work into confirmed workstreams assigned to the minimum configured members with exact Codex Runtime bindings; optionally let the Orchestrator approve in-envelope AUTO_REVIEW gates, bounded repairs, and evidence recovery after one session-only Autonomy Envelope confirmation; apply one progressively loaded engineering contract to code changes; and retain risk-scaled independent review and a Git-native per-team Markdown Team Wiki.",
1818
"developerName": "Howe829",
1919
"category": "Developer Tools",
2020
"capabilities": ["Interactive", "Write"],

0 commit comments

Comments
 (0)