Full Reference: Features to Outcomes

May 18, 2026 - 5 min read

Reference companion to Lesson 3.2 · Quality-check your brief: features to outcomes - the two fully worked feature-vs-outcome pairs, the priced-out comparison, the complete AI-reviewer test protocol, and the optional stack-ranking step. Read the micro-lesson first for the three-part rewrite and the pass/fail rubric; return here when a Section 3 line still reads feature-shaped and you want a worked pair.

Two briefs, two shapes each #

Same job, two ways to write it. Read each pair out loud. Notice how much the engineer or the agent has to invent under the feature shape, and how little they have to invent under the outcome shape.

Feature-shaped brief on the left leading to a sketched BI suite bristling with modules; outcome-shaped brief on the right leading to a single ‘Copy top 5 metrics’ button with a five-row data table

Pair 1 - The CSV button #

Feature shape: “Build a CSV export button on the dashboard.”

Outcome shape: “When I prepare the weekly investor report, I want to grab the top 5 metrics in 30 seconds, so I can paste them into the deck before the 4pm call.”

What the engineer builds from the feature shape: a reporting module with three dashboards, scheduled email exports, role-based access on who can export, a date-range picker, custom column selectors, and an audit log of every download. Six weeks of work. You used the CSV button once a week for the investor email and ignored the other eight features.

What the engineer builds from the outcome shape: one button at the bottom of the existing dashboard that says “Copy top 5 metrics to clipboard,” hard-coded to MRR (monthly recurring revenue - what subscribers pay you each month), net new MRR, active accounts, trial-to-paid conversion, and runway. Ninety minutes of work in a Rails controller, one line per metric. The next investor email goes out before the deck even opens.

Pair 2 - The CRM module #

Feature shape: “Build a CRM module.” (A CRM - customer relationship management tool - is the contact list and deal tracker a sales team works out of.)

Outcome shape: “When a new customer signs up, the founder needs to see which 3 of our existing customers most resemble them, so we can pattern-match the onboarding playbook that worked for those three.”

What the engineer builds from the feature shape: companies, contacts, deals, pipelines, activities, tasks, notes, custom fields, email integration, calendar integration, and a Kanban board nobody opens. Three months. You used the contacts list and the notes field.

What the engineer builds from the outcome shape: a 30-line script that runs nightly, scores existing customers against the new signup on three attributes (industry, employee count, plan tier), and posts a Slack message every morning: “New customer Acme Co looks most like Beta Inc, Gamma Ltd, and Delta GmbH - here are their onboarding notes.” Two days. The script is throwaway. When Salesforce is finally worth the bill, you import the script’s three matches into the proper CRM record.

The same request, priced out #

	Feature brief	Outcome brief
What you write	“Build a CRM module”	“Match new signups to 3 similar customers”
What the team builds	Companies + contacts, deals + pipelines, email + calendar integration, custom fields + Kanban	A nightly scoring script + a Slack message each morning
What it costs	3 months. $40K.	2 days. $600.
What you actually use	Contacts + notes	The onboarding playbook, ready Monday

The lineage of the When / I want / So I can shape has a name in product-management literature - “Job Stories.” See Further reading below if you want to chase it.

Test your brief with an AI reviewer #

No peer available? Use Claude or ChatGPT as the peer. Paste your full Section 3 + Section 5 (no-go list), then paste this prompt:

Imagine you are a contractor reading this brief to build the product. Based ONLY on Section 3, name 5 things you would build that are NOT in Section 5's no-go list. Be specific - feature names, not categories.

If the AI names 2+ items outside your no-go list, the brief failed quality-check the same as a peer flagging them. Revise Section 3 and re-run. This is the same failure signal a peer would surface, with no calendar coordination needed.

No peer and no AI account? The manual pass works too: read each Section 3 line and ask, “is this a thing the user does, or a thing the software has?” A line that names software parts (a dashboard, user roles, a settings page) is feature-shaped - rewrite it in the When / I want / So I can shape until it names a moment and a result instead.

What AI cannot prove or substitute:

Whether your scope solves the validated problem (only the Module 4 build + real users can)
Whether a real contractor would interpret the brief the same way (AI is a proxy, not a substitute)

The real gate is a clean peer QA (human or AI) where the answer stays inside your scope AND no-go list.

Optional: stack-rank features with real users #

After you have rewritten Section 3 as outcome-shaped job stories, you still have a list. To know which outcome to build first, OpinionX (free tier available) uses forced-ranking pairwise voting - users pick A or B, rather than rating everything “very important.”

Paste your 5-7 outcome statements.
Send the link to your interviewees.
Read the ranked list, backed by pairwise win rates rather than averaged scores.

Do this before handing the brief to Lovable or a contractor. It prevents the “build everything because everything scored 8/10” trap.