diff --git a/docs/superpowers/plans/2026-10-17-guidelines-governance-adoption.md b/docs/superpowers/plans/2026-10-17-guidelines-governance-adoption.md new file mode 100644 index 00000000..eb673d6e --- /dev/null +++ b/docs/superpowers/plans/2026-10-17-guidelines-governance-adoption.md @@ -0,0 +1,48 @@ +# Development-Guidelines 采纳 development-governance-v2 治理套件 任务卡 + +任务主记录:本文件随 Development-Guidelines 采纳 PR 描述维护(PR 链接见下方"结果与验证")。 +状态:进行中;owner:weichen。 + +本卡放在 Agent-System-Dev 而非 Development-Guidelines:后者的 CONTRIBUTING.md 规定"项目事实与过程记录不提交本库",AGENTS.md 规定不复制完整日志;其既往 PR #7/#8 的过程记录同样位于 Dev。证据日志位于同目录 `evidence/guidelines-adoption/`。 + +## 基线与授权 + +- 权威仓:weichen/Development-Guidelines;root_target:main;immediate_target:main +- branch_kind:initiative;initiative_id:governance-adoption-Development-Guidelines +- R0(initial_main_sha):2688fd2be6a52c0bf110e7e6366b6f291ab5e4eb;工作区:/home/weichen/projects/Development-Guidelines-wt-feature-governance-adoption(worktree);分支:feature/governance-adoption +- accepting_requirements:false(单仓采纳 initiative,范围固定为下列十步) +- 需求分流:verdict=NEW;理由=development-governance-v2 Phase 6 每个正式仓库独立 initiative;triage 收据=无(本仓无 triage 入口) +- 授权与交付终点:owner 已授权 development-governance-v2 全部实施(主记录 2026-10-16-development-governance-v2-master.md);终点为采纳 PR 合入 main 且采纳状态 active。分支保护与 tag 由用户执行。 +- 实施执行:agent-per-unit(配置:Development-Guidelines AGENT-EXECUTION.md;外部 Agent 一单元一新进程/会话/工作区) + +## 目标与非目标 + +目标(Phase 6 十步,规范源变体):规范源不固定自身 gitlink,治理检查以 `--guidelines-self` 运行(DM #20,0552b73);增加 AGENT-EXECUTION.md;共享执行器薄入口(deps/development-manager @ 0552b7358d6955057d6eea090326f83317ed992a + scripts/dm、scripts/agent-exec、scripts/task);四条路由;任务卡模板(.task/templates/task-card.md);CI schema 校验(.gitea/workflows/governance.yml:agent-exec validate + governance check --guidelines-self);正例;负例(缺配置、坏收据、越界路径、未知副作用);独立 Review + CI;采纳状态 active。 + +非目标:不改规范正文(core/ standards/ workflows/ templates/)、README、CHANGELOG、VERSION;不改分支保护;不发布 tag。 + +引导说明:AGENT-EXECUTION.md 由 host 以固定版本治理套件(dm-server governance init @ 0552b73)生成并作为引导配置提交(bootstrap 提交 f7904ff;沿用 DM 采纳先例);其余文件由实施单元生成。 + +## Agent 实施收据 + +| 单元 ID | 预期范围 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 | +|---|---|---|---|---|---|---|---|---|---| +| governance-adoption-Development-Guidelines-r1 | 11 个允许路径(治理文件 + deps/development-manager gitlink) | implementation | cursor→antigravity→pi | run d88c47f0(dm-server 0552b73,attempts=1) | cursor / not-observable | success | e82e76ef026d(apply 快进 e82e76e) | 否 | /tmp/gov-receipt-Development-Guidelines-r1.json | + +## 同步记录 + +| 节点 | sync_base_sha | tested_head_sha | checked_at | 结果 | +|---|---|---|---|---| +| 启动 | 2688fd2be6a52c0bf110e7e6366b6f291ab5e4eb | 2688fd2be6a52c0bf110e7e6366b6f291ab5e4eb | 2026-10-17T08:24:00Z | 一致 | + +## 结果与验证(完成后填写) + +- 结果:NOT_RUN +- 验证:见下表(命令输出由 ev.sh 写入 evidence/guidelines-adoption/,SELF 除非另注)。 +- 影响与剩余项:NOT_RUN + +| 时间(UTC) | 命令 | 被测 HEAD | exit | 来源 | 摘要/位置 | +|---|---|---|---|---|---| +| 20261017T083826Z | `scripts/dm governance check --repo . --guidelines-self` | e82e76ef026d | 0 | SELF | ok fixtures;[输出](evidence/guidelines-adoption/00-20261017T083826Z.log) sha256:4180c6acc02ae066 | +| 20261017T083826Z | `scripts/agent-exec validate --repo .` | e82e76ef026d | 0 | SELF | validate: ok;[输出](evidence/guidelines-adoption/01-20261017T083826Z.log) sha256:669adfbd9f1df9e6 | +| 20261017T083826Z | `python3 /tmp/gov-neg/adopt_cases.py .` | e82e76ef026d | 0 | SELF | [verdict] ALL PASS cases=5;[输出](evidence/guidelines-adoption/02-20261017T083826Z.log) sha256:f4e192e0f20271b8 | diff --git a/docs/superpowers/plans/evidence/guidelines-adoption/00-20261017T083826Z.log b/docs/superpowers/plans/evidence/guidelines-adoption/00-20261017T083826Z.log new file mode 100644 index 00000000..50621148 --- /dev/null +++ b/docs/superpowers/plans/evidence/guidelines-adoption/00-20261017T083826Z.log @@ -0,0 +1,19 @@ +command: scripts/dm governance check --repo . --guidelines-self +cwd: /home/weichen/projects/Development-Guidelines-wt-feature-governance-adoption +head: e82e76ef026de5ef35fc2395608432041bc17b6f +exit: 0 +utc: 20261017T083826Z +--- +ok gitlink guidelines: self (specification source) +ok gitlink deps/development-manager +ok agent-execution +ok file AGENTS.md +ok file PROJECT.md +ok file policy/guidelines-adoption.md +ok file .task/templates/task-card.md +ok executable scripts/agent-exec +ok executable scripts/hooks/pre-commit +ok executable scripts/dm +ok executable scripts/task +ok adoption status +ok fixtures diff --git a/docs/superpowers/plans/evidence/guidelines-adoption/01-20261017T083826Z.log b/docs/superpowers/plans/evidence/guidelines-adoption/01-20261017T083826Z.log new file mode 100644 index 00000000..aca6b1bb --- /dev/null +++ b/docs/superpowers/plans/evidence/guidelines-adoption/01-20261017T083826Z.log @@ -0,0 +1,7 @@ +command: scripts/agent-exec validate --repo . +cwd: /home/weichen/projects/Development-Guidelines-wt-feature-governance-adoption +head: e82e76ef026de5ef35fc2395608432041bc17b6f +exit: 0 +utc: 20261017T083826Z +--- +validate: ok diff --git a/docs/superpowers/plans/evidence/guidelines-adoption/02-20261017T083826Z.log b/docs/superpowers/plans/evidence/guidelines-adoption/02-20261017T083826Z.log new file mode 100644 index 00000000..f422f19f --- /dev/null +++ b/docs/superpowers/plans/evidence/guidelines-adoption/02-20261017T083826Z.log @@ -0,0 +1,13 @@ +command: python3 /tmp/gov-neg/adopt_cases.py . +cwd: /home/weichen/projects/Development-Guidelines-wt-feature-governance-adoption +head: e82e76ef026de5ef35fc2395608432041bc17b6f +exit: 0 +utc: 20261017T083826Z +--- +[object] Development-Guidelines-wt-feature-governance-adoption HEAD=e82e76ef026de5ef35fc2395608432041bc17b6f +PASS positive-run-apply: run exit=0 terminal=success apply exit=0 head=f2fb0241b685 +PASS missing-config: run exit=2 terminal=invalid-config validate exit=2 +PASS bad-receipt: apply exit=4 head_unchanged=True msg=apply: no local integrity record: changed paths do not match the transport diff +PASS out-of-scope-path: run exit=5 terminal=scope-expansion transport=False +PASS unknown-side-effect: run exit=4 terminal=failed-unknown transport=False +[verdict] ALL PASS cases=5