docs: describe TFD engineering contract

Author: Howe829

README-CN.md

@@ -7,7 +7,8 @@
 Team First Development（TFD）是一套选择性使用的 Codex 团队开发方法。它通过
 目标对齐、模型与职责匹配、聚焦上下文和独立审核，改善一个边界明确的开发结果。
 
-当前已发布版本是 `3.2.0`。本地检出本身不能证明已经安装、部署或发布。
+源码树当前是本地 `3.3.0` 候选；当前已发布版本仍是 `3.2.0`。本地检出本身不能
+证明已经安装、部署或发布。
 
 ## 使用
 
@@ -21,6 +22,15 @@ TFD 首先判断协作收益是否高于协调成本。简单任务由单 Agent
 `.tfd/`。当任务包含可分离的专业职责，或风险确实要求独立审核时，才考虑使用
 项目已配置的团队。
 
+## 工程合同
+
+凡是修改源码或软件架构的任务，TFD 都必须在最终确定 `PLAN` 前完整读取
+[`references/engineering-constraints.md`](plugins/tfd/skills/using-tfd/references/engineering-constraints.md)。
+这个要求同时适用于 `SOLO` 和团队执行。规则保持不变；证据深度按风险缩放。
+
+该 reference 是唯一规范副本。计划只识别相关改动形状，执行只携带适用约束，
+review 检查完整候选；不增加第二个 Skill 或策略引擎。
+
 ## 项目团队
 
 项目创建时可以定义可复用的团队和成员资料：
@@ -198,6 +208,8 @@ GitHub Release 作为发布证据。
 ```text
 plugins/tfd/.codex-plugin/plugin.json      插件清单
 plugins/tfd/skills/using-tfd/SKILL.md      唯一用户 Skill
+plugins/tfd/skills/using-tfd/references/engineering-constraints.md
+                                           按需加载的工程合同
 plugins/tfd/skills/using-tfd/references/team-wiki.md
                                            按需加载的 Team Wiki 协议
 plugins/tfd/scripts/tfd_wiki/              标准库 Wiki Guard

README.md

@@ -8,8 +8,9 @@ Team First Development (TFD) is a selective Codex team-development method.
 It improves a bounded development result through alignment, model-role fit,
 focused context, and independent review.
 
-The current published release is `3.2.0`. A local checkout does not by itself
-prove installation, deployment, or publication.
+The source tree is a local `3.3.0` candidate. The current published release
+remains `3.2.0`. A local checkout does not by itself prove installation,
+deployment, or publication.
 
 ## Use
 
@@ -24,6 +25,17 @@ Simple work stays with one Agent and does not read or write `.tfd/`. Work with
 separable professional responsibilities, or enough risk to require an
 independent reviewer, may use a project-configured team.
 
+## Engineering contract
+
+For every source-code or architecture change, TFD reads
+[`references/engineering-constraints.md`](plugins/tfd/skills/using-tfd/references/engineering-constraints.md)
+completely before finalizing `PLAN`. This applies to both `SOLO` and team
+execution. The rules remain fixed; evidence depth scales with risk.
+
+The reference is the single normative copy. Planning identifies the relevant
+change shape, execution carries only the applicable constraints, and review
+checks the complete candidate without adding a second Skill or policy engine.
+
 ## Project teams
 
 Project setup may define reusable team and member profiles:
@@ -230,6 +242,8 @@ deployment. Use the `v3.2.0` tag and GitHub Release as publication evidence.
 ```text
 plugins/tfd/.codex-plugin/plugin.json      Plugin manifest
 plugins/tfd/skills/using-tfd/SKILL.md      Single user-facing Skill
+plugins/tfd/skills/using-tfd/references/engineering-constraints.md
+                                           On-demand engineering contract
 plugins/tfd/skills/using-tfd/references/team-wiki.md
                                            On-demand Team Wiki protocol
 plugins/tfd/scripts/tfd_wiki/              Standard-library Wiki Guard

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

