Skip to content

[WIP] Update docs for agent host - #10079

Draft
ntrogh wants to merge 15 commits into
mainfrom
ntrogh/ah-default
Draft

[WIP] Update docs for agent host#10079
ntrogh wants to merge 15 commits into
mainfrom
ntrogh/ah-default

Conversation

@ntrogh

@ntrogh ntrogh commented Jul 31, 2026

Copy link
Copy Markdown
Collaborator

Summary

This PR restructures the AI agent documentation around the Agent Host, agent harnesses, and sessions model.

  • Consolidates the separate Local, Copilot, Claude/Codex, and cloud-agent pages into a unified agent harness guide.
  • Adds conceptual documentation for agent harnesses, sessions, and handoff, plus a practical handoff guide.
  • Adds a streamlined agent quickstart for both the Chat view and Agents window.
  • Updates the AI-generated code review guidance for Agent Host sessions. Edits are saved directly and reviewed through diffs, Source Control, worktrees, or pull requests; the older pending-edit workflow remains documented as a legacy fallback.
  • Refreshes terminology and cross-links throughout the agent, customization, security, enterprise, and getting-started documentation.
  • Updates navigation, redirects, and the sitemap for the new information architecture.
  • Adds guidance for using Copilot beyond VS Code, including terminal, GitHub, mobile, and remote workflows.

Most of the deleted content was consolidated into the new agent harness documentation rather than removed.

Validation

  • Reviewed navigation and redirects for the restructured pages.
  • Checked terminology and cross-references across the affected documentation.

@ntrogh

ntrogh commented Jul 31, 2026

Copy link
Copy Markdown
Collaborator Author

Remaining tasks:

  • Deploy and validate in test environment
  • Add and update screenshots
  • Full read-through and edit pass
  • Revisit the agents tutorial to remove the local harness
  • Fix issue Agents toc
  • Add getting started tutorial for agent-first experience with AW
  • Add tutorial for working only with BYOK

@ntrogh ntrogh changed the title Update docs for agent host [WIP] Update docs for agent host Jul 31, 2026
@ntrogh
ntrogh requested a review from bamurtaugh July 31, 2026 12:52
Comment thread docs/agent-customization/prompt-files.md Outdated
Comment thread docs/agents/concepts/agent-harnesses.md Outdated
ntrogh and others added 3 commits August 3, 2026 10:30
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