DOC-435: Push lstk in the docs research/writing MVP agent - #929
Merged
quetzalliwrites merged 1 commit intoSep 9, 2026
Merged
Conversation
agents.md still instructed the agent to write every new doc and tutorial example around the deprecated awslocal/tflocal/cdklocal wrapper scripts. Update its templates, guardrails, and conventions to push lstk aws/lstk terraform/lstk cdk/lstk sam instead, matching the same fix already applied to agents-tester.md (DOC-368). Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
quetzalliwrites
requested review from
HarshCasper and
remotesynth
as code owners
September 9, 2026 18:57
Deploying localstack-docs with
|
| Latest commit: |
8abb244
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://fde58da3.localstack-docs.pages.dev |
| Branch Preview URL: | https://doc-435-docs-update-docs-res.localstack-docs.pages.dev |
quetzalliwrites
deleted the
doc-435-docs-update-docs-researchwriting-mvp-agent-to-push-lstk
branch
September 9, 2026 20:13
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
agents.md(the MVP AI Documentation Agent used for researching and drafting docs in this repo) still instructed the agent to write every new service doc and tutorial aroundawslocal, including in its anti-hallucination guardrails, doc templates, and the "CLI commands" style guide.This mirrors the same fix already applied to
agents-tester.mdin DOC-368 ("Push lstk over awslocal/cdklocal/tflocal in tester agent"), which already asks the review agent to check forlstk aws/lstk cdk/lstk terraformusage. Without this change, the writing agent and the reviewing agent were pushing two different conventions.Changes:
lstk aws/lstk cdk/lstk terraforminstead ofawslocal.lstk awsand thelstkproxies generally.lstk awsin the getting-started/prerequisites sections and example command blocks.lstk aws(notaws, not the deprecatedawslocalwrapper), and calls outlstk terraform/lstk cdk/lstk samfor IaC examples.public/agents.md(the separate end-user-facing onboarding doc served at docs.localstack.cloud/agents.md) was already lstk-based and needed no changes.Linear ticket
https://linear.app/localstack/issue/DOC-435/docs-update-docs-researchwriting-mvp-agent-to-push-lstk
Test plan
grep -n "awslocal\|tflocal\|cdklocal\|samlocal" agents.mdreturns no command usages (only the explicit "not the deprecated awslocal wrapper" callout)