feat: scaffold and config

1 files changed, 26 insertions, 0 deletions

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..19705e0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,26 @@
+# deck-it
+
+A tablet dashboard, stream-deck, and second monitor for a Slackware-current
+Hyprland desktop, themed by
+[unified-desktop-theme](https://git.danix.xyz/unified-desktop-theme/).
+
+An Android tablet shows an always-on control surface served over `adb reverse`,
+plus a virtual Hyprland monitor streamed with wayvnc and shown in AVNC. The
+surface is a module system: system stats, music, windows, OBS, LLM usage and
+build status plug in independently.
+
+Status: in development. The design is in
+`docs/superpowers/specs/`, the plan in `docs/superpowers/plans/`.
+
+## License
+
+Not decided yet. Portions derived from tabdeck are MIT; see `NOTICE` and
+`LICENSE.tabdeck`.
+
+## 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.