[S-13410] Add the agent tutorial: one prompt per chapter - #802
Merged
Merged
Conversation
Add docs/proxymock/how-it-works/agent-skills.md: a short list of the Speedscale agent skills grouped by task, each linking to its folder in speedscale/skills, with a copy/paste prompt that installs them all. Link to it from the MCP page and both agent install snippets. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Nine unlisted pages under docs/proxymock/agent-tutorial/ walk a coding agent through installing the skills and proxymock, running the CNCF swag-shop tutorial app from speedscale/mock-lab, recording it, tuning its mocks and tests, a regression test, a performance test, and the same loop on a second service. Each chapter is the prompt, what the agent does, trimmed real output from the end-to-end runs, troubleshooting, and the manual commands. The agent skills page now covers all 15 skills bundled in proxymock and mirrored in speedscale/skills, and drops proxymock-replay-tuning. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
|
Preview available at 'http://docs-preview.speedscale.com.s3-website-us-east-1.amazonaws.com/pr-802/' |
# Conflicts: # docs/proxymock/how-it-works/agent-skills.md
The nine tutorial pages are no longer unlisted. They sit in their own expanded Agent Tutorial category right under the proxymock Overview in the Local Development sidebar, with short chapter labels, and the Overview page now opens with the tutorial ahead of the 30-second install. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
kenahrens
approved these changes
Oct 2, 2026
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
2 participants
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.
Problem
The proxymock getting started guide teaches CLI and UI commands. Epic S-13406 makes the front door a tutorial that a coding agent drives end to end, one pasted prompt per chapter, on a purpose-built demo app.
Solution
Nine pages under
docs/proxymock/agent-tutorial/, published: an expanded Agent Tutorial category right under the proxymock Overview in the Local Development sidebar, and the Overview page now opens with the tutorial ahead of the 30-second install:tutorial/, Go, Java, Python, Node)tscache-buster, SQL reads that only get their own row in recorded order)generated_at, new orderid)APP_VERSION=v2turnstotal_centsinto a string)APP_SLOW=1N+1 onGET /orders)Each chapter is the prompt, what the agent does, trimmed real output, troubleshooting and the manual commands.
how-it-works/agent-skills.mdnow lists all 15 skills bundled in proxymock and mirrored in speedscale/skills.Verified end to end with Claude Code (Go, Java, Python, Node) and Cursor (Go), all nine chapters passing. Chapter 4 output comes from a build of speedscale!7120; it and speedscale!7117 reach readers with the next proxymock release, and the chapter says what older versions show.
yarn check:writing0 errors;yarn buildpasses.🤖 Generated with Claude Code