mohitagw15856
036511ab3e
Broadens both reach (more tools) and content types (an MCP server), continuing the multi-platform story. Windsurf + Aider: - build-exports.mjs gains two platforms: exports/windsurf/*.md (workspace rules, trigger: model_decision) and exports/aider/*.md (conventions for `aider --read`). Now 5 platforms (ChatGPT, Gemini, Cursor, Windsurf, Aider). - install.sh + bin/cli.mjs install both (windsurf -> .windsurf/rules, aider -> .aider/skills with a --read hint); generated README index is excluded from copies. - One-line windsurf-install.sh / aider-install.sh wrappers for parity. MCP server (new content type): - mcp/server.mjs — zero-dependency stdio MCP server exposing list_skills, search_skills, get_skill. Published as a second bin (pm-claude-skills-mcp). Logs to stderr; reads bundled skills/ at startup. mcp/README.md documents client config. Also: README hero "See it in action" demo placement (ready to swap in a GIF; recording guide in web/docs-assets/README.md), Works-With table + exports + install docs updated, CHANGELOG Unreleased. package.json files/bin updated. Claude-Session: https://claude.ai/code/session_016JWn5jRD5tcEFKrubjQ6Px Co-authored-by: Claude <noreply@anthropic.com>
72 lines
2.6 KiB
Markdown
72 lines
2.6 KiB
Markdown
# Figma Design Brief Skill
|
|
|
|
Converts a product requirement or feature request into a structured design brief — everything a designer needs to open Figma and start building confidently.
|
|
|
|
## Required Inputs
|
|
|
|
- **Feature or requirement** (paste PRD snippet, ticket, or describe the feature)
|
|
- **User goal** (what is the user trying to accomplish?)
|
|
- **Platform** (iOS / Android / Web / Responsive / All)
|
|
- **Existing components available** (optional)
|
|
- **Timeline** (when does design need to be ready?)
|
|
|
|
## Output Structure
|
|
|
|
### 1. Brief Header
|
|
Feature, PM, Designer, Platform, Design due, Dev handoff dates.
|
|
|
|
### 2. What We Are Designing and Why
|
|
- **The goal:** [One sentence — user problem being solved]
|
|
- **Context:** [2-3 sentences. Why now? What triggers this?]
|
|
- **Success looks like:** [Specific observable outcome]
|
|
|
|
### 3. User Flows to Design
|
|
|
|
**Flow N: [Flow name]**
|
|
- Entry point: [Where user starts]
|
|
- Steps: [Numbered key steps]
|
|
- Exit point: [Where flow ends]
|
|
- Edge cases: [empty state, error state, loading state]
|
|
|
|
### 4. Screens Required
|
|
|
|
| Screen | New / Update | Notes |
|
|
|---|---|---|
|
|
| [Screen] | New | [Key requirement] |
|
|
|
|
### 5. Components Needed
|
|
|
|
| Component | In library? | Action |
|
|
|---|---|---|
|
|
| [Component] | Yes/No/Needs variant | Use/Create/Extend |
|
|
|
|
### 6. Constraints and Requirements
|
|
- Must haves: [Non-negotiable constraints]
|
|
- Must avoid: [Design patterns to not use]
|
|
- Accessibility: [WCAG level, touch target sizes]
|
|
|
|
### 7. Open Questions
|
|
- [ ] [Question — with owner]
|
|
|
|
## Quality Checks
|
|
- [ ] Goal is outcome-focused (not "design the feature")
|
|
- [ ] All flows include edge cases
|
|
- [ ] Components table identifies create vs reuse
|
|
- [ ] Constraints include accessibility requirements
|
|
- [ ] Open questions have owners
|
|
|
|
## Anti-Patterns
|
|
|
|
- [ ] Do not write a design brief that describes the solution — the brief must describe the problem and constraints, not the design answer
|
|
- [ ] Do not skip the success criteria — designers need to know what "done" looks like before starting
|
|
- [ ] Do not omit existing components to reuse — briefs that ignore the design system lead to inconsistent implementations
|
|
- [ ] Do not leave open questions unresolved — escalate them before design work starts, not during it
|
|
- [ ] Do not confuse requirements with design instructions — the brief defines what, not how
|
|
|
|
## Example Trigger Phrases
|
|
- "Write a design brief for [feature]"
|
|
- "Turn this PRD into a Figma design brief"
|
|
- "Brief the designer on what to build for [requirement]"
|
|
- "Create a design spec for [feature] for Figma"
|
|
- "What does the designer need to know to design [feature]?"
|