Skip to content

DOCS-1526 - Add Bulk Changes guardrails to CLAUDE.md#6720

Merged
kimsauce merged 3 commits into
DOCS-1640from
staging/DOCS-1526
Jun 5, 2026
Merged

DOCS-1526 - Add Bulk Changes guardrails to CLAUDE.md#6720
kimsauce merged 3 commits into
DOCS-1640from
staging/DOCS-1526

Conversation

@kimsauce
Copy link
Copy Markdown
Collaborator

Purpose of this pull request

This pull request adds a short Bulk Changes section to CLAUDE.md capturing the non-obvious lessons from the DOCS-63 sumo language tag post-mortem (don't revert from memory, atomic commits per directory, no committed helper scripts, dry-run before writing).

Why this instead of a /bulk-doc-change skill

DOCS-1526 originally proposed a full /bulk-doc-change skill. After evaluation, a slim CLAUDE.md section is the better fit:

  • Newer Claude models already handle most of the workflow (scope clarification, dry-run, batched application) naturally with a careful prompt.
  • The genuinely unique value is the institutional guardrails from DOCS-63 — those need durable storage, but they don't need a five-step skill wrapper around them.
  • Keeps the surface area small. If a future bulk task reveals patterns worth automating, we can build the skill then with real-world signal.

Select the type of change

  • Minor Changes - Typos, formatting, slight revisions
  • Update Content - Revisions, updating sections
  • New Content - New features, sections, pages, tutorials
  • Site and Tools - .clabot, version updates, maintenance, dependencies, new packages for the site (Docusaurus, Gatsby, React, etc.)

Ticket (if applicable)

https://sumologic.atlassian.net/browse/DOCS-1526

kimsauce and others added 3 commits May 20, 2026 09:43
* DOCS-1634 - Fix MCP server and OAuth docs

- Remove VS Code and ChatGPT sections from MCP server doc; scope prereqs to any OAuth 2.0 Authorization Code-compatible client
- Fix claude mcp add command syntax for --client-secret flag
- Expand OAuth client setup steps inline for Claude Code CLI
- Soften prerequisite language in both docs
- Rewrite Auth Code flow Step 2 to be actionable
- Replace hardcoded deployment URLs with <token-endpoint-URL> and <api-endpoint> placeholders in Client Credentials Step 3
- Add deployment token endpoint table to FAQ
- Fix /oauth/token typo to /oauth2/token throughout

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* DOCS-1634: Add Known limitations section to MCP server doc

Documents that Cursor (cursor:// redirect URLs unsupported) and recent
VS Code releases (auth code flow broken with explicit client credentials)
are not currently supported. Includes a note to contact support.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Bumps [webpack-dev-server](https://github.com/webpack/webpack-dev-server) from 5.2.2 to 5.2.4.
- [Release notes](https://github.com/webpack/webpack-dev-server/releases)
- [Changelog](https://github.com/webpack/webpack-dev-server/blob/main/CHANGELOG.md)
- [Commits](webpack/webpack-dev-server@v5.2.2...v5.2.4)

---
updated-dependencies:
- dependency-name: webpack-dev-server
  dependency-version: 5.2.4
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Distill the DOCS-63 post-mortem lessons into a short CLAUDE.md section
instead of a full bulk-doc-change skill. Newer models handle most of
the workflow naturally; only the non-obvious institutional rules
(no revert from memory, atomic commits per directory, no committed
helper scripts) need to persist as durable guidance.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@kimsauce kimsauce self-assigned this May 20, 2026
@cla-bot cla-bot Bot added the cla-signed Contributor approved, listed in .clabot file label May 20, 2026
@kimsauce kimsauce added the do-not-merge Pull requests that should not be merged label May 20, 2026
@kimsauce kimsauce changed the base branch from main to DOCS-1640 June 5, 2026 07:58
@kimsauce kimsauce marked this pull request as ready for review June 5, 2026 07:58
@kimsauce kimsauce merged commit 29aebb6 into DOCS-1640 Jun 5, 2026
8 checks passed
@kimsauce kimsauce deleted the staging/DOCS-1526 branch June 5, 2026 07:58
@kimsauce kimsauce restored the staging/DOCS-1526 branch June 5, 2026 08:03
@kimsauce kimsauce deleted the staging/DOCS-1526 branch June 5, 2026 08:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cla-signed Contributor approved, listed in .clabot file do-not-merge Pull requests that should not be merged

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant