docs(yield): prepare public developer preview

labs/22-yield/distribution/release-notes/2026-08-07-public-developer-preview.md

@@ -0,0 +1,7 @@
+# Public developer preview documentation
+
+- Define Yield as an open-source execution runtime for programmable Agent Skill
+  workflows.
+- Document the boundary between Agent Plugins packaging and Yield workflow
+  execution without claiming unverified conformance.
+- Point every public installation path at the release produced by this change.

labs/22-yield/public-readme/README.md

@@ -1,5 +1,7 @@
 # Yield
 
+Yield is an open-source execution runtime for programmable Agent Skill workflows.
+
 **Write one skill workflow. Run it from your coding agents.**
 
 Skill workflows are portable, executable processes that combine agent skills
@@ -30,21 +32,21 @@ repository. Generated adapters never use a global `yskill` from `PATH`.
 
 ```bash
 # TypeScript
-npm install --save-exact @operatorstack/yield@0.1.26 --registry=https://get.operatorstack.systems/npm/
+npm install --save-exact @operatorstack/yield@0.1.29 --registry=https://get.operatorstack.systems/npm/
 npm exec -- yskill --version
 
 # Python, after creating and activating .venv
-python -m pip install yieldskill==0.1.26 --index-url https://get.operatorstack.systems/pip/simple/
+python -m pip install yieldskill==0.1.29 --index-url https://get.operatorstack.systems/pip/simple/
 python -m yieldskill --version
 
 # Go, from the repository root
 mkdir -p .yield/bin
 GOBIN="$PWD/.yield/bin" GOPROXY=https://get.operatorstack.systems/go,direct \
-  go install github.com/operatorstack/yield/cmd/yskill@v0.1.26
+  go install github.com/operatorstack/yield/cmd/yskill@v0.1.29
 .yield/bin/yskill --version
 
 # Rust, from the repository root
-cargo install yieldskill@0.1.26 --root .yield \
+cargo install yieldskill@0.1.29 --root .yield \
   --index sparse+https://get.operatorstack.systems/cargo/index/ --locked
 .yield/bin/yskill --version
 ```
@@ -145,6 +147,8 @@ the documentation for your job:
 - [examples](docs/examples.md) — working programs in all four languages;
 - [coding-agent setup](docs/agent-setup.md) — register one skill workflow with the
   agents used by the project;
+- [Agent Plugins and Yield](docs/agent-plugins.md) — where portable packaging ends
+  and workflow execution begins;
 - [test workflow effects](docs/testing-fixtures.md) — deterministic fixture
   setup, response effects, standard-input JSON, and cleanup;
 - [evaluations](evals/README.md) — first-party workflow conformance and runtime

labs/22-yield/yield/docs/README.md

@@ -42,16 +42,17 @@ and start it.
 | approval points | writing explanations |
 | evidence required to finish | interpreting evidence |
 
-This is not a new agent runtime. A thin `SKILL.md` starts the program, the
-program emits one typed operation, and the coding agent performs that operation
-through its normal interface. Yield records the response and resumes from the
-next unanswered operation.
+This is not a new agent loop or a hosted agent runtime. A thin `SKILL.md` starts
+the program, the program emits one typed operation, and the coding agent
+performs that operation through its normal interface. Yield records the
+response and resumes from the next unanswered operation.
 
 ## Reference
 
 - [Skill workflow concepts](skill-workflows.md)
 - [CLI commands](reference/cli.md)
 - [Coding-agent registration](agent-setup.md)
+- [Agent Plugins and Yield](agent-plugins.md)
 - [Run, pause, resume, and replay](reference/execution-model.md)
 - [The four SDKs](reference/sdk-parity.md)
 - [Guarantees and limits](reference/guarantees.md)

labs/22-yield/yield/docs/agent-plugins.md

@@ -0,0 +1,38 @@
+# Agent Plugins and Yield
+
+Agent Plugins and Yield solve different parts of the same delivery path:
+
+- **Agent Plugins packages a capability.** Its manifest and fixed directories let
+  compatible clients discover Agent Skills and MCP servers.
+- **Yield governs execution.** A Yield program owns repeatable order, branches,
+  checks, human decisions, saved state, and terminal outcomes.
+
+In short: **Agent Plugins packages the capability. Yield governs the execution.**
+
+## Current support boundary
+
+Yield does not currently emit an Agent Plugins `plugin.json`, install plugins, or
+load MCP servers. `yskill register` writes a small `SKILL.md` adapter into a coding
+agent's project skill directory and keeps the canonical workflow beside the
+project dependencies it uses.
+
+That adapter alone is not proof that a package conforms to Agent Plugins. A
+conformant plugin must satisfy the complete Agent Plugins manifest, containment,
+component-discovery, and Agent Skills requirements. Yield does not claim Agent
+Plugins v1 conformance in this release.
+
+## Using the projects together
+
+You can package skills however you like and use Yield for the repeatable workflow
+behind them. Keep these boundaries explicit:
+
+1. the plugin package owns discovery and portable package structure;
+2. the Yield program owns workflow execution and verification;
+3. the host owns installation, permissions, and the agent interaction surface.
+
+A future plugin export should be treated as a separate, tested distribution
+feature. It should not change Yield's execution contract.
+
+See the [Agent Plugins specification](https://agent-plugins.org/specification) and
+the [Agent Skills specification](https://agentskills.io/specification) for their
+normative requirements.

labs/22-yield/yield/docs/quickstart.md

@@ -12,7 +12,7 @@ You need Node.js 24 or newer.
 mkdir yield-example
 cd yield-example
 npm init -y
-npm install --save-exact @operatorstack/yield@0.1.26 \
+npm install --save-exact @operatorstack/yield@0.1.29 \
   --registry=https://get.operatorstack.systems/npm/
 npm exec -- yskill --version
 ```

labs/22-yield/yield/evals/results/latest.json

@@ -1,8 +1,8 @@
 {
   "schema_version": 2,
   "methodology_version": "1.1",
-  "generated_at": "2026-08-02T19:51:34.931Z",
-  "source_digest": "e5b21f13b239b762064fa3a4bd3d2354fba3dc46feb324f9bddbccad72827c24",
+  "generated_at": "2026-08-07T06:48:04.494Z",
+  "source_digest": "b84acf911139d392a12774d10b255d9ff396e91f6356d349920560e75b90d4f3",
   "status": "passed",
   "workflow_conformance": {
     "passed": 40,

labs/22-yield/yield/sdk/python/README.md

@@ -10,15 +10,15 @@ Create a virtual environment before installation:
 # macOS and Linux
 python3 -m venv .venv
 source .venv/bin/activate
-python -m pip install yieldskill==0.1.26 \
+python -m pip install yieldskill==0.1.29 \
   --index-url https://get.operatorstack.systems/pip/simple/
 ```
 
 ```powershell
 # Windows PowerShell
 py -m venv .venv
 .\.venv\Scripts\Activate.ps1
-python -m pip install yieldskill==0.1.26 `
+python -m pip install yieldskill==0.1.29 `
   --index-url https://get.operatorstack.systems/pip/simple/
 ```