Skip to content

[docs] Consolidate developer specifications into instructions file (v9.22)#48016

Merged
pelikhan merged 1 commit into
mainfrom
docs/consolidate-dev-instructions-v9-22-9d233d43bd0f9c78
Jul 25, 2026
Merged

[docs] Consolidate developer specifications into instructions file (v9.22)#48016
pelikhan merged 1 commit into
mainfrom
docs/consolidate-dev-instructions-v9-22-9d233d43bd0f9c78

Conversation

@github-actions

@github-actions github-actions Bot commented Jul 25, 2026

Copy link
Copy Markdown
Contributor

Summary

Maintenance tone scan pass (v9.22) over scratchpad documentation. Fixed one previously-missed subjective phrase in scratchpad/breaking-cli-rules.md and updated the developer instructions version metadata.

Changes

File Type Description
scratchpad/breaking-cli-rules.md doc Replaced subjective migration guide phrasing: 'making affected workflows easy to identify' replaced with 'reports the offending workflow'. Describes concrete schema validation behavior rather than editorializing.
scratchpad/dev.md doc Version bump 9.21 to 9.22; added v9.22 history entry recording the tone fix and confirming the rest of scratchpad/ (63 files) and specs/ (10 files) are clean.

Scope

  • No logic, tests, configuration, or generated files changed.
  • No public APIs, CLI flags, or config keys affected.
  • Breaking change: no.

Motivation

The v9.22 tone scan identified one residual subjective intensifier ('easy to identify') inside an example changeset code fence in breaking-cli-rules.md. Prior passes skipped it because it was embedded within a fenced code block. The fix aligns with the established pattern of removing vague qualifiers in favour of stating concrete, observable behavior.

References:

Generated by PR Description Updater for #48016 · sonnet46 · 30.2 AIC · ⌖ 7.43 AIC · ⊞ 4.8K ·

….22)

Weekly tone/consistency maintenance pass over scratchpad/ and specs/.

- Fixed 1 previously-missed tone issue in breaking-cli-rules.md:220
  (removed subjective 'easy to identify' clause; stated concrete
  schema-validation-error behavior).
- Rescanned scratchpad/ (63 spec files) and specs/ (10 files): otherwise
  clean of marketing/subjective language.
- Bumped dev.md to v9.22 (2026-07-25) and appended a Document History entry.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@github-actions github-actions Bot added automation documentation Improvements or additions to documentation labels Jul 25, 2026
@pelikhan
pelikhan merged commit d377a0c into main Jul 25, 2026
@pelikhan
pelikhan deleted the docs/consolidate-dev-instructions-v9-22-9d233d43bd0f9c78 branch July 25, 2026 14:15
@github-actions

Copy link
Copy Markdown
Contributor Author

🎉 This pull request is included in a new release.

Release: v0.83.4

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automation documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant