trellis-governance-closeout 收口旧任务并统一 Trellis-only 治理

2026-05-26 12:38:19 +08:00
@@ -0,0 +1,4 @@
+{"file": ".trellis/spec/hyb-oa/index.md", "reason": "hyb-oa spec entry point for verification"}
+{"file": ".trellis/spec/hyb-oa/project-governance.md", "reason": "verify Trellis task contract and closeout rules"}
+{"file": ".trellis/spec/hyb-oa/docs-and-evidence.md", "reason": "verify docs registry and historical evidence consistency"}
+{"file": ".trellis/spec/hyb-oa/security-privacy.md", "reason": "verify no sensitive data is introduced"}
@@ -0,0 +1,4 @@
+{"file": ".trellis/spec/hyb-oa/index.md", "reason": "hyb-oa spec entry point for Trellis-only governance closeout"}
+{"file": ".trellis/spec/hyb-oa/project-governance.md", "reason": "Trellis task contract and commit/approval rules"}
+{"file": ".trellis/spec/hyb-oa/docs-and-evidence.md", "reason": "docs registry and historical evidence boundaries"}
+{"file": ".trellis/spec/hyb-oa/security-privacy.md", "reason": "privacy rules for governance documents and reports"}
@@ -0,0 +1,31 @@
+# Implementation Notes
+
+## Scope
+
+This task closes the governance migration after TRELLIS2 and the removal of
+the project-local delivery skill. It only changes Trellis task records, current
+governance docs, process wording and QA governance scripts.
+
+## Approach
+
+1. Archive superseded setup tasks after marking their PRDs as historical or
+   superseded.
+2. Keep historical `issues/*.csv` files untouched.
+3. Update current-facing docs so new non-trivial work starts from a Trellis
+   task PRD and not from a new Issue CSV.
+4. Preserve Issue CSV references only where they are explicitly historical,
+   audit evidence or legacy/export compatibility.
+5. Keep `.trellis/spec/hyb-oa/` as the stable project rule entry point.
+
+## Boundaries
+
+- No backend or frontend business-code changes.
+- No deployment, production config, database, Enterprise WeChat or payment
+  writes.
+- No deletion or bulk rewrite of historical `issues/*.csv`.
+- No resurrection of `.agents/skills/hyb-oa-delivery`.
+
+## Verification
+
+Run the task validation, Trellis governance gate, process contract baseline,
+docs registry audit, stale wording search and `git diff --check` before commit.
@@ -0,0 +1,79 @@
+# Close Out Legacy Trellis Tasks And Trellis-Only Governance Wording
+
+## Goal
+
+Finish the governance migration by closing stale Trellis setup tasks and
+removing current Issue CSV-first wording from active governance documents, so
+new hyb-oa work consistently starts from Trellis tasks/specs while historical
+Issue CSVs remain audit evidence.
+
+## Scope
+
+- Review and close out the old active Trellis setup tasks:
+  - `00-bootstrap-guidelines`
+  - `05-26-trellis1-pilot`
+  - `05-26-trellis2-official-task-contract`
+- Update current governance documents that still describe Issue CSV as the
+  default development contract.
+- Preserve historical Issue CSV files and historical references.
+- Keep `.trellis/spec/hyb-oa/` as the project-specific spec entry point.
+- Run governance, docs and task validation after edits.
+
+## Out Of Scope
+
+- No backend or frontend business-code changes.
+- No public deployment or live OA verification.
+- No database, Enterprise WeChat, payment, production config or real-data write.
+- No deletion, migration or bulk rewrite of historical `issues/*.csv` files.
+- No implementation of OAOPS1, OALAUNCH1, WREAL1 or Enterprise WeChat mirror
+  features in this task.
+
+## Requirements
+
+- Active Trellis task list should no longer contain completed historical setup
+  tasks after this task is done.
+- Current governance docs must say Trellis task is the default execution
+  contract for new non-trivial work.
+- Issue CSVs must be described only as historical audit evidence or optional
+  external/export format unless a user explicitly requests legacy output.
+- Existing docs fact sources and Trellis specs must remain registered and
+  validated.
+- Historical issue references may remain when clearly historical.
+
+## Acceptance
+
+- `task.py list` shows no stale active setup task for bootstrap, TRELLIS1 or
+  TRELLIS2 after closeout.
+- `docs/开发交付与变更管理规约.md` no longer instructs current work to start
+  from Issue CSV by default.
+- `docs/文档索引.md`, `docs/文档事实源状态矩阵.md` and
+  `docs/Agent开发交付实践.md` remain aligned with Trellis-only governance.
+- Governance scripts pass.
+- Working tree is committed and clean when the task is finished.
+
+## Test Plan
+
+- `python3 ./.trellis/scripts/task.py validate 05-26-trellis-governance-closeout`
+- `python3 ./.trellis/scripts/task.py list`
+- `node --check scripts/qa/check-trellis-governance.mjs`
+- `node --check scripts/qa/check-process-contract.mjs`
+- `node --check scripts/qa/audit-docs.mjs`
+- `node scripts/qa/check-trellis-governance.mjs`
+- `node scripts/qa/check-process-contract.mjs --baseline --json`
+- `node scripts/qa/audit-docs.mjs --check-registry`
+- `rg -n "开发必须围绕最新 Issue CSV|先有 Issue CSV|Issue CSV.*默认|Skill quick_validate|hyb-oa-delivery|单功能 Issue CSV|最新 Issue CSV|不得跳过 Issue CSV" AGENTS.md docs scripts .trellis/spec .trellis/workflow.md`
+- `git diff --check`
+
+## Privacy
+
+Do not write passwords, token, Secret, real invoice originals, contract bodies,
+bank materials, full accounts, complete local paths or raw payloads in Trellis
+tasks, docs, reports or chat.
+
+## Implementation Plan
+
+1. Confirm the old Trellis setup tasks are completed or superseded.
+2. Update only current governance wording that still implies Issue CSV-first
+   execution.
+3. Archive stale setup tasks after validation.
+4. Run the test plan and commit the governance closeout.
@@ -0,0 +1,38 @@
+{
+  "id": "trellis-governance-closeout",
+  "name": "trellis-governance-closeout",
+  "title": "Close out legacy Trellis tasks and Trellis-only governance wording",
+  "description": "Close out legacy in-progress Trellis setup tasks and remove current Issue CSV-first governance wording now that Trellis-only delivery is established.",
+  "status": "in_progress",
+  "dev_type": "docs",
+  "scope": "trellis-governance",
+  "package": "docs",
+  "priority": "P2",
+  "creator": "shunli",
+  "assignee": "shunli",
+  "createdAt": "2026-05-26",
+  "completedAt": null,
+  "branch": null,
+  "base_branch": "main",
+  "worktree_path": null,
+  "commit": null,
+  "pr_url": null,
+  "subtasks": [],
+  "children": [],
+  "parent": null,
+  "relatedFiles": [
+    ".trellis/tasks/00-bootstrap-guidelines/",
+    ".trellis/tasks/05-26-trellis1-pilot/",
+    ".trellis/tasks/05-26-trellis2-official-task-contract/",
+    "docs/开发交付与变更管理规约.md",
+    "docs/文档索引.md",
+    "docs/文档事实源状态矩阵.md",
+    "docs/Agent开发交付实践.md",
+    ".trellis/spec/hyb-oa/"
+  ],
+  "notes": "No business code, no deployment, no production data writes. Historical Issue CSV files remain audit evidence and are not deleted.",
+  "meta": {
+    "contractMode": "trellis_task",
+    "intent": "governance_closeout"
+  }
+}
@@ -53,6 +53,15 @@ the rest conversationally.

 ## Status (update the checkboxes as you complete each item)

