Skip to content

docs(audits): archive the four unreferenced 2026-06 audits (minimum arm) - #26925

Merged
objectstack-fleet[bot] merged 1 commit into
mainfrom
claude/project-thread-n0e8b2
Oct 27, 2026
Merged

objectstack-fleet[bot] merged 1 commit into
mainfrom
claude/project-thread-n0e8b2

Conversation

@objectstack-fleet

Copy link
Copy Markdown
Contributor

Requested by Warren · project thread

Refs #26257 — minimum arm (triage 6431037536, claim 6454039459). The card stays open: the fuller arm (the 14 packages/spec-cited 2026-06 files, their liveness/*.json _note paths and zod comments, a spec patch changeset and regenerated references) still needs a domain:spec review, and the 6 ADR-cited files stay in place under either arm.

Clause-②: no
Metadata-protocol: none

维护者速读

  • 改了什么:把 4 份已无任何入链的 2026-06 审计文档用 git mv 移入 docs/audits/archive/2026-06/,并改好 README 索引三行与一份文档里的三个 ADR 相对链接。
  • 为什么改:落实 [Decision] Eight obsolete planning docs, a stale ARCHITECTURE.md, a 1,576-line CHANGELOG [Unreleased] stuck at 11.10.0 and 44 audit files with no retention rule: delete, archive, or keep with banners #26075 裁决 A 的「已关闭审计归档」一半中的最小臂;只动无人引用的文件,零发布面。
  • 风险与回滚:仅 docs,不发布;回滚即 revert 本 PR。无 ADR、无 packages/spec 改动,无删除。
  • 先看:docs/audits/README.md(三行索引路径),docs/audits/archive/2026-06/2026-06-ask-build-agent-development-assessment.md(ADR 链接改为 ../../../adr/)。
  • 两分钟验证:git grep -nE "2026-06-(ask-build-agent-development-assessment|datasetschema-property-liveness|pageschema-property-liveness|system-integration-property-liveness)" | grep -v archive/2026-06/ 预期零输出。
  • 需要你做的:无,席位落地。

What changes

  • git mv (pure renames, 100% similarity for three) of docs/audits/2026-06-{ask-build-agent-development-assessment,datasetschema-property-liveness,pageschema-property-liveness,system-integration-property-liveness}.md into docs/audits/archive/2026-06/.
  • docs/audits/README.md: the three per-type index rows (page, dataset, system/integration) now name archive/2026-06/…. The README's existing lifecycle line already says closed audits move to docs/audits/archive/, so no new prose.
  • archive/2026-06/2026-06-ask-build-agent-development-assessment.md: its three relative ADR links (ADR-0040, 0063, 0064; five occurrences) are re-rooted from ../adr/ to ../../../adr/ so they still resolve from the deeper directory. Content otherwise unchanged.

Tests

Docs-only move; no code or tests touched.

Acceptance notes

  • Re-measured on origin/main 5ce3404 before moving: the four bare filenames had no inbound reference anywhere in the tree except README rows L16, L19 and L28; ask-build-agent-development-assessment had none at all. Matches the claim's premise.
  • Not done here (out of the minimum arm): the 14 spec-cited and 6 ADR-cited 2026-06 files stay in docs/audits/.

Verification

Local gates on 907b582
pnpm check:doc-authoring :: exit 0   (439 files clean; 69 skill files clean; spec strings clean)
pnpm check:adr-links     :: exit 0   (907 relative link destinations under docs/adr/ resolve)
relative-link resolver over docs/audits/README.md + docs/audits/archive/2026-06/*.md :: 9 links checked, 0 dead
git grep for the four old paths outside archive/2026-06/ :: 0 hits

The lychee Check Documentation Links lane was not run locally (the binary download was refused in this container); CI runs it over docs/**/*.md.

