1 files changed, 37 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5d74791
--- /dev/null
+++ b/README.md
@@ -0,0 +1,37 @@
+# unified-desktop-theme
+
+A single visual identity for a Hyprland desktop: Catppuccin Macchiato as the
+fixed base, Noto Sans for UI text, Inconsolata Nerd Font Mono for monospace.
+
+The accent color follows the current wallpaper, but is always snapped to a real
+Macchiato accent, so it can never render as unreadable.
+
+Phase 1 covers rofi. Later phases extend the same palette to waybar, dunst,
+conky, hyprland and quickshell.
+
+## Layout
+
+    rofi/udt/          the theme files
+    bin/udt-accent     wallpaper accent extractor
+
+Both are installed by symlink, so the repo holds the canonical copies:
+
+    ./install.sh
+
+## Design
+
+See `docs/superpowers/specs/` for the design spec and the reasoning behind
+each decision, including why accent extraction is deliberately isolated from
+the pywal cache.
+
+## License
+
+GPLv2 only. See `LICENSE`.
+
+## 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.