Document lws init, Claude Code slash commands, Lambda Function URLs, and --background flag

Add Claude Code Integration section to getting-started.html documenting
lws init, /lws:mock and /lws:chaos slash commands. Add Lambda Function URL
support to services.html (FunctionUrl construct, CORS, invoke modes). Add
--background flag and ldk stop command to cli.html. Add lws init command
card to CLI reference.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: eamonnfaherty

cli.html

@@ -45,6 +45,16 @@ <h3>ldk dev</h3>
           <li><code>--log-level, -l</code> <span>Log level: debug, info, warning, error (default: info)</span></li>
           <li><code>--project-dir, -d</code> <span>Project root directory (default: current directory)</span></li>
           <li><code>--mode, -m</code> <span>Project mode: cdk or terraform (default: auto-detect from project files)</span></li>
+          <li><code>--background, -b</code> <span>Run in the background as a detached process. Logs are written to <code>.lws/ldk-dev.log</code>. Stop with <code>ldk stop</code>.</span></li>
+        </ul>
+      </div>
+
+      <div class="cli-detail">
+        <div class="code-block"><code>uvx --from local-web-services ldk stop [OPTIONS]</code></div>
+        <h3>ldk stop</h3>
+        <p>Stop a background <code>ldk dev</code> session. Sends a graceful shutdown signal via the management API.</p>
+        <ul class="option-list">
+          <li><code>--port, -p</code> <span>Port of the running ldk dev instance to stop (default: 3000)</span></li>
         </ul>
       </div>
 
@@ -95,6 +105,15 @@ <h2>LWS Commands</h2>
       <p class="section-lead">AWS CLI-style commands for interacting with your local services. Requires a running <code>ldk dev</code> instance.</p>
 
       <div class="lws-command-grid">
+        <div class="lws-command">
+          <h4>lws init</h4>
+          <p>Initialize Claude Code integration. Creates CLAUDE.md context and slash commands for AI-assisted mock and chaos workflows.</p>
+          <div>
+            <span class="subcmd">--project-dir</span>
+          </div>
+          <div class="code-block" style="margin-top: 12px;"><code>uvx --from local-web-services lws init</code></div>
+        </div>
+
         <div class="lws-command">
           <h4>lws status</h4>
           <p>Show the status of the running ldk dev instance and all providers.</p>

getting-started.html

@@ -167,6 +167,52 @@ <h3>6. Test the application</h3>
     </div>
   </section>
 
+  <section class="section section-alt">
+    <div class="container">
+      <h2>Claude Code Integration</h2>
+      <p class="section-lead">Set up slash commands and context for AI code editors so Claude can manage your local AWS mocks and chaos testing.</p>
+
+      <div class="getting-started-steps">
+        <div class="gs-step">
+          <h3>Initialize</h3>
+          <div class="code-block"><code>uvx --from local-web-services lws init</code></div>
+          <p>This creates three files in your project:</p>
+          <ul>
+            <li><code>CLAUDE.md</code> &mdash; LWS quick reference and CLI commands that Claude reads automatically</li>
+            <li><code>.claude/commands/lws/mock.md</code> &mdash; The <code>/lws:mock</code> slash command</li>
+            <li><code>.claude/commands/lws/chaos.md</code> &mdash; The <code>/lws:chaos</code> slash command</li>
+          </ul>
+          <p>The command is idempotent &mdash; running it again updates existing files without duplicating content.</p>
+        </div>
+
+        <div class="gs-step">
+          <h3>Slash Commands</h3>
+          <p>Once initialized, two slash commands are available in Claude Code:</p>
+        </div>
+      </div>
+
+      <div class="feature-grid" style="grid-template-columns: 1fr 1fr; max-width: 900px; margin: 0 auto;">
+        <div class="feature-card">
+          <div class="feature-icon">/</div>
+          <h3>/lws:mock</h3>
+          <p>Guides Claude through creating and configuring AWS operation mocks. Supports file-based mocks (persist across restarts) and runtime mocks (configured on the fly). Includes service-aware helpers for DynamoDB JSON, S3 XML, SQS messages, and more.</p>
+        </div>
+        <div class="feature-card">
+          <div class="feature-icon">/</div>
+          <h3>/lws:chaos</h3>
+          <p>Guides Claude through enabling chaos engineering on AWS services. Configure error rates, latency injection, timeouts, and connection resets. Includes common scenarios for testing retry logic, circuit breakers, and timeout handling.</p>
+        </div>
+      </div>
+
+      <div class="getting-started-steps" style="margin-top: 48px;">
+        <div class="gs-step">
+          <h3>What Gets Added to CLAUDE.md</h3>
+          <p>The <code>CLAUDE.md</code> snippet gives Claude context about your LWS environment, including how to start the dev server, check status, and use mock and chaos commands. This context is read automatically by Claude Code when working in your project.</p>
+        </div>
+      </div>
+    </div>
+  </section>
+
   <footer class="footer">
     <div class="container">
       <div class="footer-inner">