Human Minimum

  • 1. Schemas start as Zod; packages/spec holds no runtime logic. (not touched)
  • 2. Every name I added uses the casing for its kind.
  • 3. No formatter ran; pnpm lint not run locally (markdown-only diff), CI runs it.
  • 4. One issue, one branch off an up-to-date main, one pull request.
  • 5. A change that publishes carries a changeset — nothing publishes (docs/** is in no package's files[]), so skip-changeset.
  • 6. packages/spec touched: n/a.
  • 7. No hand edits to content/docs/references/, packages/*/CHANGELOG.md or content/docs/releases/.
  • 8. Title, body and comments are in English (the 维护者速读 block is the os-dev contract's Chinese digest).

🤖 Generated with Claude Code


Generated by Claude Code

Move ask-build-agent-development-assessment, datasetschema-property-liveness,
pageschema-property-liveness and system-integration-property-liveness into
docs/audits/archive/2026-06/ with git mv. Their only inbound references were
three docs/audits/README.md index rows, now repointed; the ask-build file's
three relative ADR links are re-rooted for the deeper directory.

No ADR, no ADR-cited file and nothing under packages/spec is touched; the
fuller arm (the 14 spec-cited files) stays open on the card.

Co-Authored-By: Claude <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JQwxbZzDBLnRBSB3n3b113
@objectstack-fleet objectstack-fleet Bot added the skip-changeset PR has no user-facing published change; bypasses the changeset gate label Oct 27, 2026
@github-actions github-actions Bot added size/s documentation Improvements or additions to documentation labels Oct 27, 2026
@objectstack-fleet

Copy link
Copy Markdown
Contributor Author

维护者速读

  • 改了什么:把 4 份已过时的 2026-06 审计文档用 git mv 移到 docs/audits/archive/2026-06/,README 的 3 行索引改指新位置,移动后那份 ask-build 文档里的 ADR 链接改成 ../../../adr/ 前缀,不留断链。
  • 为什么改:卡片 docs(audits): archiving the 24-file 2026-06 audit series is not docs-only — 20 of the files are cited by ADRs or by @objectstack/spec's published liveness notes #26257 要清理过期审计文档。这是最小的一半:只移没有被规范引用的文件。
  • 风险与回滚:只移文档和改链接,5 个文件 +6/−6,不碰代码、CI、依赖。回滚 = revert 本 PR。
  • 先看:README 第 16、19、28 行,和 ask-build 文档里改过前缀的 ADR 链接。
  • 两分钟验证:pnpm check:doc-authoring 和 pnpm check:adr-links,都退出 0。
  • 需要你做的:无,席位落地。本 PR 写的是 Refs,卡片不会关闭。
  • 席位意见:还有 14 份被规范引用的文件,需要 spec 车道审过才能动,卡片回到队列等那一半。

席位核对

ACCEPT · domain:devx#1 · session_01JQwxbaFpnMwgpCgneKe2qS · head 907b582a6b · 2026-10-27T21:48Z

  1. Shape: 5 paths, +6/−6: four renames into docs/audits/archive/2026-06/ (ask-build-agent-development-assessment, datasetschema-, pageschema- and system-integration-property-liveness) and docs/audits/README.md. Not governed (check-governed-merges --pr 26925). File surface as in claim 6454039459; Refs #26257 (minimum arm).
  2. Read by the seat: the whole diff. All four moves are pure renames. README rows L16, L19 and L28 point at archive/2026-06/.... The only relative links that break on the move are the ADR links in the ask-build file, and they are re-rooted to ../../../adr/.
  3. Gates: head check-runs on 907b582a6b: 27 success, 17 skipped, 0 failing; check-expected-skips --pr 26925: OK; mergeable clean. Thread's local run: check:doc-authoring and check:adr-links both exit 0. Report 6454135221.
  4. Accepted deviations: lychee was not run locally; the CI link check on this head covers it.
  5. Out of scope: the 14 spec-cited audit files stay where they are until a domain:spec review; that is the fuller arm of docs(audits): archiving the 24-file 2026-06 audit series is not docs-only — 20 of the files are cited by ADRs or by @objectstack/spec's published liveness notes #26257. Skills-docs: not owed.
  6. Landing: not governed, CI green on this head, mergeable clean ⇒ the seat readies it and arms auto-merge through the relay. At merge docs(audits): archiving the 24-file 2026-06 audit series is not docs-only — 20 of the files are cited by ADRs or by @objectstack/spec's published liveness notes #26257 stays open, goes back to pm:queue with no assignee, and gets a partial-landing note.

@objectstack-fleet
objectstack-fleet Bot marked this pull request as ready for review October 27, 2026 21:50
@objectstack-fleet
objectstack-fleet Bot enabled auto-merge October 27, 2026 21:50
@objectstack-fleet
objectstack-fleet Bot added this pull request to the merge queue Oct 27, 2026
Merged via the queue into main with commit 73d45a5 Oct 27, 2026
45 checks passed
@objectstack-fleet
objectstack-fleet Bot deleted the claude/project-thread-n0e8b2 branch October 27, 2026 22:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size/s skip-changeset PR has no user-facing published change; bypasses the changeset gate

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants