Skip to content

docs(specs): add claude-code agent-runner backend brainstorm#108

Open
andreybavt wants to merge 16 commits into
mainfrom
clarify-interactive-sessions
Open

docs(specs): add claude-code agent-runner backend brainstorm#108
andreybavt wants to merge 16 commits into
mainfrom
clarify-interactive-sessions

Conversation

@andreybavt
Copy link
Copy Markdown
Contributor

Summary

Adds the post-brainstorm design doc for a new claude-code agent-runner backend that would route KTX agent LLM calls through @anthropic-ai/claude-agent-sdk, reusing the user's existing local Claude Code session. Documents goals, non-goals, architecture, decisions (Q1–Q5 + naming/cwd/tool-adapter), implementation surface, verified evidence, and open items for the follow-up plan. Refined across three adversarial review iterations to scope the change to agent-runner only, lock the runner-port boundary, and nail down SDK isolation (built-in tools, filesystem settings, skills) and stop-reason mapping.

Test plan

  • Doc renders cleanly in repo / on GitHub
  • No code changes; no build/test impact

Locks the design for a new `'claude-code'` value in `KtxLlmBackend` that
routes KTX agentic LLM calls through `@anthropic-ai/claude-agent-sdk`,
reusing the user's existing `claude login` session. MVP scope: degraded
tool-call repair and no telemetry, both documented as known gaps.
@vercel
Copy link
Copy Markdown

vercel Bot commented May 15, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
ktx-docs-site Ready Ready Preview, Comment May 15, 2026 11:22am

Request Review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant