@salesforce/afv-skills 1.8.0 → 1.9.0

package/skills/generating-visual-diagrams/assets/architecture/integration-flow.md

@@ -0,0 +1,55 @@
+# Architecture Template: Integration Flow
+
+## Prompt Template
+
+```
+Professional Salesforce integration architecture diagram:
+
+SYSTEMS:
+[List systems with types and icons]
+
+INTEGRATION PATTERNS:
+[List integrations with protocols and directions]
+
+COMPONENTS:
+- API Gateway (if applicable)
+- Authentication layer
+- Middleware/ESB (if applicable)
+- Error handling/retry logic
+
+STYLING:
+- Cloud icon for Salesforce
+- Server icons for external systems
+- Arrows with protocol labels
+- Color coding by system type
+- Professional diagram style
+
+FORMAT:
+- Landscape orientation
+- Left-to-right or hub-spoke layout
+- Include legend
+```
+
+## Example
+
+```bash
+gemini "/generate 'Salesforce integration architecture diagram:
+
+Systems:
+1. Salesforce (cloud icon, blue)
+2. MuleSoft (middleware icon, purple)
+3. SAP ERP (server icon, orange)
+
+Flows:
+1. Salesforce --REST--> MuleSoft --BAPI--> SAP
+   - Account/Contact sync (bidirectional)
+
+2. SAP --Events--> MuleSoft --Platform Events--> Salesforce
+   - Invoice updates
+
+Include:
+- OAuth 2.0 authentication badges
+- Error queue for failed messages
+
+Style: Professional, clean lines, pastel colors'"
+```

package/skills/generating-visual-diagrams/assets/erd/core-objects.md

@@ -0,0 +1,131 @@
+# ERD Template: Core Salesforce Objects (Architect.salesforce.com Style)
+
+## Default Style
+
+All ERDs now use the **official architect.salesforce.com aesthetic** by default:
+- Dark border + light translucent fill boxes
+- Header banner with Salesforce logo
+- LEGEND bar with ENTITIES and RELATIONSHIPS
+- Labeled relationship lines
+- Footer with copyright
+
+See `references/architect-aesthetic-guide.md` for full specification.
+
+---
+
+## Prompt Template (Architect.salesforce.com Style)
+
+```
+Create a Salesforce Core CRM ERD in the EXACT architect.salesforce.com style:
+
+PAGE TITLE (very top, large bold text):
+'Core CRM Overview Data Model'
+
+HEADER SECTION (below title):
+- Left: Salesforce cloud logo + 'SALESFORCE PLATFORM Overview' in dark teal (#0B827C) banner box
+- Center: LEGEND with 'ENTITIES' section showing:
+  * Cloud Entity box (dark teal #0B827C border, light teal ~25% opacity fill)
+  * Related Entity box (dark teal border, lighter fill)
+  * External Entity box (black border, white fill)
+- Right: 'RELATIONSHIPS' section showing notation symbols for Parent/Child, Required, Optional, Many-to-Many
+
+BOX STYLING - CRITICAL:
+- DARK BORDER: Solid 2px border in dark teal (#0B827C)
+- LIGHT TRANSLUCENT FILL: Same teal hue at ~25% opacity
+- Rounded corners (8-12px radius)
+- Text in dark gray/black on the light fill
+
+ENTITY BOX FORMAT:
+┌─────────────────────────┐
+│ Logical Name            │  (Bold, larger)
+│ APIName                 │  (Smaller, italic, gray)
+│ • Field1                │  (Bullet points)
+│ • Field2                │
+└─────────────────────────┘
+
+OBJECTS TO INCLUDE (all with dark teal border + light teal fill):
+
+- Account (center position):
+  Account
+  Account
+  • Account Number
+  • Name
+  • Industry
+  • Type
+
+- Contact (linked to Account):
+  Contact
+  Contact
+  • Name
+  • Email
+  • Title
+  • Phone
+
+- Opportunity (linked to Account):
+  Opportunity
+  Opportunity
+  • Name
+  • Amount
+  • Close Date
+  • StageName
+
+- Case (linked to Account and Contact):
+  Case
+  Case
+  • CaseNumber
+  • Type
+  • Priority
+  • Status
+
+RELATIONSHIP LINES:
+- Thin black lines with text labels ON the lines
+- Contact → Account: "child of" (crow's foot on Contact side)
+- Opportunity → Account: "child of" (crow's foot on Opportunity side)
+- Case → Account: "related to" (crow's foot on Case side)
+- Case → Contact: "related to" (optional)
+- STRAIGHT LINES ONLY (horizontal and vertical, no diagonals)
+
+FOOTER:
+Left: '©2024 Salesforce - Subject to change without notice'
+Right: 'Last modified: [current date]'
+
+CRITICAL: Dark teal borders with LIGHT translucent teal fill - NOT solid filled boxes.
+```
+
+---
+
+## Usage
+
+```bash
+# Quick draft at 1K (iterate here)
+gemini --yolo "/generate '[paste prompt above]'"
+open ~/nanobanana-output/*.png  # Review and refine
+
+# Final at 4K (when satisfied)
+uv run scripts/generate_image.py \
+  -p "[your refined prompt]" \
+  -f "core-crm-erd.png" \
+  -r 4K
+open ~/nanobanana-output/*core-crm*.png
+```
+
+---
+
+## Cloud Color Reference
+
+| Cloud | Border Color | Fill (~25% opacity) |
+|-------|--------------|---------------------|
+| Sales Cloud | `#0B827C` (Teal) | Light Teal |
+| Service Cloud | `#9E2A7D` (Magenta) | Light Pink |
+| Platform | `#5A67D8` (Purple) | Light Purple |
+
+---
+
+## Resolution Guide
+
+| Phase | Resolution | Use Case |
+|-------|------------|----------|
+| Draft | 1K (CLI) | Quick iteration, prompt refinement |
+| Final | 4K (Python) | Documentation, presentations |
+
+**Tip**: Iterate at 1K until layout is correct, then generate 4K final.

