docs: fix architecture tree, network domain attribution, and workspace defaults reference (#353)

* Initial plan

* docs: fix architecture tree, network domain attribution, and workspace defaults reference

Agent-Logs-Url: https://github.com/githubnext/ado-aw/sessions/30b5ebbc-f42c-4ff2-bc93-d56f6f5593a4

Co-authored-by: jamesadevine <4742697+jamesadevine@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: jamesadevine <4742697+jamesadevine@users.noreply.github.com>

Author: Copilot

AGENTS.md

@@ -114,6 +114,7 @@ Every compiled pipeline runs as three sequential jobs:
 │           ├── mod.rs
 │           ├── extension.rs # CompilerExtension impl (compile-time)
 │           └── execute.rs   # Stage 3 runtime (validate/copy)
+├── ado-aw-derive/        # Proc-macro crate: #[derive(SanitizeConfig)], #[derive(SanitizeContent)]
 ├── examples/             # Example agent definitions
 ├── tests/                # Integration tests and fixtures
 ├── docs/                 # Per-concept reference documentation (see index below)

docs/front-matter.md

@@ -22,7 +22,7 @@ schedule: daily around 14:00 # Fuzzy schedule syntax - see docs/schedule-syntax.
 #   branches:
 #     - main
 #     - release/*
-workspace: repo # Optional: "root", "repo" (alias: "self"), or a checked-out repository alias. If not specified, defaults based on checkout configuration (see below).
+workspace: repo # Optional: "root", "repo" (alias: "self"), or a checked-out repository alias. If not specified, defaults to "root" when no additional repositories are listed in `checkout:`, and to "repo" when one or more additional repos are checked out. See "Workspace Defaults" below.
 pool: AZS-1ES-L-MMS-ubuntu-22.04 # Agent pool name (string format). Defaults to AZS-1ES-L-MMS-ubuntu-22.04.
 # pool:                        # Alternative object format (required for 1ES if specifying os)
 #   name: AZS-1ES-L-MMS-ubuntu-22.04
@@ -111,3 +111,19 @@ parameters:                    # optional ADO runtime parameters (surfaced in UI
 
 Build the project and run all tests...
 ```
+
+## Workspace Defaults
+
+The `workspace:` field controls which directory the agent runs in. When it is
+not set explicitly, the compiler chooses a default based on the `checkout:`
+list:
+
+- If `checkout:` is empty (i.e. only the pipeline's own repository is checked
+  out via the implicit `self`), `workspace:` defaults to **`root`** — the
+  agent runs in the pipeline's working directory root.
+- If `checkout:` lists one or more additional repository aliases,
+  `workspace:` defaults to **`repo`** — the agent runs inside the first
+  checked-out repository's directory.
+
+Set `workspace:` explicitly to `root`, `repo` (alias `self`), or a specific
+checked-out repository alias to override this behavior.

docs/network.md

@@ -10,7 +10,7 @@ The `ado-aw` compiler binary is distributed via [GitHub Releases](https://github
 
 ## Default Allowed Domains
 
-The following domains are always allowed (defined in `allowed_hosts.rs`):
+The following domains are always allowed. Most are defined in `CORE_ALLOWED_HOSTS` in `allowed_hosts.rs`; `host.docker.internal` is the exception — it is added by the standalone compiler in `generate_allowed_domains` (`src/compile/common.rs`) because standalone pipelines always use MCPG, which needs host access from the AWF container:
 
 | Host Pattern | Purpose |
 |-------------|---------|
@@ -46,7 +46,7 @@ The following domains are always allowed (defined in `allowed_hosts.rs`):
 | `dc.services.visualstudio.com` | Visual Studio telemetry |
 | `rt.services.visualstudio.com` | Visual Studio runtime telemetry |
 | `config.edge.skype.com` | Configuration |
-| `host.docker.internal` | MCP Gateway (MCPG) on host |
+| `host.docker.internal` | MCP Gateway (MCPG) on host — added by the standalone compiler, not part of `CORE_ALLOWED_HOSTS` |
 
 ## Adding Additional Hosts