Skip to content

fix(maintenance): keep accurate content and concrete values in maintenance runs - #191

Merged
chubes4 merged 1 commit into
mainfrom
fix/maintenance-preserve-accurate-content
Nov 15, 2026
Merged

chubes4 merged 1 commit into
mainfrom
fix/maintenance-preserve-accurate-content

Conversation

@chubes4

@chubes4 chubes4 commented Nov 15, 2026

Copy link
Copy Markdown
Contributor

Part 1 of #190 (maintenance deletions). Part 2 pins these packages and fixes the PR title.

Problem

Extra-Chill/extrachill#1493 (shop user-docs maintenance) removed accurate content:

  • whole accurate sections (Lifetime Membership, Event Boost);
  • a worked $25-shirt fee example;
  • the 30-day fee-change notice.

It replaced concrete values with "the current rate appears on the Payments tab". The maintenance packages said to fix drift but never said to keep accurate content, so the model treated the docs as a draft to rewrite.

Change

  • user-docs-maintenance-agent and technical-docs-maintenance-agent (the technical package had the same gap) gain a Preserve Accurate Content section:
    • keep accurate content word for word;
    • change only what source evidence contradicts or what is missing;
    • never delete a section, list item, or example unless the feature is gone from the source, and keep claims it cannot verify;
    • keep concrete, source-supported examples and numbers, and never replace them with vague pointers;
    • before finishing, run workspace_git_diff and restore any removal the source does not justify.
  • tests/native-agent.validate-package-spec.json declares content_preservation_phrases, and both maintenance agents set requires_content_preservation. tests/validate-docs-agent-packages.php fails if either package loses any of the phrases or if either maintenance package stops being checked. I verified it fails when one phrase is altered.
  • README: Maintenance Keeps Accurate Content section.

The workflow still runs the packages pinned at DOCS_AGENT_PACKAGE_REVISION. The follow-up PR advances it to this merge commit, along with the WP Codebox v0.33.7 pin and the PR-title fix.

AI assistance: Extra Chill Bot (Claude), via a Roadie subagent.

…nance runs

Both maintenance packages now treat existing docs as the baseline. They keep
accurate text word for word, change only what source evidence contradicts or
what is missing, delete a section only when its feature is gone from the source,
keep concrete source-backed examples and numbers, and review workspace_git_diff
before finishing. The package validator fails if either maintenance package
loses the rule.

Refs #190

AI assistance: Extra Chill Bot (Claude), via a Roadie subagent.
@chubes4
chubes4 merged commit 2f83a20 into main Nov 15, 2026
3 checks passed
chubes4 added a commit that referenced this pull request Nov 15, 2026
…serve-content packages (#192)

- WP Codebox v0.33.7 (9764022) uses an explicit runner_workspace.branch as
  given and makes workspace_git_status/diff work against the seed baseline
  (Automattic/wp-codebox#2591, #2592)
- pass docs_branch only as branch (no longer as branch_prefix), so the head is
  no longer <docs_branch><workload-id>
- title PRs and commits docs(<docs_scope>): <lane> docs <run_kind> via a new
  optional docs_scope input (default: repository name); the body links the run,
  writable paths and source delta and asks for human review
- advance DOCS_AGENT_PACKAGE_REVISION to 2f83a20 (#191) with the new technical
  maintenance, user bootstrap, and user maintenance package digests

Closes #190

AI assistance: Extra Chill Bot (Claude), via a Roadie subagent.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant