Clean up project structure

- Add README.md
- Move benchmark files to benchmarks/
- Move PLAN.md to .claude/
- Add .gitignore

7 files changed, 60 insertions, 0 deletions

diff --git a/PLAN.md b/.claude/PLAN.md
index 39d8318..39d8318 100644
--- a/PLAN.md
+++ b/.claude/PLAN.md
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..d6b130c
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1 @@
+.claude/settings.local.json
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..0e7c891
--- /dev/null
+++ b/README.md
@@ -0,0 +1,59 @@
+# nostr
+
+A Go library for the [Nostr protocol](https://github.com/nostr-protocol/nostr).
+
+```bash
+go get code.northwest.io/nostr
+```
+
+## Features
+
+- **Keys** — Generate, parse, and convert between hex/bech32 (npub/nsec)
+- **Events** — Create, sign, and verify NIP-01 events
+- **Filters** — Build subscription filters
+- **Relay** — WebSocket connections with publish/subscribe
+- **Tags** — Parse and build event tags
+
+## Usage
+
+```go
+package main
+
+import (
+    "context"
+    "fmt"
+    "code.northwest.io/nostr"
+)
+
+func main() {
+    // Generate a new key pair
+    key, _ := nostr.GenerateKey()
+    fmt.Println("npub:", key.Npub())
+
+    // Create and sign an event
+    event := &nostr.Event{
+        Kind:    nostr.KindTextNote,
+        Content: "Hello Nostr!",
+    }
+    event.Sign(key)
+
+    // Connect to a relay and publish
+    ctx := context.Background()
+    relay, _ := nostr.Connect(ctx, "wss://relay.damus.io")
+    defer relay.Close()
+
+    relay.Publish(ctx, event)
+}
+```
+
+## Examples
+
+See [examples/basic](examples/basic) for a complete runnable example.
+
+## Benchmarks
+
+Performance benchmarks are in [benchmarks/](benchmarks/).
+
+## License
+
+MIT
diff --git a/BENCHMARKS.md b/benchmarks/BENCHMARKS.md
index 1a671c1..1a671c1 100644
--- a/BENCHMARKS.md
+++ b/benchmarks/BENCHMARKS.md
diff --git a/BENCHMARK_SUMMARY.md b/benchmarks/BENCHMARK_SUMMARY.md
index 2e087a3..2e087a3 100644
--- a/BENCHMARK_SUMMARY.md
+++ b/benchmarks/BENCHMARK_SUMMARY.md
diff --git a/benchmark_results.txt b/benchmarks/benchmark_results.txt
index c3976e6..c3976e6 100644
--- a/benchmark_results.txt
+++ b/benchmarks/benchmark_results.txt
diff --git a/run_benchmarks.sh b/benchmarks/run_benchmarks.sh
index 87dfd17..87dfd17 100755
--- a/run_benchmarks.sh
+++ b/benchmarks/run_benchmarks.sh