Skip to content

docs(features): explain the Claude Code integration from a user view - #710

Merged
jeduden merged 1 commit into
mainfrom
claude/mdsmith-claude-docs-rework-5k0ivj
Jun 29, 2026
Merged

docs(features): explain the Claude Code integration from a user view#710
jeduden merged 1 commit into
mainfrom
claude/mdsmith-claude-docs-rework-5k0ivj

Conversation

@jeduden

@jeduden jeduden commented Jun 29, 2026

Copy link
Copy Markdown
Owner

Why

The "Editors and agents" feature page
(docs/features/editor-agent-integration.md) was written almost
entirely around the VS Code extension. It named only two of the five
user-facing Claude Code plugins (mdsmith-lsp and the audit skill) and
gave a reader no way to learn what the integration does or how to turn
it on. A user who wants mdsmith in Claude Code left the page no better
informed.

What changed

Reworked the page so the agent story gets concrete, user-facing
coverage, balanced with the editor story:

  • Lead with the payoff. One rule engine; the check that gates a CI
    merge is the same one the editor shows you and the same one the agent
    sees as it edits — no second config or ruleset.
  • Describe each plugin by what it does for the user: mdsmith-lsp
    (inline diagnostics + navigation), mdsmith-autofix (post-edit
    mdsmith fix hook), the three slash commands (/mdsmith-fix,
    /mdsmith-check, /mdsmith-kinds), the markdown-reviewer subagent,
    and the /markdown-audit skill.
  • Show how to use it: the one /plugin marketplace add jeduden/mdsmith
    line, then a link to the install guide's existing
    Claude Code plugins section
    for per-plugin commands and prerequisites.
  • Trust signal: noted that mdsmith makes no network call of its own,
    linking the telemetry policy.
  • Kept the synced VS Code <?include?> block and the
    progressive-disclosure pairing.

Refreshed summary to reflect the broader integration. That cascades
through the CLAUDE.md catalog and the AGENTS.md /
copilot-instructions.md includes, which were regenerated with
mdsmith fix.

No new doc file was needed — the per-plugin setup steps already live in
the install guide; this page now points there.

Verification

  • mdsmith check . passes (519 files, 0 failures).
  • Applied the docs-author global-English and anti-slop passes: short
    sentences, no banned vocabulary or openers, no em-dashes in the new
    prose, no bold-label-colon list rhythm.

🤖 Generated with Claude Code

https://claude.ai/code/session_01K1ba2VNTt2KcoVSwmRMBvz


Generated by Claude Code

The "Editors and agents" feature page named only two of the five
Claude Code plugins and gave no path to install or use them. Rework
the page so the agent story gets concrete, user-facing coverage:

- Lead with the shared-engine payoff for editor and agent together.
- Describe what each plugin does for the user: mdsmith-lsp,
  mdsmith-autofix, the three slash commands, the markdown-reviewer
  subagent, and the markdown-audit skill.
- Add the one marketplace-register line and link to the install
  guide's Claude Code section for per-plugin setup.
- Note mdsmith makes no network call of its own, linking telemetry.

Refresh the summary, which cascades into the CLAUDE.md catalog and
the AGENTS.md / copilot-instructions includes.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01K1ba2VNTt2KcoVSwmRMBvz
@codecov

codecov Bot commented Jun 29, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 98.63%. Comparing base (86dc716) to head (9696daf).
⚠️ Report is 8 commits behind head on main.

Additional details and impacted files
Components Coverage Δ
Go 98.62% <ø> (+<0.01%) ⬆️
TypeScript 99.54% <ø> (ø)

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@jeduden jeduden added queue Add to a PR to enqueue it queue:active Applied automatically when a PR is in an active batch and removed queue Add to a PR to enqueue it labels Jun 29, 2026
@jeduden

jeduden commented Jun 29, 2026

Copy link
Copy Markdown
Owner Author

🟢 Merge Queue — picked up

This PR is in the queue and will be batched with other queue-labelled PRs.

Next: No action needed — you'll get another comment when CI starts on the batch. View merge queue run.

@jeduden

jeduden commented Jun 29, 2026

Copy link
Copy Markdown
Owner Author

🔵 Merge Queue — CI running

Merged into batch branch merge-queue/batch-710-1782761070. View CI run.

Next: No action needed — you'll be notified when CI completes.

@jeduden jeduden removed the queue:active Applied automatically when a PR is in an active batch label Jun 29, 2026
@jeduden
jeduden merged commit 0314c10 into main Jun 29, 2026
36 checks passed
@jeduden

jeduden commented Jun 29, 2026

Copy link
Copy Markdown
Owner Author

Merge Queue — merged

This PR landed on main via commit 0314c10. CI run that validated the merge.

Next: Done — nothing more to do here.

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.

2 participants