Skip to content

Align agents-guide differentiation paragraph with Kitaru replay messaging#5043

Open
AlexejPenner wants to merge 6 commits into
developfrom
msg/kitaru-canon-v3
Open

Align agents-guide differentiation paragraph with Kitaru replay messaging#5043
AlexejPenner wants to merge 6 commits into
developfrom
msg/kitaru-canon-v3

Conversation

@AlexejPenner

@AlexejPenner AlexejPenner commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Summary

Single-paragraph docs change: the agents-guide differentiation paragraph now follows the Kitaru messaging canon v3 — names Braintrust/LangSmith/Langfuse, states the watched-vs-executed distinction, notes that replay never re-fires yesterday's real actions, and keeps the single-shot honest boundary.

What changed

  • docs/book/user-guide/agents-guide/README.md: one paragraph replaced (1 insertion, 1 deletion). The §2 competitors LOCK and §6 boundary LOCK are embedded byte-identical to the canon. Hint box, frontmatter, and surrounding list untouched.

What reviewers should focus on

  • The two LOCK sentences must stay character-identical to the canon — don't copy-edit them (em dashes included).

Validation

Byte-level LOCK verification against the canon; adversarial fresh-eyes review against the rollout DONE checks — no failures; all relative links on the page verified on disk.

🤖 Generated with Claude Code

TODO (follow-up, not blocking review)

  • Backport the no-refiring sentence into the canon Resolved in canon v3.2: the original claim was inaccurate (model calls do re-run live); the corrected replay-semantics sentence (tool calls answer from the recorded run or are mocked) is now a §2 lock and is used here.

…non v3

Name Braintrust/LangSmith/Langfuse, state the watched-vs-executed
distinction, and keep the single-shot honest boundary.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@github-actions github-actions Bot added the internal To filter out internal PRs and issues label Jul 7, 2026
AlexejPenner and others added 2 commits July 8, 2026 09:12
Drops the "only Kitaru executed your agent" claim (the harness executes
the agent; Kitaru is the runtime it ran on), stops implying Langfuse can
test against a dataset, and removes "genuinely" from the boundary line.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Competitors are passive (they ingest run data), and the replay-semantics
sentence now matches how replay actually works: model calls re-run for
real; tool calls answer from the recorded run or are mocked, so critical
side effects don't re-fire.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@AlexejPenner AlexejPenner changed the title Align agents-guide differentiation paragraph with Kitaru messaging canon v3 Align agents-guide differentiation paragraph with Kitaru replay messaging Jul 9, 2026
AlexejPenner and others added 2 commits July 9, 2026 09:59
…raph

It reads as hedging in this guide's intro; the carve-out stays on the
compare pages where the canon mandates it.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@AlexejPenner
AlexejPenner marked this pull request as ready for review July 9, 2026 08:34
@github-actions

github-actions Bot commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

Documentation Link Check Results

Absolute links check passed
Relative links check passed
Last checked: 2026-07-16 10:04:04 UTC

@AlexejPenner
AlexejPenner requested a review from htahir1 July 9, 2026 08:37
@bcdurak

bcdurak commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

@htahir1 heads-up, in-case you missed it.

@bcdurak

bcdurak commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

this time @AlexejPenner heads-up, in case you missed it 😄

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

Labels

internal To filter out internal PRs and issues

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants