{
  "markdown": "# UX Superpowers 🔬\n\n**User-centered design methodology for coding agents.**\n\nGround every line of code in real user needs — not assumptions.\n\n## What Is This?\n\nUX Superpowers is a Claude Code plugin that adds a **UX discovery phase** to your development workflow. Before you brainstorm solutions, before you write code, this plugin ensures you understand:\n\n- **Who** you're building for (Personas)\n- **What** they're trying to accomplish (Jobs to Be Done)\n- **How** they experience the problem today (User Journey Maps)\n- **How** you'll know if you succeeded (Telemetry & Metrics)\n\nIt accepts real user data (interviews, feedback, analytics) or guides you through discovery from scratch.\n\n## How It Works With Superpowers\n\nUX Superpowers is designed to **complement** [Superpowers](https://github.com/obra/superpowers), not replace it.\n\n```\n┌─────────────────────────┐     ┌──────────────────────────┐\n│   UX SUPERPOWERS        │     │   SUPERPOWERS            │\n│                         │     │                          │\n│  Problem Definition     │     │  Technical Brainstorming │\n│  Personas               │────▶│  Implementation Planning │\n│  Jobs to Be Done        │     │  TDD & Code Review       │\n│  User Journeys          │     │  Subagent Development    │\n│  Telemetry Planning     │     │                          │\n│                         │     │                          │\n│  \"WHAT and WHY\"         │     │  \"HOW\"                   │\n└─────────────────────────┘     └──────────────────────────┘\n```\n\n**UX Superpowers** owns the \"what\" and \"why.\" **Superpowers** owns the \"how.\"\n\nYou can use UX Superpowers standalone or alongside Superpowers. When both are installed, UX discovery runs first, then hands off to Superpowers' brainstorming skill with full context.\n\n## Installation\n\n### From Claude Code Marketplace\n\n```bash\n/plugin marketplace add adnanmir123/ux-superpowers\n/plugin install ux-superpowers@ux-superpowers\n```\n\n### Local Development\n\n```bash\ngit clone https://github.com/adnanmir123/ux-superpowers.git\nclaude --plugin-dir ./ux-superpowers\n```\n\n## Skills\n\n| Skill | Trigger | What It Does |\n|-------|---------|-------------|\n| `ux-discover` | \"Let's build X\", \"I want to create Y\" | Orchestrates the full discovery flow |\n| `persona-builder` | \"Who are the users?\", \"Build personas\" | Creates evidence-based user personas |\n| `jobs-to-be-done` | \"What are users trying to do?\" | Maps functional, emotional, social jobs |\n| `user-journey` | \"Map the user experience\" | Current-state and desired-state journey maps |\n| `telemetry-designer` | \"How do we measure success?\" | Defines metrics, events, and feedback loops |\n| `research-intake` | User provides raw data (interviews, feedback, etc.) | Synthesizes raw research into structured insights |\n| `insight-synthesizer` | After all discovery phases complete | Produces the final UX Discovery Document |\n| `ux-validate` | During code review, before shipping | Checks implementation against discovery artifacts |\n\n## Quick Start\n\nJust start building something. UX Superpowers will nudge you to run discovery first:\n\n```\nYou: \"I want to build a CLI tool for managing database migrations\"\n\nClaude: \"Before we design the solution, let's understand the problem and users.\n         Do you have any existing user research or feedback I should review first?\"\n```\n\nOr invoke directly:\n\n```\n/ux-superpowers:ux-discover\n```\n\n## Output\n\nUX Superpowers produces a **UX Discovery Document** saved to `docs/ux-discovery/` containing:\n\n1. Problem Brief\n2. Personas (1-3, prioritized)\n3. Jobs to Be Done (with opportunity scores)\n4. User Journey Maps (current + desired state)\n5. Success Metrics & Telemetry Plan\n6. Design Principles\n7. Assumptions & Risks\n8. Constraints & Boundaries\n\nThis document becomes the **requirements anchor** for all subsequent development.\n\n## Works for ALL Software\n\nNot just web apps. UX Superpowers adapts to:\n\n- Web & Mobile Apps\n- CLI Tools & DevTools\n- APIs & SDKs\n- Infrastructure & Platform\n- Internal Tools\n- Data Pipelines\n- Games\n- Hardware Interfaces\n\n## Philosophy\n\n1. **One question at a time** — don't overwhelm the developer\n2. **Evidence over opinion** — every decision traces to user data or labeled assumptions\n3. **YAGNI applies to research** — get enough signal, then build\n4. **Respect expertise** — if you know your users, skip ahead\n5. **Progressive disclosure** — nudge, don't gate\n\n## Contributing\n\nWe welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\nSkills live in `skills/`. Each skill is a directory with a `SKILL.md` file.\n\n## License\n\nMIT — see [LICENSE](LICENSE)\n\n## Affiliation\n\nUX Superpowers is an independent community project inspired by and designed to complement [Superpowers](https://github.com/obra/superpowers) by Jesse Vincent. It is **not affiliated with, endorsed by, or maintained by** the Superpowers project or its authors. The name reflects the complementary positioning in the workflow (UX discovery → technical brainstorming), not a shared origin.\n",
  "bytes": 5019,
  "sha": "3c3f02a61e940dd85cc5afebba059ec882c2db9c5a086d66c4d2605bc0a2e1e1",
  "repo_slug": "adnanmir123/ux-superpowers",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_adnanmir123_ux_superpowers_ux_superpower_02a359b6/readme"
}