+- [x] Superseded by `.trellis/spec/hyb-oa/` project-specific specs.
+- [x] Bootstrap task retained only as historical setup evidence.
+
+The generated backend/frontend placeholder checklist below is no longer the
+active project guideline contract. hyb-oa uses `.trellis/spec/hyb-oa/` plus
+domain docs as the current spec entry point.
+
+### Historical generated checklist
+
 - [ ] Fill backend guidelines
 - [ ] Fill frontend guidelines
 - [ ] Add code examples
@@ -3,7 +3,7 @@
  "name": "00-bootstrap-guidelines",
  "title": "Bootstrap Guidelines",
  "description": "Fill in project development guidelines for AI agents",
-  "status": "in_progress",
+  "status": "completed",
  "dev_type": "docs",
  "scope": null,
  "package": null,
@@ -11,7 +11,7 @@
  "creator": "shunli",
  "assignee": "shunli",
  "createdAt": "2026-05-26",
-  "completedAt": null,
+  "completedAt": "2026-05-26",
  "branch": null,
  "base_branch": null,
  "worktree_path": null,
@@ -32,4 +32,4 @@
      "TRELLIS1-4"
    ]
  }
-}
+}
@@ -1,3 +1,3 @@
-{"file":".trellis/spec/hyb-oa/project-governance.md","reason":"Defines Trellis-first flow and Issue CSV binding rules."}
+{"file":".trellis/spec/hyb-oa/project-governance.md","reason":"Defines Trellis-first flow and legacy Issue CSV boundaries."}
 {"file":".trellis/spec/hyb-oa/docs-and-evidence.md","reason":"Defines docs/evidence reuse and registration requirements."}
 {"file":".trellis/spec/hyb-oa/security-privacy.md","reason":"Defines redaction and sensitive-data exclusions for Trellis task files."}
