ux_aura_assistant/instructions.md

🚀 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.

{
  "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.