docs: clarify agent setup and text entry guidance

[thymikee]

Summary

Clarify agent-facing help so routine app-driving does not run doctor as setup, and make fill/type text-entry intent explicit.

Move doctor to human installation guidance and recovery/setup wording, while updating command summaries and manual QA help to steer agents toward fill --settle for replacing field values.

Validation

• pnpm exec vitest run src/cli/parser/tests src/utils/tests/command-schema-guards.test.ts src/commands/tests/command-surface-metadata.test.ts
• node ./node_modules/oxfmt/bin/oxfmt --check skills/agent-device/SKILL.md src/cli/parser/cli-help.ts src/cli/parser/tests/cli-help-topics.test.ts src/commands/interaction/metadata.ts src/commands/management/doctor.ts
• pnpm check:quick

[github-actions]

PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-07-08 19:36 UTC

[github-actions]

Size Report

Metric	Base	Current	Diff
JS raw	1.6 MB	1.6 MB	-314 B
JS gzip	508.6 kB	508.4 kB	-154 B
npm tarball	611.7 kB	611.5 kB	-183 B
npm unpacked	2.2 MB	2.2 MB	-383 B

Startup median (7 runs, lower is better):

Scenario	Base	Current	Diff
CLI --version	29.4 ms	28.5 ms	-0.9 ms
CLI --help	57.4 ms	58.0 ms	+0.5 ms

Top changed chunks:

Chunk	Raw diff	Gzip diff
dist/src/cli-help.js	-274 B	-93 B
dist/src/registry.js	-40 B	-61 B

[thymikee]

Review pass on 3fb9a4c: checked the docs/help/skill guidance diff and focused assertions. The change consistently moves doctor out of routine agent setup, keeps doctor in human installation/setup diagnostics, and clarifies fill replaces while type appends. Checks are 22/22 green. No actionable blockers found.