@@ -1,7 +1,7 @@
 {
   "name": "tfd",
-  "version": "3.2.0",
-  "description": "Session-first development with YAML team profiles, member-selected Codex Runtimes, and a per-team Markdown Team Wiki.",
+  "version": "3.3.0",
+  "description": "Session-first development with YAML team profiles, member-selected Codex Runtimes, a progressively loaded engineering contract, and a per-team Markdown Team Wiki.",
   "author": {
     "name": "Howe829",
     "url": "https://github.com/Howe829"
@@ -14,7 +14,7 @@
   "interface": {
     "displayName": "Team First Development",
     "shortDescription": "按需求从 YAML 配置组建最小团队",
-    "longDescription": "Route simple work to one Agent, or select one configured YAML team and its minimum useful members with exact Codex Runtime bindings for session-scoped delivery, independent review, and a Git-native per-team Markdown Team Wiki.",
+    "longDescription": "Route simple work to one Agent, or select one configured YAML team and its minimum useful 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.",
     "developerName": "Howe829",
     "category": "Developer Tools",
     "capabilities": ["Interactive", "Write"],

scripts/test_plugin_contract.py

@@ -29,6 +29,15 @@
     "scripts/test_tfd_wiki_proposal.py",
     "scripts/test_tfd_wiki_records.py",
 }
+ENGINEERING_RULE_HEADINGS = (
+    "One concern, one owner",
+    "Dependencies point toward logic",
+    "One capability, one implementation",
+    "A feature is an add/remove unit",
+    "One canonical paradigm",
+    "Shipped code has a current caller",
+    "Complexity must earn its place now",
+)
 
 
 class PluginPackageContractTests(unittest.TestCase):
@@ -48,18 +57,23 @@ def test_manifest_points_to_the_single_skill_package(self) -> None:
         self.assertEqual(manifest["skills"], "./skills/")
         self.assertEqual(skill_dirs, ["using-tfd"])
 
-    def test_candidate_metadata_describes_yaml_teams_and_team_wiki(self) -> None:
+    def test_candidate_metadata_describes_all_tfd_capabilities(self) -> None:
         manifest = json.loads(
             (PLUGIN_ROOT / ".codex-plugin" / "plugin.json").read_text(
                 encoding="utf-8"
             )
         )
-        self.assertEqual(manifest["version"], "3.2.0")
+        self.assertEqual(manifest["version"], "3.3.0")
         self.assertIn("YAML", manifest["description"])
         self.assertIn("Runtimes", manifest["description"])
         self.assertIn("Team Wiki", manifest["description"])
+        self.assertIn("engineering contract", manifest["description"].lower())
         self.assertIn("Runtime", manifest["interface"]["longDescription"])
         self.assertIn("Team Wiki", manifest["interface"]["longDescription"])
+        self.assertIn(
+            "engineering contract",
+            manifest["interface"]["longDescription"].lower(),
+        )
         self.assertIn("knowledge-base", manifest["keywords"])
         self.assertNotIn("state", manifest["description"].lower())
 
@@ -147,6 +161,37 @@ def test_readmes_document_member_runtime_contract(self) -> None:
                 with self.subTest(path=path.name, clause=clause):
                     self.assertIn(clause, content)
 
+    def test_readmes_route_code_changes_to_engineering_contract(self) -> None:
+        expectations = {
+            "README.md": (
+                "candidate",
+                "published",
+                "rules remain fixed",
+                "evidence depth scales with risk",
+            ),
+            "README-CN.md": (
+                "候选",
+                "已发布",
+                "规则保持不变",
+                "证据深度按风险",
+            ),
+        }
+        for filename, localized in expectations.items():
+            content = (ROOT / filename).read_text(encoding="utf-8")
+            for clause in (
+                "3.3.0",
+                "3.2.0",
+                "references/engineering-constraints.md",
+                "`SOLO`",
+                "`PLAN`",
+                *localized,
+            ):
+                with self.subTest(filename=filename, clause=clause):
+                    self.assertIn(clause, content)
+            for heading in ENGINEERING_RULE_HEADINGS:
+                with self.subTest(filename=filename, heading=heading):
+                    self.assertNotIn(heading, content)
+
     def test_plugin_package_contains_no_dot_tfd_tree(self) -> None:
         packaged_state = sorted(
             path.relative_to(PLUGIN_ROOT).as_posix()