chore: add badges via .gomarkdoc.yml, fix doc link warnings

- Add .gomarkdoc.yml with header containing CI, Go Report Card,
  GoDoc, and License badges
- Fix gomarkdoc warnings by replacing WorkerContext.Add/Remove/Children
  doc links with plain text (gomarkdoc can't resolve interface methods)

Author: ankurs

.gomarkdoc.yml

@@ -0,0 +1,17 @@
+output: "{{.Dir}}/README.md"
+header: |+
+  # Workers
+
+  [![Go](https://github.com/go-coldbrew/workers/actions/workflows/go.yml/badge.svg)](https://github.com/go-coldbrew/workers/actions/workflows/go.yml)
+  [![Go Report Card](https://goreportcard.com/badge/github.com/go-coldbrew/workers)](https://goreportcard.com/report/github.com/go-coldbrew/workers)
+  [![GoDoc](https://pkg.go.dev/badge/github.com/go-coldbrew/workers.svg)](https://pkg.go.dev/github.com/go-coldbrew/workers)
+  [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+
+  **A worker lifecycle library for Go — manage background goroutines with panic recovery, configurable restart, tracing, and structured shutdown.**
+
+  Built on [suture](https://github.com/thejerf/suture) for Erlang-style supervisor trees. Part of the [ColdBrew](https://docs.coldbrew.cloud) framework.
+
+  ---
+
+  ## API Reference
+

README.md

@@ -1,5 +1,22 @@
 <!-- Code generated by gomarkdoc. DO NOT EDIT -->
 
+# Workers
+
+[![Go](https://github.com/go-coldbrew/workers/actions/workflows/go.yml/badge.svg)](https://github.com/go-coldbrew/workers/actions/workflows/go.yml)
+[![Go Report Card](https://goreportcard.com/badge/github.com/go-coldbrew/workers)](https://goreportcard.com/report/github.com/go-coldbrew/workers)
+[![GoDoc](https://pkg.go.dev/badge/github.com/go-coldbrew/workers.svg)](https://pkg.go.dev/github.com/go-coldbrew/workers)
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+
+**A worker lifecycle library for Go — manage background goroutines with panic recovery, configurable restart, tracing, and structured shutdown.**
+
+Built on [suture](https://github.com/thejerf/suture) for Erlang-style supervisor trees. Part of the [ColdBrew](https://docs.coldbrew.cloud) framework.
+
+---
+
+## API Reference
+
+
+
 # workers
 
 ```go
@@ -13,7 +30,7 @@ Package workers provides a worker lifecycle library for Go, built on [thejerf/su
 Every worker runs inside its own supervisor subtree. This means:
 
 - Each worker gets panic recovery and restart independently
-- Workers can dynamically spawn child workers via WorkerContext.Add
+- Workers can dynamically spawn child workers via [WorkerContext](<#WorkerContext>)
 - When a parent worker stops, all its children stop \(scoped lifecycle\)
 - The supervisor tree prevents cascading failures and CPU\-burn restart storms
 
@@ -38,7 +55,7 @@ Common patterns are provided as helpers:
 
 ### Dynamic Workers
 
-Manager workers can spawn and remove child workers at runtime using WorkerContext.Add, WorkerContext.Remove, and WorkerContext.Children. Children join the parent's supervisor subtree and get full framework guarantees \(tracing, panic recovery, restart\). See \[Example\_dynamicWorkerPool\].
+Manager workers can spawn and remove child workers at runtime using the Add, Remove, and Children methods on [WorkerContext](<#WorkerContext>). Children join the parent's supervisor subtree and get full framework guarantees \(tracing, panic recovery, restart\). See \[Example\_dynamicWorkerPool\].
 
 <details><summary>Example (Dynamic Worker Pool)</summary>
 <p>

worker.go

@@ -6,7 +6,7 @@
 //
 // Every worker runs inside its own supervisor subtree. This means:
 //   - Each worker gets panic recovery and restart independently
-//   - Workers can dynamically spawn child workers via [WorkerContext.Add]
+//   - Workers can dynamically spawn child workers via [WorkerContext]
 //   - When a parent worker stops, all its children stop (scoped lifecycle)
 //   - The supervisor tree prevents cascading failures and CPU-burn restart storms
 //
@@ -29,7 +29,7 @@
 // # Dynamic Workers
 //
 // Manager workers can spawn and remove child workers at runtime using
-// [WorkerContext.Add], [WorkerContext.Remove], and [WorkerContext.Children].
+// the Add, Remove, and Children methods on [WorkerContext].
 // Children join the parent's supervisor subtree and get full framework
 // guarantees (tracing, panic recovery, restart). See [Example_dynamicWorkerPool].
 //