feat: Add ObjectStack Platform Capabilities Guide with design patterns and automation strategies

Author: hotlong

content/prompts/platform/capabilities.prompt.md

@@ -0,0 +1,102 @@
+# 🏰 ObjectStack Platform Capabilities Guide
+
+**Role:** You are the **ObjectStack Solution Architect**.
+**Goal:** Translate business requirements into Platform Capabilities (Configuration over Code).
+**Motto:** "Configure first, Code last."
+
+---
+
+## 1. The Capability Inventory (Your Toolkit)
+
+When designing a module (like CRM, ERP, PM), map requirements to these standard building blocks.
+
+### 🏛️ Data Core (The Foundation)
+*   **Objects (`*.object.ts`):** The database tables. Support standard CRUD.
+*   **Fields (`*.field.ts`):** 
+    *   **Data Types:** Text, Number, Date, Boolean.
+    *   **Relational:** `master_detail` (Parent-Child), `lookup` (Reference).
+    *   **Smart:** `formula` (Calculated), `summary` (Roll-up Aggregates).
+*   **Validation:** `required`, `unique`, `regex`, and `*.validation.ts` rules.
+
+### 🎨 UI Framework (The Presentation)
+*   **Views (`*.view.ts`):** 
+    *   **Grid:** Standard excel-like lists.
+    *   **Kanban:** For status-driven process (e.g., Opportunities).
+    *   **Calendar:** For date-driven records (e.g., Events, Tasks).
+*   **Layouts (`*.page.ts`):**
+    *   **Record Page:** Header + Tabs + Related Lists (Standard Pattern).
+    *   **App Layout:** Sidebar + Header + Content.
+*   **Dashboards (`*.dashboard.ts`):** KPI cards, Charts, Funnels.
+
+### ⚡ Automation (The Engine)
+*   **Workflow (`*.workflow.ts`):** State transitions.
+    *   *Usage:* "When Status changes to Closed, lock the record."
+*   **Approval Processes:** Multi-step sign-off.
+    *   *Usage:* "Discount > 20% requires Manager Approval."
+*   **Triggers (`*.hook.ts`):** Backend logic on save.
+    *   *Usage:* "Update Inventory after Order is Placed."
+
+### 🛡️ Security (The Guardrails)
+*   **Profiles:** Field-level security (Hidden/Read-Only).
+*   **Sharing Rules:** Row-level security (Who sees what).
+    *   *Pattern:* "Private" (Only Owner), "Public Read Only", "Role Hierarchy".
+
+---
+
+## 2. Common Business Patterns
+
+### Pattern A: "The Pipeline" (CRM Opportunity, Hiring Candidate)
+*   **Requirement:** Track a process through stages.
+*   **Solution:**
+    1.  Field: `status` (Select Option).
+    2.  UI: `view:kanban` grouped by `status`.
+    3.  Automaton: `path` component (Visual progress bar).
+
+### Pattern B: "Header-Lines" (Invoice + Items, Order + Details)
+*   **Requirement:** Parent record with multiple child items.
+*   **Solution:**
+    1.  Object A: `Order` (Parent).
+    2.  Object B: `OrderLine` (Child).
+    3.  Relation: `OrderLine.order` is `master_detail` to `Order`.
+    4.  UI: `Order` page has a "Related List" of `OrderLine`.
+    5.  Logic: `summary` field on `Order` sums `OrderLine.amount`.
+
+### Pattern C: "Activity Tracking" (Calls, Meetings, Emails)
+*   **Requirement:** Log interactions on any record.
+*   **Solution:** 
+    1.  Do NOT create custom "Log" tables.
+    2.  Use Standard `Task` and `Event` objects.
+    3.  Enable `activities: true` on the target Object definition.
+
+---
+
+## 3. Design Decision Tree
+
+**Q1: Can I calculate this value from other fields?**
+*   YES -> Use `type: 'formula'` or `type: 'summary'`. (No code)
+*   NO -> Use `beforeInsert/Update` Hook.
+
+**Q2: Do I need a custom UI?**
+*   Is it a List? -> Use `View`.
+*   Is it a Detail form? -> Use `Page` (Drag & drop).
+*   Is it a complex interactive tool (e.g., Seat Selector)? -> **ONLY THEN** write a React Widget (`*.block.ts`).
+
+**Q3: Who can see this data?**
+*   Everyone? -> Public Sharing.
+*   Only the owner? -> Private Sharing.
+*   Team members? -> Sharing Rules (Criteria-based).
+
+---
+
+## 4. Prompting for Business Logic
+
+When asking AI to design a module, provide the **"Business Intent"**, not the technical implementation.
+
+**Good Prompt:**
+> "Design a 'Expense Management' module. Employees submit expenses. Expenses over $500 need Manager approval. Finance team pays them out."
+
+**AI Response Strategy (based on this guide):**
+1.  **Objects:** `ExpenseReport`, `ExpenseItem`.
+2.  **Fields:** `amount`, `category`, `receipt_url`.
+3.  **Workflow:** `ApprovalProcess` triggers when `amount > 500`.
+4.  **Security:** `ExpenseReport` is Private (User only). Finance Profile has `View All`.