Initial commit from ux_aura_central

instructions.md

@@ -0,0 +1,43 @@
+
+# 🚀 Getting Started with Aura Craft Studio
+
+This template is a pre-wired, modular framework designed for AI-accelerated development. Follow these two steps to build your application.
+
+## 1️⃣ Step 1: Manual Setup
+Before using AI prompts, manually update `metadata.json` in the root directory. This tells the system who you are and what you are building.
+
+```json
+{
+  "name": "Your App Name",
+  "description": "Clear description of your app's purpose",
+  "organization": "YourOrg",
+  "project": "YourProject",
+  "component": "YourApp"
+}
+```
+*Note: The `organization`, `project`, and `component` fields are critical for the AI to fetch your specific system instructions and prompts from the CMS.*
+
+## 2️⃣ Step 2: AI-Driven Development
+From this point forward, use the **Mandatory Prompt Template** below for every change or feature request. This ensures the AI respects the modular architecture and safety rules.
+
+### 📋 Mandatory Prompt Template
+Copy and paste this into your prompt when asking for updates:
+
+> "I want to [describe your request].
+> 
+> **MANDATORY CONSTRAINTS:**
+> 1. **STRICT ADHERENCE TO rules.md**: Read and follow all rules in `rules.md` without exception.
+> 2. **CONTAINER/VIEW PATTERN**: Separate logic into smart `*Container.tsx` files and UI into presentational `*View.tsx` files.
+> 3. **200-LINE LIMIT**: No single file may exceed 200 lines of code. Decompose into smaller modules or custom hooks if necessary.
+> 4. **WIRING PROTECTION**: Do not modify core infrastructure files (Auth, API Utils, Gemini Service).
+> 5. **AESTHETICS**: Use Tailwind CSS with full dark mode support (`dark:` variants) and responsive prefixes.
+> 6. **MODULARITY**: Group new features under `features/[feature-name]/`."
+
+---
+
+## 🛠️ Developer Reference (For the AI)
+- **`useAuth()`**: Access user identity and RBAC permissions.
+- **`useTheme()`**: Toggle between light and dark modes.
+- **`generateResponse()`**: Call Gemini via the HumanizeIQ proxy without managing keys.
+- **`apiService.ts`**: Standardized R2 cloud storage operations (Upload/Download/List).
+- **`rules.md`**: The source of truth for all architectural constraints.