Document With.Akka.forRelease parameters and add usage guidance

- Update CLAUDE.md to direct users to README.md as authoritative source
- Update version references from 1.0.0/1.2.0 to 1.2.4
- Document all With.Akka.forRelease boolean parameters in README.md
- Add note for riddl-server-infrastructure dependents about transitive deps
- Include examples for basic and full-featured Akka configurations

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

Author: respencer-ncl

CLAUDE.md

@@ -1,12 +1,20 @@
 # sbt-ossuminc Plugin Guide for Claude Code
 
-This file provides specific guidance for working with the sbt-ossuminc plugin. For general ossuminc organization patterns, see `../CLAUDE.md` (parent directory).
+This file provides specific guidance for working with the sbt-ossuminc plugin.
+For general ossuminc organization patterns, see `../CLAUDE.md` (parent
+directory).
+
+**IMPORTANT:** For comprehensive usage documentation, configuration options,
+and examples, see `README.md` in this directory. This CLAUDE.md provides a
+quick reference; the README is the authoritative source.
 
 ## Project Overview
 
-SBT plugin providing build infrastructure and configuration helpers for Ossum Inc. projects. Defines declarative project types and configuration options used across all Scala projects in the organization.
+SBT plugin providing build infrastructure and configuration helpers for Ossum
+Inc. projects. Defines declarative project types and configuration options
+used across all Scala projects in the organization.
 
-**Current version: 1.0.0** (updated Jan 2026)
+**Current version: 1.2.4** (updated Jan 2026)
 
 ## Project Types Provided
 
@@ -68,13 +76,36 @@ SBT plugin providing build infrastructure and configuration helpers for Ossum In
   ))
   ```
 
+**`With.Akka.forRelease(...)`** - Akka platform dependencies (v1.2.4+)
+- See README.md for full parameter documentation
+- Core Akka modules are always included
+- Optional modules via boolean flags: `withHTTP`, `withGrpc`, `withPersistence`,
+  `withProjections`, `withManagement`, `withManagementKubernetes`, `withKafka`,
+  `withInsights`
+- Example:
+  ```scala
+  .configure(With.Akka.forRelease(
+    "25.10",
+    withHTTP = true,
+    withPersistence = true,
+    withInsights = true
+  ))
+  ```
+
+**Note for riddl-server-infrastructure dependents:** If your server depends on
+`riddl-server-infrastructure`, some Akka modules (core, HTTP) are already
+provided transitively. Only use `With.Akka.forRelease()` if you need modules
+beyond what the server infrastructure provides (e.g., Kafka, Insights,
+Management, Projections).
+
 **Other parameterized options:**
 - `With.Laminar(...)` - Laminar + DOM dependencies
 - `With.MiMa(...)` - Binary compatibility checking
 - `With.Packaging.universal(...)` - Universal packaging
 - `With.GithubPublishing` - GitHub Packages publishing
 
-Refer to the comprehensive README.md in this directory for all options.
+**For all configuration options, examples, and migration notes, refer to
+README.md in this directory.**
 
 ## Migration from 0.x to 1.0.0
 
@@ -104,7 +135,7 @@ sbt scalafmt
 All Scala projects in ossuminc use this plugin. Add to `project/plugins.sbt`:
 
 ```scala
-addSbtPlugin("com.ossuminc" % "sbt-ossuminc" % "1.0.0")
+addSbtPlugin("com.ossuminc" % "sbt-ossuminc" % "1.2.4")
 ```
 
 ### Example CrossModule Definition

README.md

@@ -82,7 +82,7 @@ In your `project/plugins.sbt` file, add the GitHub Packages resolver and the plu
 // GitHub Packages resolver for sbt-ossuminc
 resolvers += "GitHub Packages" at "https://maven.pkg.github.com/ossuminc/sbt-ossuminc"
 
-addSbtPlugin("com.ossuminc" % "sbt-ossuminc" % "1.2.0")
+addSbtPlugin("com.ossuminc" % "sbt-ossuminc" % "1.2.4")
 ```
 
 ### ~/sbt/1.0/github.sbt
@@ -445,16 +445,59 @@ Shortcuts that combine multiple helpers:
 
 These helpers accept parameters for customization:
 
-#### **`With.Akka.forRelease(release: String)`**
+#### **`With.Akka.forRelease(...)`**
 Add Akka dependencies to the project. Akka requires a commercial license and repository token since 2024.
-- **`release`**: Akka version (`"24.10"` or `"25.10"` (latest))
 
+**Parameters:**
+- **`release`**: Akka version (`"24.10"` or `"25.10"` (latest), default: `""` = latest)
+- **`withHTTP`**: Include Akka HTTP modules (default: `false`)
+- **`withGrpc`**: Include Akka gRPC runtime (default: `false`)
+- **`withPersistence`**: Include Akka Persistence R2DBC (default: `false`)
+- **`withProjections`**: Include Akka Projections (default: `false`)
+- **`withManagement`**: Include Akka Management core (health checks, cluster HTTP) (default: `false`)
+- **`withManagementKubernetes`**: Include Kubernetes modules (discovery, lease, rolling updates) (default: `false`)
+- **`withKafka`**: Include Alpakka Kafka connector (default: `false`)
+- **`withInsights`**: Include Akka Insights/Cinnamon telemetry (default: `false`)
+- **`withInsightsPrometheus`**: Include Prometheus export (default: `true`, only applies when `withInsights = true`)
+- **`withInsightsOpenTelemetry`**: Include OpenTelemetry tracing (default: `true`, only applies when `withInsights = true`)
+
+**Basic usage (core modules only):**
 ```scala
 Module("my-actor-system")
   .configure(With.Akka.forRelease("25.10"))
 ```
 
-> **Note**: Akka repository access requires a token. Configure per Akka's instructions at https://akka.io/key
+**Full-featured server example:**
+```scala
+Module("my-server")
+  .configure(With.Akka.forRelease(
+    "25.10",
+    withHTTP = true,
+    withPersistence = true,
+    withProjections = true,
+    withManagement = true,
+    withManagementKubernetes = true,
+    withInsights = true
+  ))
+```
+
+**Modules included by default (core):**
+- akka-actor, akka-actor-typed
+- akka-cluster, akka-cluster-typed, akka-cluster-sharding, akka-cluster-sharding-typed, akka-cluster-tools
+- akka-coordination, akka-discovery, akka-distributed-data
+- akka-persistence, akka-persistence-typed, akka-persistence-query
+- akka-remote, akka-serialization-jackson, akka-slf4j
+- akka-stream, akka-stream-typed
+- Test: akka-testkit, akka-actor-testkit-typed, akka-stream-testkit
+
+> **Note**: Akka repository access requires `AKKA_REPO_TOKEN` environment variable.
+> Get your token at https://account.akka.io
+
+> **Note for riddl-server-infrastructure dependents:** If your project depends on
+> `riddl-server-infrastructure`, Akka core and HTTP modules are already provided
+> transitively. Only use `With.Akka.forRelease()` if you need additional modules
+> beyond what the server infrastructure provides (e.g., Kafka, Insights, Management,
+> Projections, or specific persistence backends).
 
 #### **`With.AsciiDoc(...)`**
 Configure AsciiDoc document generation for static websites and PDFs.