From fac5f65e307fda58b1d5ccf9c036c315bc388d29 Mon Sep 17 00:00:00 2001
From: Kaden Napper <kaden@napper.au>
Date: Mon, 27 Jul 2026 10:26:39 +1000
Subject: [PATCH] test: verify automatic deployment

---
 TODO.md                                      | 19 +++++++++++++++++++
 VISION.md                                    | 11 +++++++++++
 docs/architecture.md                         |  0
 docs/decisions/0001-repository-philosophy.md |  0
 docs/decisions/0002-static-site.md           |  0
 docs/decisions/0003-product-structure.md     |  0
 docs/decisions/0004-shared-css-strategy.md   | 14 ++++++++++++++
 docs/deployment.md                           |  0
 8 files changed, 44 insertions(+)
 create mode 100644 TODO.md
 create mode 100644 VISION.md
 create mode 100644 docs/architecture.md
 create mode 100644 docs/decisions/0001-repository-philosophy.md
 create mode 100644 docs/decisions/0002-static-site.md
 create mode 100644 docs/decisions/0003-product-structure.md
 create mode 100644 docs/decisions/0004-shared-css-strategy.md
 create mode 100644 docs/deployment.md

diff --git a/TODO.md b/TODO.md
new file mode 100644
index 0000000..8331bc5
--- /dev/null
+++ b/TODO.md
@@ -0,0 +1,19 @@
+## Immediate
+
+- Fix QLearn URLs
+- Replace old Git release URL
+- Update README
+- Update AGENTS
+
+## Next
+
+- Add Lildra
+- Add Pendra
+- Shared CSS
+- Shared navigation
+
+## Future
+
+- Automatic deployment
+- Preview deployments
+- Analytics
\ No newline at end of file
diff --git a/VISION.md b/VISION.md
new file mode 100644
index 0000000..689a818
--- /dev/null
+++ b/VISION.md
@@ -0,0 +1,11 @@
+Napper exists to build focused, educator-first tools that solve real classroom problems.
+
+Each product should do one thing exceptionally well.
+
+Simplicity is preferred over features.
+
+Accessibility is preferred over visual novelty.
+
+The repository—not conversations—is the canonical source of project knowledge.
+
+AI assistants are expected to update documentation alongside code.
\ No newline at end of file
diff --git a/docs/architecture.md b/docs/architecture.md
new file mode 100644
index 0000000..e69de29
diff --git a/docs/decisions/0001-repository-philosophy.md b/docs/decisions/0001-repository-philosophy.md
new file mode 100644
index 0000000..e69de29
diff --git a/docs/decisions/0002-static-site.md b/docs/decisions/0002-static-site.md
new file mode 100644
index 0000000..e69de29
diff --git a/docs/decisions/0003-product-structure.md b/docs/decisions/0003-product-structure.md
new file mode 100644
index 0000000..e69de29
diff --git a/docs/decisions/0004-shared-css-strategy.md b/docs/decisions/0004-shared-css-strategy.md
new file mode 100644
index 0000000..98a02dc
--- /dev/null
+++ b/docs/decisions/0004-shared-css-strategy.md
@@ -0,0 +1,14 @@
+Status
+Accepted
+
+Context
+Hudra, Lildra and Pendra share navigation and branding.
+
+Decision
+Shared CSS lives in /css/ecosystem.css.
+Product-specific CSS stays beside each product.
+
+Consequences
+- less duplication
+- consistent branding
+- easier Codex sessions
\ No newline at end of file
diff --git a/docs/deployment.md b/docs/deployment.md
new file mode 100644
index 0000000..e69de29