feat: add the module and the notification policy

The policy functions are pure so they are tested without a bus: urgency from
the hints, the timeout rule with its urgency defaults, the two stack tag
spellings, and the action pair parse.

1 files changed, 21 insertions, 0 deletions

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..75ee960
--- /dev/null
+++ b/README.md
@@ -0,0 +1,21 @@
+# notifyd
+
+A freedesktop notification daemon for this desktop, replacing dunst.
+
+The daemon owns `org.freedesktop.Notifications` and holds the state. It
+publishes the live queue and the history ring as JSON under
+`$XDG_RUNTIME_DIR/notifyd/` for a quickshell renderer to draw, and `notifyctl`
+is the only thing that talks back over D-Bus.
+
+    go build ./...
+
+The design and the exact file contract are in the quickshell repo, at
+`docs/superpowers/specs/2026-09-15-notification-daemon-design.md`.
+
+## Development Approach
+
+This project is developed using AI-assisted tools. Code is generated with the help of AI based on human-provided specifications, design decisions, and iterative feedback.
+
+All contributions are reviewed, tested, and curated by the maintainer before being included in the codebase. AI is used as a productivity and exploration tool, while human oversight remains central to all decisions.
+
+The goal is to combine the flexibility of AI-assisted development with standard open-source practices such as transparency, review, and accountability.