Skip to content

docs: add Strandslator design doc#2790

Open
pgrayy wants to merge 3 commits into
strands-agents:mainfrom
pgrayy:pgrayy/strandslator-design
Open

docs: add Strandslator design doc#2790
pgrayy wants to merge 3 commits into
strands-agents:mainfrom
pgrayy:pgrayy/strandslator-design

Conversation

@pgrayy

@pgrayy pgrayy commented Jun 15, 2026

Copy link
Copy Markdown
Member

Summary

  • Proposes Strandslator, an agent-driven system for translating Strands features across languages
  • Focuses on producing PRs that are fast and safe to review via mechanically-derived artifacts
  • Covers the translation workflow, input context, agents, artifacts, and determinism strategy

Proposes Strandslator, an agent-driven system for translating Strands
features across languages with a focus on producing reviewable PRs.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@github-actions github-actions Bot added size/s area-language Related to new language development documentation Documentation changes, improvements, additions, content updates, site improvements, examples, guides enhancement New feature or request strands-running labels Jun 15, 2026
@pgrayy pgrayy changed the title Add Strandslator design doc docs: add Strandslator design doc Jun 15, 2026
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@strands-agents strands-agents deleted a comment from github-actions Bot Jun 15, 2026
@strands-agents strands-agents deleted a comment from github-actions Bot Jun 15, 2026
@strands-agents strands-agents deleted a comment from github-actions Bot Jun 15, 2026
@strands-agents strands-agents deleted a comment from github-actions Bot Jun 15, 2026

## Experiments

I ran early experiments translating the Anthropic model provider from TypeScript to Python, erasing existing traces from the Python SDK to set realistic conditions. With Opus 4.8 and above, translation quality is strong. The takeaway is that translation itself is not the bottleneck; what's missing is the review infrastructure, which is what shifted focus toward the artifacts and report design in this proposal.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we have objective data we can cite for this?

@pgrayy pgrayy Jun 16, 2026

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have my sample experiments but not something super extensive. This was due to timing though. Each translation workflow I kicked off ran on average 20 minutes and so I could only complete so much. I did however run an experiment with the Bedrock KB port which is committed in main now. I'll add the findings of that experiment to this doc. Overall it worked well. There were a few hiccups though because of general inconsistencies across the Python SDK, which understandably confused the agents.

@@ -0,0 +1,100 @@
# Strandslator

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall I agree with the doc but I am not seeing an actionable plan that we can start implementing. From my perspective, we need the MVP to get this off the ground, then we can fill in missing pieces and improve.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'll add a more detailed section on this. But in short, getting something setup will be straightforward. We can follow closely what we already do with the GitHub agents. The tricky part of this system is just making sure we are consistently using it so that the code generation itself is consistent. As stated in the doc, Python will continue to be the outlier because it utilizes some of our outdated design principles.

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

Labels

area-language Related to new language development documentation Documentation changes, improvements, additions, content updates, site improvements, examples, guides enhancement New feature or request size/s

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants