From c351dcf3cf1b58d5e22adbbe948e6348e3cbfb03 Mon Sep 17 00:00:00 2001
From: lightight <bholt2213@gmail.com>
Date: Fri, 24 Jul 2026 08:24:27 -0700
Subject: [PATCH 1/2] docs: remove stale 'oss/' paths from build walkthroughs

The repository root is already the OSS workspace, so 'cd oss' fails on a
fresh clone and 'pnpm --dir oss' / 'cd oss/packages/cli' reference a
layout that no longer exists. Remove the stale step and fix the package
commands to run from the clone root.

Fixes #359
---
 docs/getting-started.md | 1 -
 docs/reference.md       | 7 +++----
 docs/skill-to-graph.md  | 1 -
 3 files changed, 3 insertions(+), 6 deletions(-)

diff --git a/docs/getting-started.md b/docs/getting-started.md
index f9a94df9e..5acfdcf9f 100644
--- a/docs/getting-started.md
+++ b/docs/getting-started.md
@@ -14,7 +14,6 @@ checked-in `examples/hello-world` package so the commands stay tied to the repo.
 Build the native CLI from the OSS workspace:
 
 ```bash
-cd oss
 cargo build --manifest-path crates/Cargo.toml -p runx-cli
 ```
 
diff --git a/docs/reference.md b/docs/reference.md
index f285b719a..5fa4a3b03 100644
--- a/docs/reference.md
+++ b/docs/reference.md
@@ -12,7 +12,6 @@ The npm CLI package is `@runxhq/cli` and exposes the `runx` binary.
 Start with the checked-in hello-world skill:
 
 ```bash
-cd oss
 cargo build --manifest-path crates/Cargo.toml -p runx-cli
 export RUNX_RECEIPT_DIR="$(mktemp -d)"
 crates/target/debug/runx skill examples/hello-world \
@@ -668,9 +667,9 @@ coverage.
 ## Build And Pack
 
 ```bash
-pnpm --dir oss build
-pnpm --dir oss test tests/cli-package.test.ts
-cd oss/packages/cli
+pnpm build
+pnpm test tests/cli-package.test.ts
+cd packages/cli
 npm pack --dry-run --json
 ```
 
diff --git a/docs/skill-to-graph.md b/docs/skill-to-graph.md
index 602840d1e..4e12bd333 100644
--- a/docs/skill-to-graph.md
+++ b/docs/skill-to-graph.md
@@ -104,7 +104,6 @@ The gates are intentionally narrow:
 Use the graph harness as the executable contract:
 
 ```bash
-cd oss
 cargo build --manifest-path crates/Cargo.toml -p runx-cli
 crates/target/debug/runx harness examples/hello-graph/harness.yaml --json
 ```

From 536d1cf88a54135c59cee24e1e0894339f15130b Mon Sep 17 00:00:00 2001
From: lightight <bholt2213@gmail.com>
Date: Fri, 24 Jul 2026 08:32:07 -0700
Subject: [PATCH 2/2] docs: clarify the oss/cloud boundary rule for fresh-clone
 readers

Addresses Copilot review on #364: note that 'oss/' refers to this
repository and 'cloud/' to the private companion workspace (absent from
this checkout), so the rule no longer reads as a stale directory path.
---
 docs/reference.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/reference.md b/docs/reference.md
index 5fa4a3b03..886769cb8 100644
--- a/docs/reference.md
+++ b/docs/reference.md
@@ -677,7 +677,7 @@ The package must include `dist/index.js` and `dist/index.d.ts`, and `dist/index.
 
 ## Boundary Rules
 
-- `oss/` must not import from `cloud/`.
+- `oss/` (this repository) must not import from `cloud/` (the private companion workspace, not part of this checkout).
 - State-machine and policy packages remain pure.
 - Rust owns trusted local runtime/execution, including sandbox, receipts,
   policy, authority, payment, harness, built-in adapters, and external