remove cloud-browser.md, fold Way 3 into browser-execute-guide.md

Single skill file is sufficient: agent can derive stop/swap behavior from the inline Way 3 example plus the BU API docs link. Rewrites guide intro and Way sections for concision, adds runtime self-discovery hints (Object.keys(session.domains), CdpError.data) so the agent can probe the CDP surface without docs round-trip. Updates README, src/index.ts, src/skills.ts, opencode comment, and skills test to drop cloud-browser.md references.

Author: bcode

packages/bcode-browser/README.md

@@ -12,7 +12,7 @@ See `decisions.md §1c` (three-level model) and `§1d` (this package) in the Bro
 | `src/browser-execute.ts` | In-process JS-eval `browser_execute` body. |
 | `src/session-store.ts` | Per-opencode-session CDP `Session` map. The agent calls `session.connect(...)` from a snippet; subsequent snippets find the same Session. |
 | `src/skills.ts` | Runtime resolver for embedded skills (extract on first call in compiled mode; in-tree path in dev). |
-| `skills/` | `browser-execute-guide.md` (the agent's prompt for `browser_execute`) and `cloud-browser.md` (Way 3 — provision/stop a Browser Use cloud browser via raw HTTP from inside a snippet). Embedded into the binary by `script/embed-skills.ts`. The interaction-skills set inherited from the Python harness was archived 2026-05-09 — we'll reintroduce only what evals show is needed, one skill at a time. |
+| `skills/` | `browser-execute-guide.md` (the agent's prompt for `browser_execute`, covering all three connection Ways including Browser Use cloud provisioning via raw HTTP from inside a snippet). Embedded into the binary by `script/embed-skills.ts`. The interaction-skills set inherited from the Python harness was archived 2026-05-09 — we'll reintroduce only what evals show is needed, one skill at a time. |
 | `script/embed-skills.ts` | Build-time embed; emits `bcode-skills.gen.ts` consumed by the compiled binary. |
 | `test/` | `bun test` smoke coverage for the workspace dynamic-import pattern. |
 

packages/bcode-browser/skills/browser-execute-guide.md

@@ -11,12 +11,12 @@
 //   src/browser-execute.ts — in-process JS-eval browser_execute body
 //   src/session-store.ts   — per-opencode-session CDP Session map
 //   src/skills.ts          — runtime resolver for embedded skills
-//   skills/                — browser-execute-guide.md + cloud-browser.md (embedded into binary)
+//   skills/                — browser-execute-guide.md (embedded into binary)
 //
 // Cloud browser provisioning is intentionally NOT a separate Level-1
-// surface. The agent reads `skills/cloud-browser.md` and writes the
-// fetch+connect snippet itself, matching how local-browser connect works
-// (snippet-side, not tool-side). Decisions trail in
+// surface. The agent reads Way 3 of `skills/browser-execute-guide.md` and
+// writes the fetch+connect snippet itself, matching how local-browser
+// connect works (snippet-side, not tool-side). Decisions trail in
 // `memory/browsercode/decisions.md` §3.4.
 //
 // Planned (per ROADMAP phase):

packages/bcode-browser/skills/cloud-browser.md

@@ -1,9 +1,8 @@
 // Skills directory resolver.
 //
 // Materializes the skills tree to `<dataDir>/skills/` and substitutes the
-// `{{SKILLS_DIR}}` placeholder in every file with that absolute path so
-// cross-references inside browser-execute-guide.md (``read `{{SKILLS_DIR}}/cloud-browser.md` ``)
-// point at a real location.
+// `{{SKILLS_DIR}}` placeholder in every file with that absolute path so any
+// cross-references inside the skill files point at a real location.
 //
 // Compiled launches (the user-facing path) read a one-line sentinel at
 // `<target>/.bcode-build` recording `<buildHash>:<target>`. When it matches

packages/bcode-browser/src/index.ts

@@ -16,7 +16,7 @@ test("resolveSkillsDir materializes skills with {{SKILLS_DIR}} substituted", asy
     expect(dir).toBe(path.join(dataDir, "skills"))
     const browser = (await fs.readFile(path.join(dir, "browser-execute-guide.md"), "utf8")).replaceAll("\\", "/")
     expect(browser).not.toContain("{{SKILLS_DIR}}")
-    expect(browser).toContain(`${dir.replaceAll("\\", "/")}/cloud-browser.md`)
+    expect(browser).toContain(`${dir.replaceAll("\\", "/")}/`)
   } finally {
     await fs.rm(dataDir, { recursive: true, force: true })
   }

packages/bcode-browser/src/skills.ts

@@ -25,10 +25,10 @@ export const BrowserExecuteTool = Tool.define(
   Effect.gen(function* () {
     const impl = yield* BrowserExecute.make(Global.Path.data)
     return {
-      // Substitute the resolved skills path so browser-execute-guide.md / cloud-browser.md
-      // references in the description point at concrete locations. Workspace
-      // is per-project and agent-discoverable from cwd, so it's not
-      // substituted here.
+      // Substitute the resolved skills path so `{{SKILLS_DIR}}` references in
+      // the description point at a concrete location. Workspace is
+      // per-project and agent-discoverable from cwd, so it's not substituted
+      // here.
       description: DESCRIPTION.replaceAll("{{SKILLS_DIR}}", impl.skillsDir),
       parameters: impl.parameters,
       execute: (args: Schema.Schema.Type<typeof impl.parameters>, ctx: Tool.Context) =>