Skip to content

docs(update): clarify doctor read-only behavior - #581

Open
edrlu wants to merge 1 commit into
Panniantong:mainfrom
edrlu:agent/fix-stale-update-guide
Open

docs(update): clarify doctor read-only behavior#581
edrlu wants to merge 1 commit into
Panniantong:mainfrom
edrlu:agent/fix-stale-update-guide

Conversation

@edrlu

@edrlu edrlu commented Aug 6, 2026

Copy link
Copy Markdown

Summary

  • describe agent-reach doctor as read-only
  • keep skill refresh explicit and warn that it replaces local customizations
  • explain verified backends and the expected active_backend: null state
  • add a regression test for the update guide

Why

The update guide contradicted Doctor's current read-only safety boundary and implied that every multi-backend channel always reports an active backend.

Closes #580.

Impact

Update agents will no longer expect diagnostics to modify skill files or treat an intentionally unverified backend as an error.

Validation

  • uv run pytest -q
  • uv run ruff check agent_reach tests
  • uv run mypy agent_reach
  • git diff --check origin/main...HEAD

@edrlu
edrlu marked this pull request as ready for review August 7, 2026 00:52
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.

docs(update): correct doctor read-only and backend verification guidance

1 participant