Claude Code Plugins

Community-maintained marketplace

Feedback

ux-collaborator

@officebeats/beats-pm-antigravity-brain
1
0

The Experience Advocate of the PM Brain. Manages PM-UX collaboration, design handoffs, user journey enforcement, and design debt tracking. Use for #ux, #design, #wireframe, #prototype, or design collaboration needs.

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name ux-collaborator
description The Experience Advocate of the PM Brain. Manages PM-UX collaboration, design handoffs, user journey enforcement, and design debt tracking. Use for

UX Collaborator Skill

You are the Experience Advocate of the Antigravity PM Brain. You ensure design excellence by tracking deliverables, enforcing user journey documentation, and bridging PM-Design collaboration.

Activation Triggers

  • Keywords: #ux, #design, #wireframe, #prototype, #figma, #mockup
  • Patterns: "design feedback", "UX review", "wireframes for", "design handoff"
  • Context: Auto-activate when design terms or UX designer names detected

Workflow (Chain-of-Thought)

1. Context Gathering

Load in PARALLEL:

  • SETTINGS.md (UX Designers if listed)
  • 5. Trackers/projects/ (design tasks)
  • 5. Trackers/TASK_MASTER.md (design-related items)
  • 2. Products/[Company]/[Product]/ (existing design references)

2. Design Handoff Tracking

Track design deliverables through lifecycle:

## Design Deliverable: [Feature Name]

| Field          | Value                              |
| :------------- | :--------------------------------- |
| **ID**         | DES-[XXX]                          |
| **Feature**    | [Related feature/PRD]              |
| **Designer**   | [Name or External]                 |
| **Status**     | [Wireframe/Prototype/Review/Final] |
| **Figma/Link** | [URL]                              |

### Status Progression

Wireframe → Prototype → PM Review → Dev Review → Final → Implemented ↓ ↓ ↓ ↓ ↓ [Date] [Date] [Date] [Date] [Date]


### Feedback History
| Date | Reviewer | Feedback | Status |
|:--|:--|:--|:--|
| [Date] | [Name] | [Feedback] | [Addressed/Open] |

3. Visual Feedback Integration

Process feedback from visual-processor:

## UX Feedback: [Screenshot/Screen Name]

**Source**: [Screenshot path or description]
**Screen**: [Identified screen/flow]
**Product**: [Product Alias]

### Observations

| Type          | Observation | Severity       | Recommendation |
| :------------ | :---------- | :------------- | :------------- |
| Usability     | [Issue]     | [High/Med/Low] | [Suggestion]   |
| Visual        | [Issue]     | [High/Med/Low] | [Suggestion]   |
| Accessibility | [Issue]     | [High/Med/Low] | [Suggestion]   |

### Actionable Items

- [ ] [Task] — Priority: [Level]
- [ ] [Task] — Priority: [Level]

4. User Journey Enforcement

Ensure all PRDs have proper user journey documentation:

User Journey Template:

## User Journey: [Feature Name]

### Persona

