diff --git a/README.md b/README.md
index 649f79e..f86dc04 100644
--- a/README.md
+++ b/README.md
@@ -285,7 +285,7 @@ eyrie is part of the hawk-eco:
 ### Build & Test
 
 ```bash
-go build ./cmd/eyrie          # Build binary
+go build ./...               # Verify the library compiles
 go test -race ./...           # Run all tests with race detector
 make ci                       # Run full CI suite (lint, test, security)
 make cover                    # Generate coverage report
diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
index 8bbdfd3..2bf5a45 100644
--- a/docs/ARCHITECTURE.md
+++ b/docs/ARCHITECTURE.md
@@ -24,8 +24,7 @@ eyrie is the LLM provider runtime for the hawk ecosystem. It sits between the ap
 
 ```
 eyrie/
-├── cmd/eyrie/               ⚡ Entry point — CLI arg parsing, server startup
-├── api/openapi.yaml         📜 REST API contract (OpenAPI 3.1)
+├── api/openapi.yaml         📜 REST API contract (OpenAPI 3.1) — embedded HTTP server surface
 ├── client/
 │   ├── client.go            🔌 Provider interface + EyrieClient factory
 │   ├── anthropic.go         🟠 Anthropic Claude provider