docs: fine-tune migration guides

[rachaelrenk]

Summary

Fine-tunes the Migrate to Warp guides for Ghostty and related migration pages so the Agent-assisted migration flow is clearer and the procedures are easier to follow.

Changes

• Clarifies that non-importer migration paths use readable config files as source material for Warp's Agent to translate into settings.toml.
• Replaces fragmented Warp-native equivalents table intros with explicit, reader-oriented statements.
• Tightens numbered steps for Agent Mode prompts, diff review, and Settings UI paths.
• Applies similar contextual cleanup across Ghostty, iTerm2, macOS Terminal, Windows Terminal, VS Code terminal, Cursor, and Claude Code migration guides.

Validation

• python3 .agents/skills/style_lint/style_lint.py --changed
• python3 .agents/skills/validate_ui_refs/validate_ui_refs.py --all against temporary .md copies of the migration MDX files

Build note: npm run build could not run in this worktree because astro is not installed on PATH.

Conversation: https://staging.warp.dev/conversation/da3ace50-7d75-447d-afdf-06021a2a1fb7

Co-Authored-By: Oz oz-agent@warp.dev

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview, Comment	May 20, 2026 12:27am

[oz-for-oss]

@rachaelrenk

I'm starting a first review of this pull request.

You can view the conversation on Warp.

I completed the review and no human review was requested for this pull request.

Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

[oz-for-oss]

Overview

This PR fine-tunes the migration guides for Claude Code, Cursor, Ghostty, iTerm2, macOS Terminal, VS Code terminal, and Windows Terminal. The changes clarify when Warp can use readable source configuration files, tighten Agent Mode migration steps, and improve Settings UI path context without adding code or configuration risk.

Concerns

• No blocking concerns found in the reviewed diff.
• No approved spec context was available, so there were no spec commitments to compare against.
• Security pass: documentation-only changes did not introduce a concrete security concern.

Verdict

Found: 0 critical, 0 important, 0 suggestions

Approve

Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz