diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index bf2323b..f85ca97 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -47,11 +47,9 @@ separate maintainer commands, but do not add ClawHub-specific flags to
 
 Good starting points:
 
-- [Contributing guide](docs/contributing.md)
 - [Adding scanner adapters](docs/scanners.md#adding-a-built-in-scanner-adapter)
 - [Running benchmarks](docs/benchmarks.md)
-- [Improving ClawHub scans](docs/improving-clawhub-scans.md)
-- [Development commands](docs/development.md)
+- [Improving ClawHub scans](docs/benchmarks.md#submitting-a-patch-to-the-clawhub-profile)
 - [Security policy](SECURITY.md)
 
 ## Validation
diff --git a/docs/scanners.md b/docs/scanners.md
index f4c0157..ba310c0 100644
--- a/docs/scanners.md
+++ b/docs/scanners.md
@@ -23,6 +23,24 @@ profile, and scanner names are sanitized for filesystem use; colliding paths
 receive numeric suffixes so every report is preserved. Read the recorded
 `outputPath` instead of reconstructing a filename from a target or scanner ID.
 
+## Adding a built-in scanner adapter
+
+First evaluate the scanner with a [custom profile](#profile-scanner-configuration)
+and discuss built-in adoption with maintainers. Adding an adapter also means
+maintaining its dependency, target support, and output contract.
+
+Implement the adapter in `internal/runner/` and register it in
+`defaultScannerAdapters` in `scanner_registry.go`. Declare required and optional
+environment variables, install and verification commands, and supported target
+kinds in the registry. Preserve upstream JSON evidence and report skipped or
+failed scans explicitly. Command-backed scanners use the Docker runner by default;
+include a pinned runtime dependency when the adapter requires it.
+
+Add fixture-backed tests for valid output, malformed output, process failures,
+and unsupported targets. Update this scanner catalog and the README catalog,
+then run the Go tests, `go vet`, and `make docs-site` from the contributing guide.
+Never put credentials in flags, fixtures, or scan artifacts.
+
 ## Profile scanner configuration
 
 A trusted config can mix built-in scanner IDs with user-defined command