Skip to content

Trim eight docs and skill files near their word budget - #249

Merged
dinoderek merged 1 commit into
mainfrom
task/engine-228
Nov 20, 2026
Merged

dinoderek merged 1 commit into
mainfrom
task/engine-228

Conversation

@dinoderek

Copy link
Copy Markdown
Owner

Objective

Trim eight docs and skill files that sit near their word budgets, so later tasks in plan p226 can add text without raising a budget. No rule, fact or load trigger is removed; budgets in scripts/doc-budgets.tsv are unchanged.

Gates

Lane Result Evidence
./dev test (every required lane) PASS .test-ai-results/summary.md (local, after the final edit)
  • New or changed tests: none. Docs-only change; docs-check and versions are the proving lanes.
  • Not run, with reason: none.

Rulings

None. Operator answer followed: option (a) on the card's 90% target, given on task t228 (ask 1608, resolved 1610); plan ruling on budgets from plan p226 (update 1609).

Review

  • Fresh reviewer: Claude, model claude-opus-5-5. Round 1: CHANGES REQUESTED (two blocking losses: UI security sentence and the tailnet credential line, plus several low items). Round 2 after restoring those facts: APPROVED.
  • Declined findings: round 2 low items. (a) Removed "so a queued PR's changes are found at its turn" from coordinator.md: it explained why waiting entries are not called; the rule stays. (b) Removed the merge-ready worked example from engine/references/server.md: the rule and pointer format stay.
  • Review hard: docs/control-server.md (Dashboard section, the restored security sentences), docs/coordinator.md (merge queue paragraph), plugins/engine/skills/engine/references/server.md (executor step 10).

Deviations

  • Target not met. The card asks each file to sit at or below about 90% of its budget. Files now sit at: docs/coordinator.md 1342/1375 (98%), docs/control-server.md 1257/1300 (97%), docs/hosts-and-sessions.md 1041/1050 (99%), docs/harnesses.md 576/580 (99%), docs/operator-setup.md 1639/1710 (96%), build/SKILL.md 1160/1200 (97%), build/references/hard-stops.md 569/600 (95%), engine/references/server.md 1139/1200 (95%). Reaching 90% would drop facts the card forbids. The operator chose to keep budgets as the ceiling (task t228, ask 1608, resolved 1610).
  • Plugin version bumped 0.18.0 to 0.18.1 in both plugin.json files, as the card requires.

🤖 Generated with Claude Code

Cut wording that repeats itself or restates code, keeping every rule, fact
and load trigger. Each file stays under its budget in scripts/doc-budgets.tsv,
which is unchanged. Bump the engine plugin to 0.18.1 in both manifests.

Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012F3VVDjuqMggKGp1hvprbJ
@dinoderek
dinoderek merged commit d6f3a5d into main Nov 20, 2026
1 check passed
@dinoderek
dinoderek deleted the task/engine-228 branch November 20, 2026 09:39
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