index.html

@@ -242,7 +242,7 @@ <h2>Explore the Docs</h2>
         <a href="getting-started.html" class="feature-card" style="text-decoration: none;">
           <div class="feature-icon">&#128640;</div>
           <h3>Get Started</h3>
-          <p>Install prerequisites, clone a sample project, and run your first local stack in under five minutes.</p>
+          <p>Install prerequisites, clone a sample project, run your first local stack, and set up Claude Code integration.</p>
         </a>
         <a href="services.html" class="feature-card" style="text-decoration: none;">
           <div class="feature-icon">&#9729;&#65039;</div>

services.html

@@ -336,8 +336,9 @@ <h3>Lambda</h3>
             <h4>CDK Constructs</h4>
             <div class="service-detail-ops">
               <span class="cdk">aws_lambda.Function</span>
+              <span class="cdk">aws_lambda.FunctionUrl</span>
             </div>
-            <p class="cdk-props"><code>handler</code>, <code>runtime</code>, <code>code</code>, <code>timeout</code>, <code>memorySize</code>, <code>environment</code></p>
+            <p class="cdk-props"><code>handler</code>, <code>runtime</code>, <code>code</code>, <code>timeout</code>, <code>memorySize</code>, <code>environment</code>, <code>authType</code>, <code>cors</code>, <code>invokeMode</code></p>
           </div>
           <div class="service-detail-section">
             <h4>Management API (Terraform mode)</h4>
@@ -361,7 +362,16 @@ <h4>Management API (Terraform mode)</h4>
               <span class="op">ListTags</span>
             </div>
           </div>
-          <p class="service-note">Runs functions inside official AWS Lambda Docker images (with AWS SDK pre-installed). Run <code>ldk setup lambda</code> once to pull the images. Supports timeout enforcement, realistic context objects, and environment variable injection. In CDK mode, functions are discovered from the cloud assembly. In Terraform mode, functions are created dynamically via the management API.</p>
+          <div class="service-detail-section">
+            <h4>Function URLs</h4>
+            <div class="service-detail-ops">
+              <span class="op">CreateFunctionUrlConfig</span>
+              <span class="op">GetFunctionUrlConfig</span>
+              <span class="op">UpdateFunctionUrlConfig</span>
+              <span class="op">DeleteFunctionUrlConfig</span>
+            </div>
+          </div>
+          <p class="service-note">Runs functions inside official AWS Lambda Docker images (with AWS SDK pre-installed). Run <code>ldk setup lambda</code> once to pull the images. Supports timeout enforcement, realistic context objects, environment variable injection, and <strong>Function URLs</strong> &mdash; each function URL gets its own HTTP endpoint on a dedicated port with full CORS support and AWS Lambda payload format 2.0. Supports both BUFFERED and RESPONSE_STREAM invoke modes. In CDK mode, functions and URLs are discovered from the cloud assembly. In Terraform mode, functions are created dynamically via the management API.</p>
         </div>
 
         <div class="service-detail" id="apigateway">