[RickUsingGitHub]

What changes

Documentation only, plus comments; no behaviour changes.

• README.md restructured for users:
  • getting started, what each tab does and where the numbers come from;
  • data completeness, privacy, developer commands and links to the docs below;
  • limitations and the disclaimer, unchanged.
• docs/ARCHITECTURE.md:
  • script load order, the Amber namespace and a module map;
  • the data model: sites, usage items, the IndexedDB cache, plan configs and the planner's half-hourly year;
  • how each tab works, including the planner engine;
  • storage keys, external data (AEMO, PVGIS), the CSP, build, tests, CI and the release steps.
• docs/FRONTEND.md, the UI contract for a redesign:
  • the constraints: no JS build, the CSP, prebuilt Tailwind, the IDs and data-* hooks the JS and tests use, help keys, and not using Amber's branding;
  • the page and tab inventory, the styling system and the JS-built UI;
  • responsive and accessibility notes, writing style, and known UI issues and opportunities.
• docs/REVIEW.md: invariants, risk areas, known technical debt, questions for reviewers and a test map.
• CLAUDE.md: short working rules for AI coding agents (commands, codebase rules, release checklist).
• Module header comments for the 13 modules that had none.

Testing

• All unit tests pass.
• All 54 Playwright tests pass locally.

---

Generated by Claude Code