@@ -0,0 +1,13 @@
+{
+  "version": 1,
+  "hooks": {
+    "postToolUse": [
+      {
+        "type": "command",
+        "matcher": "edit|create|apply_patch",
+        "bash": "[ ! -f \"$(git rev-parse --show-toplevel)/.github/skills/impeccable/scripts/impeccable\" ] || \"$(git rev-parse --show-toplevel)/.github/skills/impeccable/scripts/impeccable\" hook",
+        "timeoutSec": 5
+      }
+    ]
+  }
+}
@@ -10,3 +10,6 @@ patched/C4Patcher.exe
 
 .env
 .serena/
+.claude
+.github/agents
+.impeccable
@@ -0,0 +1,57 @@
+# Product
+
+<!-- impeccable:product-schema 1 -->
+
+## Platform
+
+web
+
+## Users
+
+Returning Caesar IV players, mostly owners of the Steam release, who want the game's dead online mode back. On the website they register a governor, download and run C4Patcher.exe on the Windows machine with the game, then come back to check the Caesar's Challenge and Empire leaderboards, governor profiles, and their uploaded cities.
+
+## Product Purpose
+
+Caesar IV Online restores the game's original online mode by replacing the defunct official backend with a gateway that speaks the MySQL protocol the game's ODBC client expects. The website is where players sign up, get connected, and see results. Success means a player goes from owning the game to appearing on a leaderboard without manual file surgery, and keeps returning to compare their cities.
+
+## Positioning
+
+It brings back the game's own built-in online buttons, screens and scoring rather than adding a third-party layer: the game talks to this server as if it were the original, and the site is the destination the in-game Website, Create New and Lost Password buttons open.
+
+## Operating Context
+
+- One public instance is the canonical community server; self-hosting via Docker or the Go binary is supported but secondary.
+- Players move between the website and Caesar IV on Windows: register on the site, download the patcher or manual files, close the game, patch, launch, play online scenarios.
+- Caesar's Challenge rotates one season per calendar year (UTC), each with its own line-up drawn from scenarios with a reachable population goal.
+- Pages: home, /challenge, /empire, /governor, /city, /register, /signin, /account (setup and connection token).
+
+## Capabilities and Constraints
+
+- Static vanilla HTML/CSS/JS embedded in the Go binary (gateway/internal/web/static); no framework or build step today.
+- Accounts with registration (can be closed per server), sign-in, and per-account NewConstants.txt connection tokens; reissuing a token invalidates the old file.
+- No password reset exists.
+- Setup targets the 32-bit Windows game: C4Patcher.exe, or manual install of the MariaDB 32-bit ODBC 3.1.22 driver, registry aliases, and patched data files.
+- The game uploads a city's buildings but not its roads; city maps and counts omit roads.
+- Alt+Tab during a Caesar's Challenge scenario ends the online session unless the patcher's fix is applied.
+
+## Brand Commitments
+
+- Name: Caesar IV Online.
+- Binding: the UI uses Caesar IV's own art (dialog, panel, marble, laurel, scroll, frame, ornament sprites, logo, scenario and map images, building help icons, button sounds) and keeps that in-game look.
+- Observed but not confirmed as binding: the Roman-administration voice in copy ("governor", "rolls of Rome", "province").
+
+## Evidence on Hand
+
+- Scenario overviews, goals, preview and map images: gateway/internal/web/static/scenarios.json, static/img/scenarios, static/img/maps.
+- Building icons: static/img/buildings.
+- Background write-up: https://xetera.dev/article/bringing-back-caesar-iv-online
+- Patcher releases with build attestations on the GitHub releases page.
+- Live leaderboard, governor and city data from the server's API.
+- No testimonials, player counts, or press exist; do not invent them.
+
+## Product Principles
+
+- The game is the product; the site serves getting into it and seeing what happened in it.
+- Setup must be followable by a non-technical player, with a manual path for when the patcher can't be used.
+- Show real recorded results only, and state plainly when data is missing or not sent by the game.
+- Stay faithful to Caesar IV's own look and mechanics rather than reinterpreting them.
@@ -107,6 +107,7 @@ func serve(args []string) error {
 	fs.StringVar(&site.PublicURL, "public-url", envOr("C4GW_PUBLIC_URL", "http://127.0.0.1:8080"), "the website's address as players see it (governor links in NewConstants.txt)")
 	fs.StringVar(&site.UmamiScript, "umami-script", envOr("C4GW_UMAMI_SCRIPT", ""), "URL of an Umami tracker script to load on the website, empty to disable")
 	fs.StringVar(&site.UmamiWebsiteID, "umami-website-id", envOr("C4GW_UMAMI_WEBSITE_ID", ""), "Umami website ID for -umami-script")
+	fs.StringVar(&site.StaticDir, "static-dir", envOr("C4GW_STATIC_DIR", ""), "serve the website from this directory (internal/web/static) instead of the built-in copy, re-read on every request")
 	fs.BoolVar(&site.Registration, "registration", envOr("C4GW_REGISTRATION", "1") != "0", "let anyone create an account on the website")
 	secret := envOr("C4GW_WEB_SECRET", "")
 	site.Secret = []byte(secret)