package/skills/generating-visual-diagrams/assets/erd/custom-objects.md

@@ -0,0 +1,60 @@
+# ERD Template: Custom Objects
+
+## Prompt Template
+
+```
+Professional Salesforce ERD diagram showing custom objects:
+
+OBJECTS:
+[List custom objects with relationships]
+
+COLOR CODING:
+- Standard Objects: Blue (#bae6fd fill, #0369a1 border)
+- Custom Objects: Orange (#fed7aa fill, #c2410c border)
+- External Objects: Green (#a7f3d0 fill, #047857 border)
+
+RELATIONSHIPS:
+- Lookup (LK): Dashed arrow, optional parent
+- Master-Detail (MD): Solid thick arrow, cascade delete
+
+STYLING:
+- Clean white background
+- Pastel fill colors with dark borders
+- Relationship labels on arrows
+- Professional diagram layout
+- Include color legend
+
+FORMAT:
+- Auto-layout based on relationships
+- Primary objects centered
+- Child objects positioned below/right of parents
+```
+
+## Example
+
+```bash
+# Draft at 1K (iterate here)
+gemini --yolo "/generate 'Salesforce ERD for real estate app:
+- Property__c (orange, center): Main custom object
+- Listing__c (orange, right): Master-Detail to Property__c
+- Showing__c (orange, below): Lookup to both Property__c and Contact
+
+Orange boxes for custom objects, blue for standard (Contact).
+Include legend. Professional style.'"
+open ~/nanobanana-output/*.png  # Review and refine
+
+# Final at 4K (when satisfied)
+uv run scripts/generate_image.py \
+  -p "Salesforce ERD for real estate app..." \
+  -f "realestate-erd.png" \
+  -r 4K
+```
+
+## Resolution Guide
+
+| Phase | Resolution | Use Case |
+|-------|------------|----------|
+| Draft | 1K (CLI) | Quick iteration, prompt refinement |
+| Final | 4K (Python) | Documentation, presentations |
+
+**Tip**: Iterate at 1K until layout is correct, then generate 4K final.

package/skills/generating-visual-diagrams/assets/lwc/dashboard-card.md

@@ -0,0 +1,45 @@
+# LWC Template: Dashboard Card Mockup
+
+## Prompt Template
+
+```
+Salesforce Lightning dashboard card/tile mockup:
+
+CARD TYPE: [metric/chart/list/progress]
+
+METRIC CARD:
+- Large metric value
+- Label below
+- Trend indicator: up/down arrow with percentage
+- Sparkline mini chart (optional)
+- Icon in corner
+
+CHART CARD:
+- Chart type: [bar/line/pie/donut]
+- Legend position
+- Data labels on hover
+
+LIST CARD:
+- Title with "View All" link
+- 3-5 list items
+- Each item: icon, primary text, secondary text
+
+STYLING:
+- SLDS card component
+- White background with subtle shadow
+- Rounded corners
+- Header with title and action menu
+```
+
+## Example: Metric Card
+
+```bash
+gemini "/generate 'Salesforce dashboard metric card:
+- Large number: $1.2M
+- Label: Total Pipeline Value
+- Trend: +12% (green up arrow)
+- Icon: Opportunity icon (top-right)
+- Sparkline: Show 7-day trend mini chart
+
+Style: SLDS card, white background, subtle shadow'"
+```

package/skills/generating-visual-diagrams/assets/lwc/data-table.md

