---
phase: 22-course-load-testing
plan: 02
type: execute
wave: 1
depends_on: []
files_modified:
  - pmcp-course/src/part4-testing/ch12-remote-testing.md
autonomous: true
requirements:
  - CRLT-04

must_haves:
  truths:
    - "Learner reading Ch 12 discovers that load testing is available via cargo pmcp loadtest"
    - "Learner reading Ch 12 is directed to Ch 18-03 for the full hands-on load testing tutorial"
    - "The load testing section fits naturally within Ch 12's existing structure and style"
  artifacts:
    - path: "pmcp-course/src/part4-testing/ch12-remote-testing.md"
      provides: "Load testing cross-reference section added to existing remote testing chapter"
      contains: "Load Testing"
  key_links:
    - from: "pmcp-course/src/part4-testing/ch12-remote-testing.md"
      to: "pmcp-course/src/part7-observability/ch18-03-performance.md"
      via: "Cross-reference link to Ch 18-03"
      pattern: "ch18-03-performance"
---

<objective>
Add a brief "Load Testing" section to the course's Chapter 12 (Remote Testing) that introduces load testing and cross-references Chapter 18-03 for the full hands-on tutorial.

Purpose: Learners browsing the testing part of the course should discover that load testing tooling exists and know where to find the hands-on tutorial, without duplicating Ch 18-03 content.

Output: Updated `pmcp-course/src/part4-testing/ch12-remote-testing.md` with new load testing section.
</objective>

<execution_context>
@./.claude/get-shit-done/workflows/execute-plan.md
@./.claude/get-shit-done/templates/summary.md
</execution_context>

<context>
@.planning/PROJECT.md
@.planning/ROADMAP.md
@.planning/STATE.md
</context>

<tasks>

<task type="auto">
  <name>Task 1: Add Load Testing cross-reference section to course Ch 12</name>
  <files>pmcp-course/src/part4-testing/ch12-remote-testing.md</files>
  <action>
Read `pmcp-course/src/part4-testing/ch12-remote-testing.md` fully to understand the existing structure, style, and where the new section should be inserted.

The chapter's current structure:
1. Title + intro paragraph
2. Learning Objectives
3. Why Remote Testing?
4. Remote Testing Architecture
5. Testing Deployed Servers
6. CI/CD Integration Patterns
7. Regression Testing
8. Chapter Summary
9. Knowledge Check (quiz)
10. Practice Ideas
11. Navigation link to sub-chapters

Add a new section `## Load Testing Your Deployed Servers` between "Regression Testing" (section 7) and "Chapter Summary" (section 8). This placement makes sense because:
- It follows functional testing topics (smoke, integration, regression)
- It introduces the performance dimension of remote testing
- It sits naturally before the chapter summary which can reference it

The section should be approximately 30-50 lines and include:

1. **Brief teaching introduction** (2-3 paragraphs):
   - "Beyond functional correctness, you need to know how your deployed server performs under load"
   - What `cargo pmcp loadtest` provides at a high level (k6-inspired, MCP-aware, HdrHistogram metrics)
   - Quick one-liner showing the basic command

2. **What you can discover** (bullet list in teaching voice):
   - How many concurrent clients your server handles before degrading
   - What P99 latency looks like at different load levels
   - Where the breaking point is (automatic detection)
   - Whether a new deployment caused a performance regression

3. **Quick taste** — show a minimal 5-line example:
   - A simple `cargo pmcp loadtest run` command with `--vus 10 --duration 30`
   - Brief mention of what the learner will see (k6-style output with percentiles)

4. **Cross-reference callout** (use a blockquote or emphasis matching the chapter style):
   - Direct learners to Chapter 18-03 for the full hands-on tutorial
   - Use relative mdBook link: `[Chapter 18-03: Performance Optimization](../part7-observability/ch18-03-performance.md)`
   - Mention that Ch 18-03 covers: TOML config authoring, schema discovery, staged load profiles, breaking point detection, capacity planning

5. **Update the Chapter Summary section** at the bottom:
   - Add a numbered item about load testing: "6. **Load testing** - Use `cargo pmcp loadtest` to validate performance under load (see Ch 18-03)"

6. **Update the Learning Objectives** at the top:
   - Add: "- Know where to find hands-on load testing guidance for deployed servers"

7. **Update the Practice Ideas** section:
   - Add: "5. **Run a quick load test** - Use `cargo pmcp loadtest run` against your deployed server with 5 VUs for 30 seconds and review the P99 latency"

Match the existing teaching style exactly: second person voice, "Let's...", "You'll...", same heading levels and formatting. Do NOT duplicate detailed content from Ch 18-03 — keep this section concise and referential. The learner should think "I need to read Ch 18-03 to learn this properly."

Preserve ALL existing content — do not remove or modify any existing sections beyond adding the items listed above.
  </action>
  <verify>
    <automated>grep -c "Load Testing" pmcp-course/src/part4-testing/ch12-remote-testing.md | xargs test 3 -le</automated>
    Verify: "Load Testing" appears at least 3 times (section header + summary + practice idea).
    Also verify cross-reference: grep "ch18-03-performance" pmcp-course/src/part4-testing/ch12-remote-testing.md should return at least 1 match.
    Also verify existing content preserved: grep -c "mcp-tester\|Regression\|CI/CD\|smoke" pmcp-course/src/part4-testing/ch12-remote-testing.md should return 5+ matches.
  </verify>
  <done>
    Ch 12 has a new "Load Testing Your Deployed Servers" section that introduces load testing, shows a quick taste, and cross-references Ch 18-03 for the full hands-on tutorial. Learning objectives, chapter summary, and practice ideas are updated. Existing content is fully preserved. Style matches the established course voice.
  </done>
</task>

</tasks>

<verification>
1. `pmcp-course/src/part4-testing/ch12-remote-testing.md` contains a load testing section
2. Cross-reference link to `ch18-03-performance.md` is present
3. All existing Ch 12 content is preserved (no deletions)
4. Section is concise (30-50 lines, not duplicating Ch 18-03 content)
5. Learning objectives, summary, and practice ideas are updated
6. Style matches existing course chapter conventions (teaching voice, second person)
</verification>

<success_criteria>
- Learner browsing Ch 12 discovers load testing capability and is clearly directed to Ch 18-03
- Existing Ch 12 content is untouched
- New section is brief, well-placed, and stylistically consistent with course voice
- Cross-reference link uses correct relative path for mdBook
</success_criteria>

<output>
After completion, create `.planning/phases/22-course-load-testing/22-02-SUMMARY.md`
</output>
