Align documentation to standard conventions (ADR-004)

Create CLAUDE.md, migrate root-level docs into docs/, convert backlog
to P0-P3 format, add adr/research directory scaffolding.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: gregfelice

BACKLOG.md

@@ -0,0 +1,87 @@
+# DailyDriver
+
+Visual keyboard shortcut configuration tool for GNOME/Wayland with presets, cheat sheet overlay, and conflict detection.
+
+## Quick Reference
+
+```bash
+# Dev environment
+cd /home/gregf/development/dailydriver-standalone
+source venv/bin/activate
+PYTHONPATH=src pytest tests/unit/ -v
+
+# Lint
+ruff check src/ tests/
+ruff format src/ tests/
+
+# Build Flatpak locally
+flatpak-builder --force-clean --user --install build-dir io.github.gregfelice.DailyDriver.yml
+
+# Run dev mode
+./run-dev.sh
+```
+
+## Architecture
+
+GTK4/Libadwaita app using Python with Meson build system. Packaged as Flatpak.
+
+```
+src/dailydriver/
+  application.py          # App entry point, GtkApplication subclass
+  window.py               # Main window (42k - largest file, handles all views)
+  models/
+    shortcut.py           # Shortcut data model
+    keyboard.py           # Keyboard layout model
+    profile.py            # Profile/preset model
+  services/
+    gsettings_service.py  # Reads/writes GNOME keyboard shortcuts via dconf
+    keyboard_config_service.py  # Orchestrates shortcut configuration
+    profile_service.py    # Loads/saves preset profiles (TOML)
+    hardware_service.py   # Keyboard hardware detection
+    hid_apple_service.py  # Mac keyboard hid-apple module config
+    backends/             # Desktop-specific backends (GNOME, future KDE/Hyprland)
+  views/
+    keyboard_view.py      # Visual keyboard display
+    cheatsheet.py         # Cheat sheet overlay (Alt+Super+/)
+    preset_selector.py    # Preset selection UI
+    shortcut_editor.py    # Individual shortcut editing
+    shortcut_list.py      # Shortcuts list by category
+```
+
+Key patterns:
+- GTK requires `gi.require_version()` before imports; ruff E402 is suppressed for these files
+- Services are injected into views, not imported directly
+- Presets are TOML files defining complete shortcut sets ("clean slate" approach)
+- GNOME does NOT support xdg-desktop-portal GlobalShortcuts; app falls back to gnome-settings-daemon keybindings
+
+## Conventions
+
+- **Python**: 3.11+, ruff for linting/formatting, line length 100
+- **Testing**: pytest with pytest-cov, pytest-mock; tests in `tests/unit/`; 220+ tests
+- **Packaging**: Use `uv pip` for installs, Meson build system, Flatpak for distribution
+- **Git**: Conventional commit messages
+- **Branching**: main branch, push to GitHub
+- **App ID**: `io.github.gregfelice.DailyDriver` (reverse DNS for Flatpak/Flathub)
+
+## Key Documentation
+
+- `docs/BACKLOG.md` - Prioritized backlog (P0-P3)
+- `docs/STATUS.md` - Project status and last session notes
+- `docs/RELEASING.md` - Version numbering and release process
+- `docs/FLATPAK_SUBMISSION_GUIDE.md` - Flathub submission reference
+- `docs/adr/` - Architecture decision records
+- `docs/research/` - Research notes
+- `flathub/FLATHUB_PR.md` - Flathub PR description and permission justifications
+
+## Status
+
+**v0.1.0-alpha** - Application is solid and running well on GNOME/Wayland.
+
+- 220 tests passing, 6 failing (mock setup issues in custom keybinding tests)
+- 29% code coverage (core services well tested; UI views untested)
+- CI/CD operational via GitHub Actions
+- Flathub submission pending review
+- AUR package published
+- Known platform limitation: GNOME does not implement xdg-desktop-portal GlobalShortcuts
+
+See `docs/BACKLOG.md` for current priorities.

CLAUDE.md

@@ -0,0 +1,53 @@
+# DailyDriver Backlog
+
+Prioritized bugs, features, and improvements for DailyDriver development.
+
+---
+
+## P0 - Critical
+
+- [ ] Update `ShortcutGrabberService` to detect GNOME and skip portal attempt (cleaner logs, no error spam)
+- [ ] Capture screenshots and finalize AppStream metainfo for Flathub submission
+- [ ] Screenshots for hypr / apple presets don't work - should show equivalent of apple keys
+- [ ] `<D-/>` shortcut bug (slash key with Super modifier)
+- [ ] Fix 6 failing custom keybinding tests (mock setup refinement needed)
+
+**Completed:**
+- [x] Test compositor shortcut grabs on a live GNOME Wayland session (tested, doesn't work - GNOME limitation)
+
+---
+
+## P1 - Next Sprint
+
+- [ ] Flathub beta channel submission
+- [ ] Research GNOME Shell extension approach for global shortcuts (extension exposes GrabAccelerator to DailyDriver via custom D-Bus interface)
+- [ ] Background daemon mode (`dailydriver --daemon`) for persistent shortcut grabs (useful when GlobalShortcuts works)
+- [ ] Make detection methods on GSettingsService public API (`_detect_terminal` etc.)
+- [ ] Add "Shortcut Status" indicator in UI showing compositor grab state (and GNOME limitation warning)
+- [ ] Integration test for ShortcutGrabberService with `python-dbusmock`
+- [ ] GNOME schema version validation in preset tests
+- [ ] Add CI notification (GitHub status badge)
+
+---
+
+## P2 - Soon
+
+- [ ] KDE Plasma backend
+- [ ] Hyprland backend
+- [ ] AUR PKGBUILD
+- [ ] Snap Store packaging
+- [ ] GNOME Circle application
+- [ ] Auto-update checker for new versions
+- [ ] Per-shortcut compositor grab toggle in UI
+- [ ] Monitor GNOME GlobalShortcuts portal implementation progress
+- [ ] Custom shortcut editor (create new shortcuts)
+- [ ] Import/export profiles
+
+---
+
+## P3 - Future
+
+- [ ] COPR (Fedora) packaging
+- [ ] Keyboard layout auto-detection (QWERTY/Dvorak/Colemak)
+- [ ] User-contributed preset marketplace / sharing
+- [ ] Multi-monitor shortcut awareness