init: ai-prompts repo with project briefings and onboarding prompts

README.md

@@ -0,0 +1,79 @@
+# AI Prompts & Rules Repository
+
+Public repository of AI prompt rules, context files, and briefing documents
+organised by project. Any AI or server can read these files directly.
+
+**Hosted at:** https://g.pozi.co.za/gadmin/ai-prompts  
+**Owner:** Richard Brandon <richard@teacup.co.za>  
+**Access:** Public read-only. Authenticated write via API token.
+
+---
+
+## How to Use (for AIs and scripts)
+
+### Clone the whole repo
+```bash
+git clone https://g.pozi.co.za/gadmin/ai-prompts.git
+```
+
+### Fetch a single file without cloning
+```bash
+curl https://g.pozi.co.za/gadmin/ai-prompts/raw/branch/main/PROJECT/filename.md
+```
+
+### Pull latest updates into an existing clone
+```bash
+cd ai-prompts && git pull origin main
+```
+
+---
+
+## Folder Structure
+
+```
+ai-prompts/
+├── README.md               ← this file
+├── CONTRIBUTING.md         ← how to add new prompt files (read this)
+│
+├── gitea-server/           ← prompts about this Gitea server setup
+│   ├── server-briefing.md
+│   ├── client-ssh-setup.md
+│   └── new-server-onboarding.md
+│
+├── multiplan/              ← Multiplan PHP ERP project
+│   └── deployment-pipeline.md
+│
+├── dotfiles/               ← desktop/laptop dotfiles management
+│   └── dotfiles-setup.md
+│
+├── arduino/                ← Arduino projects and scripting
+│
+└── general/                ← general-purpose AI rules and prompts
+    └── git-conventions.md
+```
+
+---
+
+## File Naming Convention
+
+```
+PROJECT/
+  context-briefing.md     ← what this project IS (give to AI at session start)
+  setup-THING.md          ← how to set something up
+  rules-THING.md          ← rules/constraints AI must follow
+  prompt-TASK.md          ← prompt to give AI to perform a specific task
+```
+
+---
+
+## Raw File URLs
+
+All files are accessible as raw text at:
+```
+https://g.pozi.co.za/gadmin/ai-prompts/raw/branch/main/<folder>/<file>
+```
+
+Example:
+```bash
+curl https://g.pozi.co.za/gadmin/ai-prompts/raw/branch/main/gitea-server/server-briefing.md
+```