@@ -0,0 +1,57 @@
+# LWC Template: Data Table Mockup
+
+## Prompt Template
+
+```
+Salesforce Lightning Web Component data table mockup:
+
+COMPONENT: lightning-datatable style
+
+HEADER:
+- Component title: "[Title]"
+- Search box (right-aligned)
+- Action buttons: New, Refresh, Export
+
+COLUMNS:
+[List columns with types]
+
+SAMPLE DATA:
+- Show 5-7 sample rows with realistic data
+- Include row selection checkboxes
+- Show sorting arrows on sortable columns
+
+STYLING:
+- SLDS (Salesforce Lightning Design System)
+- Zebra striping on rows
+- Hover highlight
+- Blue header bar
+- White background
+
+ACTIONS:
+- Row-level action menu (three dots)
+- Bulk action buttons when rows selected
+
+FORMAT:
+- Desktop view (1200px width)
+- Full component with card wrapper
+- Include pagination footer
+```
+
+## Example
+
+```bash
+gemini "/generate 'Salesforce LWC data table mockup:
+Title: Recent Opportunities
+Columns:
+1. Opportunity Name (link)
+2. Account Name (text)
+3. Amount (currency, right-aligned)
+4. Stage (picklist badge)
+5. Close Date (date)
+6. Owner (user with avatar)
+
+Sample data: Show 5 realistic opportunities
+Include: Search, New button, row actions menu
+Style: SLDS, professional, clean
+Pagination: 1-5 of 127'"
+```

package/skills/generating-visual-diagrams/assets/lwc/record-form.md

@@ -0,0 +1,60 @@
+# LWC Template: Record Form Mockup
+
+## Prompt Template
+
+```
+Salesforce Lightning Web Component record form mockup:
+
+COMPONENT: lightning-record-form style
+
+HEADER:
+- Object icon and label
+- Edit/Save/Cancel buttons (right)
+- Record name as title
+
+LAYOUT:
+- Two-column layout for desktop
+- Responsive single column for mobile
+
+SECTIONS:
+[Define sections with fields]
+
+FIELD TYPES:
+- Text inputs with labels above
+- Picklists as dropdown
+- Lookups with search icon
+- Date pickers with calendar
+- Currency with formatting
+- Checkboxes for boolean
+
+STYLING:
+- SLDS record page styling
+- Compact spacing
+- Blue section headers
+- Required field indicators (*)
+- Help text icons where applicable
+```
+
+## Example
+
+```bash
+gemini "/generate 'Salesforce LWC record form mockup:
+Object: Opportunity
+Mode: Edit
+
+Sections:
+1. Opportunity Information:
+   - Opportunity Name* (text)
+   - Account Name* (lookup with search)
+   - Type (picklist)
+   - Lead Source (picklist)
+
+2. Amount & Dates:
+   - Amount (currency)
+   - Close Date* (date picker)
+   - Stage* (picklist)
+   - Probability (percentage)
+
+Footer: Save and Cancel buttons
+Style: SLDS, professional, desktop view'"
+```

package/skills/generating-visual-diagrams/assets/review/apex-review.md

@@ -0,0 +1,57 @@
+# Apex Code Review Template
+
+## Gemini Review Prompt
+
+```
+Review this Apex code for best practices and issues:
+
+CODE:
+[paste code here]
+
+REVIEW CATEGORIES:
+
+1. BULKIFICATION
+   - SOQL queries in loops
+   - DML operations in loops
+   - Governor limit risks
+   - Collection usage
+
+2. SECURITY
+   - CRUD permissions check
+   - FLS enforcement
+   - Sharing model compliance
+   - Injection vulnerabilities
+
+3. BEST PRACTICES
+   - Trigger handler pattern
+   - One trigger per object
+   - Separation of concerns
+   - Proper exception handling
+
+4. PERFORMANCE
+   - Selective SOQL queries
+   - Index usage
+   - Unnecessary computation
+
+5. MAINTAINABILITY
+   - Code comments
+   - Method length
+   - Test coverage considerations
+
+OUTPUT FORMAT:
+JSON with summary, issues array, bestPractices array, and score
+```
+
+## Usage
+
+```bash
+gemini "Review this Apex trigger for issues: [paste code]" -o json
+```
+
+## Severity Guidelines
+
+| Severity | Criteria |
+|----------|----------|
+| High | Security, governor limits, data integrity |
+| Medium | Performance, best practices |
+| Low | Style, minor improvements |

package/skills/generating-visual-diagrams/assets/review/lwc-review.md

@@ -0,0 +1,48 @@
+# LWC Code Review Template
+
+## Gemini Review Prompt
+
+```
+Review this Lightning Web Component for best practices:
+
+JAVASCRIPT:
+[paste JS code]
+
+HTML TEMPLATE:
+[paste HTML code]
+
+REVIEW CATEGORIES:
+
+1. ACCESSIBILITY (A11Y)
+   - ARIA labels and roles
+   - Keyboard navigation
+   - Screen reader compatibility
+
+2. PERFORMANCE
+   - Wire service usage
+   - Rendering optimization
+   - Event handling
+
+3. SECURITY
+   - Locker Service compliance
+   - XSS prevention
+
+4. BEST PRACTICES
+   - Component lifecycle
+   - Error handling
+   - Data binding
+
+5. SALESFORCE PATTERNS
+   - Lightning Data Service
+   - Navigation service
+   - Toast notifications
+
+OUTPUT FORMAT:
+JSON with summary, issues array, accessibility score, and overall score
+```
+
+## Usage
+
+```bash
+gemini "Review this LWC component: [paste code]" -o json
+```