From 20d2c2ab1891aeffaa5f147306edd04c324ff462 Mon Sep 17 00:00:00 2001
From: Kaden Napper <kaden@napper.au>
Date: Mon, 27 Jul 2026 08:56:30 +1000
Subject: [PATCH] chore: initialise Napper website repository

---
 AGENTS.md       | 50 +++++++++++++++++++++++++++++++++++++++++++++++++
 README.md       | 20 ++++++++++++++++++++
 docs/.gitignore | 32 +++++++++++++++++++++++++++++++
 3 files changed, 102 insertions(+)
 create mode 100644 AGENTS.md
 create mode 100644 README.md
 create mode 100644 docs/.gitignore

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..23be489
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,50 @@
+# AGENTS.md
+
+## Project purpose
+
+This repository contains the public website for the Napper application ecosystem.
+
+The site includes:
+
+- the main `napper.au` landing site;
+- the Hudra product site;
+- the Lildra product site;
+- the Pendra product site;
+- shared legal, privacy, support and ecosystem content.
+
+## Source of truth
+
+The repository is the source of truth, not individual conversations or AI sessions.
+
+When an important architectural, deployment, naming or development decision is made:
+
+1. update the appropriate repository documentation;
+2. update this file when the guidance affects AI contributors;
+3. avoid relying on undocumented conversational context.
+
+## Working principles
+
+- Keep the site simple and maintainable.
+- Prefer conventional web technologies over unnecessary frameworks.
+- Avoid dependencies unless they provide a clear benefit.
+- Preserve accessibility, responsive design and fast page loads.
+- Reuse shared styles and components where practical.
+- Keep each application page focused on what the application does.
+- Do not describe Hudra as a general-purpose editor.
+- Treat Hudra primarily as a presentation and slide-viewing system for QLearn.
+- Do not expose secrets, credentials or server-specific private data.
+- Keep deployment configuration documented and reproducible.
+
+## Expected workflow
+
+1. Review existing documentation before changing architecture.
+2. Make focused changes.
+3. Test locally where possible.
+4. Update documentation when behaviour or structure changes.
+5. Commit using a clear, descriptive message.
+
+## Project structure
+
+The final structure will be documented after the existing website is imported and audited.
+
+Do not invent a new architecture before inspecting the existing site.
\ No newline at end of file
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..96e0966
--- /dev/null
+++ b/README.md
@@ -0,0 +1,20 @@
+# Napper Website
+
+Source code and deployment configuration for the Napper website and application ecosystem.
+
+## Websites
+
+- <https://napper.au>
+- <https://napper.au/hudra>
+- <https://napper.au/lildra>
+- <https://napper.au/pendra>
+
+## Repository philosophy
+
+The repository is the source of truth, not the conversation.
+
+Important architectural, development and deployment decisions must be recorded in the repository so that future contributors and AI coding sessions inherit the correct project context.
+
+## Current status
+
+The repository has been created and is being prepared for the import of the existing `napper.au` website.
\ No newline at end of file
diff --git a/docs/.gitignore b/docs/.gitignore
new file mode 100644
index 0000000..a5a4f6e
--- /dev/null
+++ b/docs/.gitignore
@@ -0,0 +1,32 @@
+# Operating system files
+.DS_Store
+Thumbs.db
+desktop.ini
+
+# Editors
+.vscode/*
+!.vscode/extensions.json
+!.vscode/settings.json
+.idea/
+
+# Temporary files
+*.tmp
+*.temp
+*.log
+*.bak
+*.swp
+
+# Environment and secrets
+.env
+.env.*
+!.env.example
+
+# Dependencies and generated output
+node_modules/
+vendor/
+dist/
+build/
+.cache/
+
+# Deployment files
+.deploy/
\ No newline at end of file