From 0c763ecb7d448118437cdce33a1f516dc509b42c Mon Sep 17 00:00:00 2001 From: River Bailey Date: Wed, 14 Oct 2026 07:55:28 -0600 Subject: [PATCH 1/2] docs(planning): record scope boundary for AI SDK LLM integration --- .../artifacts/scope-boundary.md | 29 +++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 docs/planning/ai-sdk-llm-integration/artifacts/scope-boundary.md diff --git a/docs/planning/ai-sdk-llm-integration/artifacts/scope-boundary.md b/docs/planning/ai-sdk-llm-integration/artifacts/scope-boundary.md new file mode 100644 index 0000000..96fc072 --- /dev/null +++ b/docs/planning/ai-sdk-llm-integration/artifacts/scope-boundary.md @@ -0,0 +1,29 @@ +# Scope Boundary: AI SDK LLM Integration + +## Work Item + +No work item exists. The operator's request, typed when invoking `/han-planning:plan-a-change`, is the only boundary this run has. + +## Stated Scope + +> to implement https://ai-sdk.dev as the integration layer between skillwalker an the LLM. the initial goal is to set this up with Claude Code access only. as part of this, we're getting rid of the claude sandbox entirely and will rely entirely on API access + +## Stated Exclusions + +None stated. Implied by "the initial goal is to set this up with Claude Code access only": providers other than Claude Code are not part of this run. + +## Operator-Stated Scope + +> create a branch for this work to be planned and implemented. commit and push as you go. open a draft pr + +## Direction of Travel + +The Test Sandbox (`@testdouble/sandbox-integration`, the `skillwalker sandbox` subcommands, and the sandbox shell scripts in `@testdouble/claude-integration`) is being removed entirely, not deprecated: "we're getting rid of the claude sandbox entirely and will rely entirely on API access". + +## Visual Material Received + +None received + +## Record Provenance + +Established by `han-planning:plan-a-change` on 2026-10-14, from the operator's invocation text. Not inherited. From adf1bfa2d057cac638413e29468092b250ffdf5d Mon Sep 17 00:00:00 2001 From: River Bailey Date: Wed, 14 Oct 2026 08:11:41 -0600 Subject: [PATCH 2/2] docs(planning): record AI SDK-only provider decision in scope boundary --- .../ai-sdk-llm-integration/artifacts/scope-boundary.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/docs/planning/ai-sdk-llm-integration/artifacts/scope-boundary.md b/docs/planning/ai-sdk-llm-integration/artifacts/scope-boundary.md index 96fc072..2f5226d 100644 --- a/docs/planning/ai-sdk-llm-integration/artifacts/scope-boundary.md +++ b/docs/planning/ai-sdk-llm-integration/artifacts/scope-boundary.md @@ -10,12 +10,17 @@ No work item exists. The operator's request, typed when invoking `/han-planning: ## Stated Exclusions -None stated. Implied by "the initial goal is to set this up with Claude Code access only": providers other than Claude Code are not part of this run. +- The community `ai-sdk-provider-claude-code` provider (operator, 2026-10-14). +- Otherwise none stated. Implied by "the initial goal is to set this up with Claude Code access only": providers other than Claude Code are not part of this run. ## Operator-Stated Scope > create a branch for this work to be planned and implemented. commit and push as you go. open a draft pr +> since this is an experiment to understand how things would actually work, i want to build this out with AI-SDK only, and not use the community claude provider. that means we need to implement the skills and custom agents. in ~/dev/mxriverlynn/3pitor/ we built out an MCP server to handle these calls from inside of the 3pitor runtime. i'd like to do the same, here. i think this should give us much more fine-grained control and isolation, without the sandbox need. + +Interpretation recorded with the operator's statement: "Claude Code access only" from the original request is superseded for provider choice. The community `ai-sdk-provider-claude-code` provider is excluded. The model is reached through AI SDK directly, and Skillwalker implements skill and custom-agent loading and invocation itself, through an MCP server modeled on the one in `~/dev/mxriverlynn/3pitor/`. The operator accepted that trigger results then measure Skillwalker's own harness rather than Claude Code's, framing the work as "an experiment to understand how things would actually work". + ## Direction of Travel The Test Sandbox (`@testdouble/sandbox-integration`, the `skillwalker sandbox` subcommands, and the sandbox shell scripts in `@testdouble/claude-integration`) is being removed entirely, not deprecated: "we're getting rid of the claude sandbox entirely and will rely entirely on API access". @@ -26,4 +31,4 @@ None received ## Record Provenance -Established by `han-planning:plan-a-change` on 2026-10-14, from the operator's invocation text. Not inherited. +Established by `han-planning:plan-a-change` on 2026-10-14, from the operator's invocation text. Not inherited. Updated 2026-10-14 with the operator's provider decision (AI SDK only, own MCP skill/agent server).