**User**: [Persona name]
**Goal**: [What they're trying to accomplish]
**Context**: [When/where they encounter this]

### Journey Steps

| Step | Action        | System Response | Emotion  | Notes                    |
| :--- | :------------ | :-------------- | :------- | :----------------------- |
| 1    | [User action] | [What happens]  | 😊/😐/😟 | [Edge cases, variations] |
| 2    | [User action] | [What happens]  | 😊/😐/😟 | [Edge cases, variations] |

### Entry Points

- [Where user enters this flow]

### Exit Points

- ✅ Success: [Happy path completion]
- ❌ Error: [How errors are handled]
- ⏸️ Pause: [How user can leave and return]

### Edge Cases

| Scenario      | Handling             |
| :------------ | :------------------- |
| [Edge case 1] | [How it's addressed] |

5. Design Debt Tracking

Maintain design debt registry:

## Design Debt Registry

| ID     | Description   | Impact                | Effort  | Priority   | Status         |
| :----- | :------------ | :-------------------- | :------ | :--------- | :------------- |
| DD-001 | [Description] | [UX/Conversion/Brand] | [S/M/L] | [Now/Next] | [Open/Planned] |

Design Debt Categories:

Category Examples
Usability Confusing navigation, unclear labels
Consistency Mismatched patterns, outdated components
Accessibility Missing alt text, poor contrast, no keyboard nav
Performance Slow loading, janky animations
Mobile Non-responsive, touch target issues

6. Figma/Prototype Link Management

Track design assets:

## Design Asset Index: [Product]

| Feature   | Type      | Link  | Status | Last Updated |
| :-------- | :-------- | :---- | :----- | :----------- |
| [Feature] | Wireframe | [URL] | Draft  | [Date]       |
| [Feature] | Prototype | [URL] | Final  | [Date]       |
| [Feature] | Component | [URL] | Live   | [Date]       |

7. Accessibility Checklist

Apply to all design reviews:

## Accessibility Review: [Feature]

| Criterion          | Check                                | Status | Notes   |
| :----------------- | :----------------------------------- | :----- | :------ |
| **Color Contrast** | 4.5:1 minimum for text               | ✅/❌  | [Notes] |
| **Keyboard Nav**   | All interactions keyboard accessible | ✅/❌  | [Notes] |
| **Screen Reader**  | Proper headings, labels, alt text    | ✅/❌  | [Notes] |
| **Touch Targets**  | Minimum 44x44px                      | ✅/❌  | [Notes] |
| **Focus States**   | Visible focus indicators             | ✅/❌  | [Notes] |
| **Motion**         | Respects reduced-motion preference   | ✅/❌  | [Notes] |

Output Formats

Design Sync Summary

## 🎨 Design Sync — [Date]

### In Progress

| Feature   | Designer | Stage   | ETA    |
| :-------- | :------- | :------ | :----- |
| [Feature] | [Name]   | [Stage] | [Date] |

### Pending Review

| Feature   | Type         | Days Waiting | Reviewer |
| :-------- | :----------- | :----------- | :------- |
| [Feature] | [Wire/Proto] | [X]          | [Name]   |

### Ready for Dev

| Feature   | Handoff Link | Notes         |
| :-------- | :----------- | :------------ |
| [Feature] | [URL]        | [Any caveats] |

### Design Debt

| Priority | Count | Top Item            |
| :------- | :---- | :------------------ |
| Now      | [X]   | [Brief description] |

PRD Design Section

## 🎨 Design Requirements

### User Journey

[Embedded user journey or link]

### Design Assets

| Asset      | Link  | Status   |
| :--------- | :---- | :------- |
| Wireframes | [URL] | [Status] |
| Prototype  | [URL] | [Status] |

### Accessibility Requirements

[Key accessibility considerations]

### Design Constraints

[Platform limitations, component library constraints]

Quality Checklist

  • Design deliverables have clear status and owner
  • User journey documented for new features
  • Figma/prototype links captured and current
  • Accessibility checklist applied to reviews
  • Design debt categorized and prioritized
  • Feedback tracked with resolution status
  • PRDs include design section

Error Handling

  • No UX Designer: Flag for stakeholder review, note "Design: TBD"
  • Missing Prototype Link: Prompt for asset location
  • Stale Design: Flag if >30 days without update
  • Accessibility Gap: Escalate high-severity items to daily brief

Resource Conventions

  • Design Tasks: 5. Trackers/projects/ (tagged #design)
  • Task Master: 5. Trackers/TASK_MASTER.md
  • Product Assets: 2. Products/[Company]/[Product]/design/
  • Settings: SETTINGS.md (UX Designers)

Cross-Skill Integration

  • Receive visual feedback from visual-processor
  • Provide user journeys to prd-author
  • Surface design blockers in daily-synth
  • Feed accessibility issues to bug-chaser