A user need, pain, or desire driving behaviour.
A need is the stable underlying requirement a person carries into a situation, the thing that stays true whatever solutionSolutionDiscoveryA proposed approach to address an opportunityView reference → they end up using. A want names a particular solution a person has in mind; a need names the state they are trying to reach. The want changes with every new option on the market, while the need barely moves.
The need-versus-solution distinction has a long pedigree in marketing, but its sharpest modern statement comes from the jobsJobUserJob To Be Done: what the user is trying to accomplishView reference →-to-be-done tradition. Theodore Levitt's line, often repeated, captured it: people who buy a quarter-inch drill do not want a drill, they want a quarter-inch hole. Anthony Ulwick built a formal method on the same instinct, arguing in Defining Customer Needs that most teams confuse needs with solutions, specificationsSpecificationFoundationsA canonical open standard or specification that primitives and products conform toView reference →, or vague benefit statements, and that a need is properly framed as a measurable outcomeOutcomeStrategyA desired business or user outcomeView reference → the customer wants from getting a job done.
A recurring split in the literature is between articulated and latent needs. Articulated needs are the ones a person can state plainly, such as "I want longer battery life." Satisfying them tends to produce incremental improvement. Latent needs sit below conscious expression, and surfacing them is where larger product moves come from. One argument worth keeping is that latent needs are less mysterious than they sound: the usual block is shallow questioning, and repeated "why" follow-up draws them out.
The field's most common abuse is the Maslow pyramid. Abraham Maslow's 1943 paper A Theory of Human Motivation proposed a hierarchy, but he never drew a pyramid, and he never claimed one level must be fully met before the next begins. Bridgman, Cummings and Ballard traced the pyramid to a 1960 management graphic by the consultant Charles McDermid, not to Maslow at all. Teams that rank user needs into rigid tiers are quoting a diagram their source never endorsed.
A scheduling tool gets a steady stream of requests for a darker calendar theme. Read as a want, the answer is to ship dark mode. The team instead interviews fifteen of the askers and finds the pattern underneath: most of them are checking the calendar late at night from bed, on a phone, and the bright screen wakes a sleeping partner. The need is to glance at tomorrow without disturbing anyone in a dark room. Dark mode serves part of it, but so does a low-brightness lock-screen widget that never opens the full app, which tests better. Six months later a new request arrives for a different colour scheme. The need has not changed; only the proposed solution has. Holding the need stable lets the team evaluate the new ask in seconds.
job_surfaces_needJobsurfacesNeedcausal rather than collapsing the two.In the Unified Product Graph, a need lives in the Users and Needs region and acts as the durable target beneath shifting feature requestsFeature RequestCustomer FeedbackA user-submitted feature requestView reference →. A personaPersonaUserAn archetype representing a user segmentView reference → reaches it through PersonaexperiencesNeedsemantic, a job exposes it through persona_experiences_needJobsurfacesNeedcausal, and a chosen bet attaches through job_surfaces_needOpportunityaddressesNeedcross-domain. Qualitative evidenceEvidenceValidationData supporting or refuting a hypothesisView reference → anchors it: opportunity_addresses_needFeedback ThemevalidatesNeedcross-domain ties a recurring theme to the need so it rests on observed demand, not assertion. The forward link feedback_theme_validates_needNeedfulfilled byCapabilityhierarchy then connects the requirement to whatever the product builds to meet it, so a featureFeatureProduct SpecificationA product capability or featureView reference → can always be traced back to the human requirement it serves. A need with no fulfilling capabilityCapabilityStrategyAn ability that enables value deliveryView reference → is a visible gap; a capability serving no need is visible scope creep.need_fulfilled_by_capability
Worked example: Trellis
The need underneath Nora's jobJobUserJob To Be Done: what the user is trying to accomplishView reference → is governed autonomy: trust and control over what the agent builds and changes. She must see what a proposed change will do before it runs and undo it if it goes wrong. This need is distinct from the job itself and shapes every insightInsightUser ResearchA synthesised finding from researchView reference → and opportunityOpportunityDiscoveryA validated gap worth solvingView reference → Trellis has uncovered about where directors stop trusting AI tools.
Rarely Less than once a month
Mild inconvenience Notices but works around easily
Nice to have Would not notice if absent
KindA gap: a missing capability.
Type-specific fields on BaseNode
statementstringThe need expressed as a clear, user-facing statement
valenceenumWhat kind of experience: pain (friction), gap (unmet), constraint (limitation)
maturityenumHow mature is this need in our understanding
frequencyassessmentHow often the user encounters this need (1 = rarely, 5 = constantly)
severityassessmentHow painful or disruptive the need is when unaddressed (1 = minor, 5 = critical)
importanceassessmentHow important resolving this need is to the user (1 = low, 5 = critical)
motivationenumMotivation dimension. Inherited from parent job if not set.
idstringrequiredUnique identifier (UUID)
typeNodeTyperequiredDiscriminator for the entity type
titlestringrequiredDisplay name
descriptionstringOptional detailed description
statusstringLifecycle status
tagsstring[]Freeform tags for filtering
3 phases, initial: raw
22 edge types connected to this entity.
need_reframed_as_design_questionneed_fulfilled_by_capabilityopportunity_addresses_needfeedback_theme_validates_needjourney_step_reveals_needneed_occurs_in_journey_stepjourney_action_surfaces_needfunnel_step_reveals_needvalue_proposition_solves_needsupport_ticket_reveals_needchurn_reason_reveals_needinsight_validates_needobservation_reveals_needquote_evidences_needlearning_validates_needsolution_addresses_needcompetitor_addresses_needassumption_concerns_needfeature_addresses_needneed_measured_by_desired_outcome10 frameworks use this entity type.