Skip to content

Instantly share code, notes, and snippets.

@jglovier
Created August 27, 2021 04:43
Show Gist options
  • Save jglovier/171747eefd4fe60a0f189ad33578d941 to your computer and use it in GitHub Desktop.
Save jglovier/171747eefd4fe60a0f189ad33578d941 to your computer and use it in GitHub Desktop.

[PROJECT NAME] product design brief

Status: ๐Ÿ“„ In Project Definition [be sure to keep this updated throughout the project]

Product Design Lead: ... (document author)
Product Manager: ...
Engineering Manager: ...
Eng Team: ...

Purpose of this doc: To define the scope, goals, details and other relevant information about this project. This document serves as the aggregate reference point for the project.

See also: [include other relevant docs here]


๐Ÿ‘€ Project summary

Write out background context about the project here, including what we are doing, why we are doing it, and any other relevant details...

๐Ÿ“ฃ Feature narrative

[...write out the story of this feature as it would be told to someone in conversation, or at the beginning of a demo video for the feature...]

๐Ÿฅ… Goals

Product: what is the primary goal of this project from a product perspective? Articulate here...

Business: what is the primary goal of this project from a business perspective (if distinguishable from product perspective; may be more focused on business strategy than product experience)? Articulate here...

Design: what is the primary goal of this project from a design perspective? Articulate here...

Engineering: what is the primary goal of this project from a product perspective? Articulate here...

๐Ÿ‘ค User stories (JTBD)

Category 1 (use categories to group JTBD when applicable)

  • As a [user role or other situation] I want to [articulate what the user wants to be able to do]
  • ...

โœ… Project components

The project will include:

  1. describe the key components of the feature/project from an experience/product perspective
  2. ...

๐Ÿˆ What we are not doing (punting for now)

To be clear, here is what we are not addressing in this project:

  • include things intentionally we are deciding not to solve for right now...

โณ Constraints

Basic constraints we need to work within:

  • this work needs to be GA shipped by...
  • we will be using...

๐Ÿ“ Measuring success

Some measures of success that we can look for:

  • Increase in monthly active users...
  • etc...

๐Ÿ—“ Sequencing & timeline

  1. Sketching and wireframing for ...
  2. High fidelity design explorations for ...
  3. etc...

๐Ÿค” Questions to discuss / Decisions to make

For the team: feel free to add questions for discussion and clarification here:

  • identify any key questions to discuss with product, engineering, or other stakeholders here...
  • ...

โœ๏ธ Wireframes for IA decisions

To help keep our process efficient, we can solve for some major decisions at the beginning at a low fidelity stage of the design process that focuses less on the entire UI details and more on just the specific parts in question (usually overall layout, placement of components, etc โ€“ things that can be rendered quickly as sketches or with other wireframing tools).

๐Ÿ’ฌ Item for discussion and decision...

Brief description of the item and what is to be decided (usually a choice about the overall layout, etc), including rationale for different options and images below. Be sure to record discussion notes from each decision stakeholder (typically best done in a triad sync meeting via discussion, and then key points captured here for later reference).

insert image for discussion here

[Example] Option 1: add a new section to the core workflow

Pros Cons
some upside here... some downside here...
some other upside here... some other downside here...

Decision Record:

  • team member - notes from decision...

๐Ÿ’ฌ Discussion notes

๐Ÿ‘‚ Sync with ... on ...

Space here for notes from other key discussion (if applicable)


๐Ÿ–Œ Hi-fi Design Comps

(Figma file here)

Design exploration TODOS:

  • add design tasks here for reference if useful (be sure to include on your teamโ€™s project board also!)
  • ...

๐Ÿšง Project progress

  • checklist of steps goes here to track progress and outstanding stages/tasks at a high level (or whatever level is useful for you in this doc)
    • ...
    • ...
  • Design exploration
    • initial research
    • sketching / wireframes / paperframes
    • hifi design explorations
  • Design delivery (READY FOR DEV)
    • ...list and link specific comp groups ready for dev here
  • Engineering handoff
    • review designs with team
    • work with team on implementation details
  • Q&A testing
    • session 1
    • ...
  • Docs
    • sync with docs to discuss docs plan
    • ...
  • Support
    • sync with Support to let them know about the feature and discuss any potential common issues that users may face
  • Marketing
    • write feature narrative as a framing reference for marketing
    • sync with marketing to discuss supporting release
  • Ship date
    • update Changelog
    • tweet it
  • Retrospective
    • ...(notes)
  • Future planning
    • Identify most obvious post-ship iterations, open issues/board tickets
    • Identify blockers, challenges, outstanding questions/decisions before future work will commence
    • Identify where in the Roadmap future work belongs
  • Sharpening the saw
    • Figma file cleanup
      • finish converting design elements to components & variants and update mocks accordingly
    • Migrate new components and variants to design system
    • ...

๐Ÿ‘ฃ Future work...

...after the initial design work has been completed, there may be several ideas that came up that are not included in initial scope. This space can be used to document those ideas to revisit later (itโ€™s often helpful to write them down in as much detail as possible while they are still top of mind) and any other relevant project sequencing notes.

โญ Post-ship follow-up items

  • ...
  • ...

๐Ÿ”ฎ Further down the road

  • ...
  • ...
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment