chore(repo): 消融 reference/ 墓碑机制——INDEX.md 自称"已清理无活跃 checkout"、唯一生产者 sync-reference.py 在 CI/Makefile/docs 零调用者，而 verify-doc-ssot 用 3 处自指把它钉在门禁里（12 文件净 −137 行）

.dockerignore

@@ -85,9 +85,6 @@ app/web/pnpm-lock.yaml
 # ── Rust / Tauri (not needed for Go build) ────
 target/
 
-# ── Reference repos ───────────────────────────
-reference/
-
 # ── Local ops state ───────────────────────────
 .ops
 .tmp

.gitignore

@@ -266,9 +266,6 @@ docs/deployment/region-*.md
 docs/deployment/*-deployment-runbook.md
 docs/deployment/*deployment*
 
-# Cloned reference repos (at repo root only)
-/reference/*
-!/reference/INDEX.md
 /chat-verify/
 
 # =============================================================================

AGENTS.md

@@ -16,7 +16,7 @@
 
 ## 0.5 根级目录地图
 
-【活】= 维护中的源码/文档；【产物】= 构建/临时产物（gitignored，勿提交）；【参考】= 只读副本。
+【活】= 维护中的源码/文档；【产物】= 构建/临时产物（gitignored，勿提交）。
 
 | 目录 | 分类 | 职责 |
 |---|---|---|
@@ -28,7 +28,6 @@
 | `hub-server/` | 活 | Go Hub 服务（REST/WS/OIDC/dispatch/agentteam） |
 | node_modules/ | 产物 | 依赖（gitignored） |
 | `pkg/` | 活 | Go 共享包（errcode 等） |
-| `reference/` | 参考 | 第三方源码只读副本（gitignored，INDEX.md 管理） |
 | `scripts/` | 活 | 验证/开发/发布脚本（verify/dev/e2e/git-hooks/lib/release/smoke/） |
 | `tests/` | 活 | 跨服务测试 |
 

edge-server/internal/adapters/hooks.go

@@ -1,6 +1,5 @@
 // Package adapters — AgentHook 接口定义
 // 基于 Claude Code (28 hooks) + OpenCode (19 hooks) 收敛为 6 核心 hooks
-// 参考: docs/reference/02-cross-comparison/00-synthesis.md §2.2
 
 package adapters
 

edge-server/internal/agents/registry.go

@@ -2,7 +2,6 @@
 // for the AgentHub Orchestrator. It tracks runtime agent instances, their
 // status, and enables communication between orchestrator and sub-agents.
 //
-// Reference: docs/reference/cross-comparison/03-orchestration.md Layer 2
 // Reference: historical codex-cli AgentTree pattern indexed by docs/history.md.
 //
 // Residual pure-helper peel #1154: Registry core API stays here; types,

edge-server/internal/lifecycle/process_executor_structured.go

@@ -87,5 +87,4 @@ func (e *ProcessExecutor) publishStructuredOutput(wg *sync.WaitGroup, run store.
 // sessions.create({parentID}) pattern where sub-agents get independent sessions
 // with derived permissions and no shared context contamination.
 //
-// Reference: docs/reference/cross-comparison/03-orchestration.md Layer 3 (Supervisor routing).
 // Reference: OpenCode task.ts:145-162 (sessions.create with parentID, deriveSubagentSessionPermission).

edge-server/internal/orchestration/contracts.go

@@ -87,7 +87,6 @@ type AgentCapabilities struct {
 }
 
 // SubAgentTask describes a sub-agent task to be dispatched by the orchestrator.
-// Reference: docs/reference/cross-comparison/03-orchestration.md Layer 3 (Supervisor routing).
 type SubAgentTask struct {
 	TaskID      string `json:"taskId"`
 	Description string `json:"description"`

scripts/dev/setup.py

@@ -1,10 +1,9 @@
 #!/usr/bin/env python3
 """setup — AgentHub 本地环境配置（ps1 迁移，契约见 server docs/design/ps1-to-python-migration.md）。
 
-启用 git hooks（scripts/git-hooks），可选同步 public reference 仓库
-（-Reference core|all；兼容原 setup.sh 的 --reference-core / --reference-all）。
+启用 git hooks（scripts/git-hooks）。
 
-契约：stdlib only；参数/输出行（`Git hooks enabled: scripts/git-hooks` /
+契约：stdlib only；输出行（`Git hooks enabled: scripts/git-hooks` /
 `Setup complete.`）与 ps1 一致；退出码 0=通过。
 """
 
@@ -19,16 +18,7 @@
 
 def main() -> int:
     parser = argparse.ArgumentParser(description=__doc__.splitlines()[0])
-    parser.add_argument("--Reference", "-Reference", default="none", choices=["none", "core", "all"])
-    parser.add_argument("--reference-core", action="store_true", help="sync core reference repos (setup.sh compatibility)")
-    parser.add_argument("--reference-all", action="store_true", help="sync all reference repos (setup.sh compatibility)")
-    args = parser.parse_args()
-
-    reference = args.Reference
-    if args.reference_core:
-        reference = "core"
-    if args.reference_all:
-        reference = "all"
+    parser.parse_args()
 
     repo_root = os.path.realpath(REPO_ROOT)
     os.chdir(repo_root)
@@ -38,11 +28,6 @@ def main() -> int:
         raise RuntimeError(f"git config core.hooksPath failed with exit code {run.returncode}")
     print("Git hooks enabled: scripts/git-hooks")
 
-    if reference != "none":
-        sync_run = subprocess.run([sys.executable, os.path.join(SCRIPT_DIR, "sync-reference.py"), "--Tier", reference])
-        if sync_run.returncode != 0:
-            return sync_run.returncode
-
     print("Setup complete.")
     return 0
 

scripts/dev/setup.sh

@@ -2,9 +2,7 @@
 # ───────────────────────────────────────────────
 # AgentHub 本地环境配置（Python 实现，原 ps1 已迁移；本文件是兼容 launcher）
 # 用法:
-#   ./scripts/dev/setup.sh                    # 仅启用 git hooks
-#   ./scripts/dev/setup.sh --reference-core   # 同步 core reference 仓库
-#   ./scripts/dev/setup.sh --reference-all    # 同步全部 reference 仓库
+#   ./scripts/dev/setup.sh                    # 启用 git hooks
 # ───────────────────────────────────────────────
 set -euo pipefail
 

scripts/verify/verify-doc-ssot.py

@@ -46,7 +46,7 @@ def is_active_doc(path: str) -> bool:
     p = normalize_path(path)
     if re.match(r"^docs/(archive|archives|audit|release)/", p):
         return False
-    if p in ("AGENTS.md", "CONTRIBUTING.md", "reference/INDEX.md", "README.md", "README_EN.md"):
+    if p in ("AGENTS.md", "CONTRIBUTING.md", "README.md", "README_EN.md"):
         return True
     if p in ("api/README.md", "api/events.md", "api/conventions.md"):
         return True
@@ -175,7 +175,6 @@ def check_required_markers() -> None:
         ("hub-server/README.md", "Source Map"),
         ("hub-server/deployments/README.md", "Live host"),
         ("hub-server/tests/README.md", "Integration Tests"),
-        ("reference/INDEX.md", "docs/reference/README.md"),
         ("CONTRIBUTING.md", "旧详细贡献指南见"),
         ("docs/governance/README.md", "Login fixture topology gate"),
         ("docs/governance/README.md", "已迁移至私有文档中枢"),
@@ -263,7 +262,6 @@ def check_max_lines() -> None:
         "AGENTS.md": 300,
         "CHANGELOG.md": 90,
         "CONTRIBUTING.md": 90,
-        "reference/INDEX.md": 80,
         "api/README.md": 100,
         "api/events.md": 180,
         "api/conventions.md": 190,