Overview

ProductHarness at a Glance

What it is, what it delivers, and what your organization needs to make it work — in a single read.

A Framework for Product Teams Working Alongside AI

ProductHarness lets product teams build and validate working software before engineering commits a single hour to it. PMs generate functional prototypes in the same session they're thinking through the problem, put them in front of stakeholders, and derive requirements from what actually worked — instead of specifying upfront and hoping. Decisions that used to happen after engineering built the wrong thing happen before engineering starts.

The mechanism is context. ProductHarness is a structured repository — generated inside your own source control — that encodes the org's standards: component conventions, API patterns, authentication approach, node definitions, and work product templates. When an AI coding agent generates anything — a prototype, a requirements draft, a test case — it reads those documents first. Every output follows the org's actual conventions by default, not generic AI defaults. That is what makes the prototypes production-aligned rather than throwaway.

The result is a product organization that works in one place, from one source of truth, with a single context the entire team shares. Requirements written in the repo flow downstream automatically. Prototypes are production-aligned by construction. Downstream systems — backlog, test management, wiki — receive from the repo; they don't author to it.

The developer environment is where AI coding agents live. Product work that lives there too — requirements, prototypes, decisions, standards — is always in context. The agent can act on any of it, at any time, without being handed a copy.

Four Outcomes

01
Working prototypes before engineering starts

PMs can generate functional implementations — not mockups, not wireframes — in the same session they're thinking through the product problem. Those prototypes follow the org's actual conventions because the steering documents are in context. Stakeholders react to working behavior, not to descriptions of it. Decisions that used to happen after engineering built the wrong thing happen before engineering starts.

02
Requirements derived from validated work

When requirements emerge from an iterative build-and-validate loop rather than pre-engineering speculation, they describe what was built and tested — not what was hoped would work. Edge cases appear when something is built and the edge is encountered. Acceptance criteria written after stakeholder validation are more accurate than criteria written before the first prototype exists. Test cases generated from those criteria are executable from day one.

03
Automatic downstream distribution

Requirements are authored once in the repo. The agent publishes them to the backlog as stories, creates test cases linked to acceptance criteria, and updates the wiki — without the PM opening any of those systems. The Translation Tax — converting intent into the right format for each downstream system — is eliminated. Distribution is the final step in the workflow, not the primary one.

04
Better build decisions, not just faster ones

Speed matters less than making the right call before committing engineering capacity. The framework structures discovery and validation as first-class activities — hypothesis records, experiment records, decision logs — so the team arrives at build with evidence, not intuition. Instrumentation and validation approach are declared at spec time. The decision to build is grounded in what customers actually need, not in what seemed right in a requirements session.

What Your Organization Needs to Bring

ProductHarness is not a tool that installs itself. It requires organizational conditions that make it work — and being honest about those conditions is part of what makes the framework credible. Here is what needs to be in place.

01
AI coding agents already in use or being adopted

ProductHarness is built for organizations where engineers are already working alongside AI coding agents, or where that adoption is underway. Any agent that reads a local repository works — the framework is tool-agnostic. If agents are not yet part of engineering's workflow, the prototyping and distribution capabilities won't have a foundation to build on.

02
A Git repository and basic developer tooling

The harness lives in a Git repository. PMs need to be able to open that repository in an IDE or CLI tool with an AI coding agent attached. They do not need to know how to code — but they need to be willing to work in that environment. For Tier 2 and above, Node.js is required for Storybook and Playwright. For Tier 1, only Git and an AI coding agent are required.

03
A technical sponsor to configure the steering documents

The steering documents — the files that encode the org's API patterns, authentication approach, component conventions, and CI/CD requirements — need to be filled in with the org's actual decisions. This requires someone with engineering context: typically a Director of Engineering, a senior engineer, or a tech lead. The training engagement walks this person through what each document needs and why. A harness with blank steering documents is not a harness.

04
Agreement that the repo is the source of truth

The workflow only holds if requirements authored in the repo are the originals — not copies of what was typed into a backlog ticket. This requires an organizational agreement, backed by the PM's Director, that the backlog is a tracking mirror, not the place where requirements are authored. Teams where the backlog is culturally the source of truth will resist this, and the workflow will degrade to a documentation exercise rather than a capability shift.

05
Executive or Director sponsorship

PMs changing how they work requires permission from someone with authority over how the team works. Without a Director or executive sponsor who has explicitly aligned on the shift, PMs will revert to familiar patterns under pressure. The training engagement includes a Director-level session specifically for this reason — to align on what changes, what stays the same, and what the sponsor needs to watch for.

The training engagement covers installation, steering document configuration, and running each role through their workflow — leaving the team with a configured harness and this site as the reference they'll return to.

Three Tiers of Adoption

ProductHarness is designed as an additive system — each tier builds on the last, and the right tier depends on organizational readiness, not aspiration.

Tier 1 — Base

Requirements and distribution

The repo as source of truth. Requirements in markdown, distributed to the backlog and test management automatically. Prototyping with production-aligned context. Works with any Git repo and any AI coding agent.

Requires: Git, AI coding agent, configured steering documents.

Tier 2 — Production Alignment

Closes the Demo Gap

The harness is anchored to the production codebase. Prototypes mirror the real component structure. Design-to-engineering handoff produces artifacts engineering can extend, not rebuild.

Requires: Tier 1 plus access to the production repository for context population.

Tier 3 — Production Ready

Validated artifacts sync to production

Storybook-validated, QA-approved components sync directly to the production repo. The PM's workflow produces artifacts that land in production. Requires engineering buy-in on agentic workflow patterns.

Requires: Tier 2 plus engineering culture readiness for PM-adjacent production contributions.

The training engagement includes a tier selection step. Most organizations start at Tier 1 and move up as the team develops confidence in the workflow. The Adoption Path →

Setup — zero to a running harness in one session → Training engagements → The conceptual framework → Role-level workflow guides → CPO & VP brief → Director brief →