@@ -32,3 +32,9 @@ binding to Issue CSV and project documentation.

 - `python3 ./.trellis/scripts/task.py validate 05-26-trellis1-pilot`
 - `node scripts/qa/check-trellis-governance.mjs`
+
+## Closeout
+
+TRELLIS1 is complete as historical migration evidence. TRELLIS2 replaced the
+dual Trellis task plus Issue CSV binding with official Trellis task-first
+governance for new work.
@@ -3,7 +3,7 @@
  "name": "trellis1-pilot",
  "title": "TRELLIS1 low-risk pilot",
  "description": "Low-risk task used to prove the Trellis task -> Issue CSV -> governance check path without changing business code.",
-  "status": "in_progress",
+  "status": "completed",
  "dev_type": "docs",
  "scope": "trellis-governance",
  "package": "docs",
@@ -11,7 +11,7 @@
  "creator": "shunli",
  "assignee": "shunli",
  "createdAt": "2026-05-26",
-  "completedAt": null,
+  "completedAt": "2026-05-26",
  "branch": null,
  "base_branch": "main",
  "worktree_path": null,
@@ -32,4 +32,4 @@
      "TRELLIS1-7"
    ]
  }
-}
+}
@@ -11,8 +11,8 @@ holds the PRD, implementation context, verification context and finish record.
 - Make Trellis task the execution contract for new work.
 - Keep `docs/` as the business fact source.
 - Keep historical `issues/*.csv` files for audit and legacy lookup only.
- Update AGENTS, Trellis workflow, project governance spec, governance check,
-  project documentation and the hyb-oa delivery skill.
+- Update AGENTS, Trellis workflow, project governance spec, governance check
+  and project documentation.

 ## Out Of Scope

@@ -46,3 +46,8 @@ holds the PRD, implementation context, verification context and finish record.
 Do not store passwords, token, Secret, real invoice originals, contract bodies,
 bank materials, full accounts, complete local paths or raw payloads in Trellis
 tasks, docs, reports or chat.
+
+## Closeout
+
+TRELLIS2 is complete as the official task-first governance contract. Subsequent
+cleanup and stale-task archival is handled by `trellis-governance-closeout`.
@@ -3,7 +3,7 @@
  "name": "trellis2-official-task-contract",
  "title": "TRELLIS2 official task contract",
  "description": "Migrate hyb-oa development governance from Issue CSV binding to official Trellis task contracts.",
-  "status": "in_progress",
+  "status": "completed",
  "dev_type": "docs",
  "scope": "trellis-governance",
  "package": "docs",
@@ -11,7 +11,7 @@
  "creator": "shunli",
  "assignee": "shunli",
  "createdAt": "2026-05-26",
-  "completedAt": null,
+  "completedAt": "2026-05-26",
  "branch": null,
  "base_branch": "main",
  "worktree_path": null,
@@ -35,4 +35,4 @@
    "contractMode": "trellis_task",
    "supersedesPolicy": "TRELLIS1 dual-track Issue CSV binding"
  }
-}
+}