Setting AI-SHIPR up for a VP and a team of PMs. Which worksheet each person fills, the order to install in, how product context flows back up, and what happens when a PM changes.
For where the files live - shared drive, SharePoint or Confluence - see Team Setup with Cloud.
If the people under you are engineering teams rather than PMs, or a designer or researcher needs your context, that shape installs differently - see When Your Reports Are Not PMs.
This is not a preference. It is how the machinery works.
Populate-Strategy converts a worksheet into that person's files. One of them is literally R-Relationships/Me/PM-Profile.md - "Me". It holds their biggest challenge, where their time actually goes, and the two things they optimise for. Every agent in the system reads it before responding.
If one person's answers are installed on five machines, all five instances believe they are that person. The agents then optimise for one person's challenge, one person's time split and one person's operating preference - for five different PMs working on four different products. The output is confident and wrong, which is the worst failure mode a shared system has.
| Layer | Who writes it | Who reads it |
|---|---|---|
| Org context vision, strategy, OKRs, bets, portfolio, constraints |
The VP, alone | Everyone, every session, automatically |
| Product context product strategy, personas, hypotheses, initiatives |
Each PM, for their own product | That PM. The VP reads across all of them |
The Setup Worksheet is one document with 8 parts. Both roles use the same file. They answer different parts - and answer the shared parts at different altitudes.
| Part | VP (team_mode: lead) | Each PM (team_mode: individual) |
|---|---|---|
| Setup Q1 - products | The whole portfolio | Whatever they own. Usually one |
| Setup Q2 - team | Team lead | Individual PM |
| 1 - Your Products | Every product, one paragraph each. Portfolio altitude | Their product only, in depth |
| 2 - Your Strategy | Org bets and OKRs. The 1–3 bets the company is making | Product bets, each laddering to one of the VP's |
| 3 - Your Constraints | Org constraints: headcount, budget, regulatory, platform reality | Constraints specific to their product and squad |
| 4 - Your Role | Their own role, challenge and time split, as the lead | Their own role, challenge and time split, as a PM |
| 5 - Your Stakeholders | Exec, commercial, customer-side, cross-product | Their tech lead, designer, and the stakeholders they personally align |
| 6 - Your Users | Skip. Personas belong to the PM who owns the product | Their personas, in depth. The highest-value part for a PM |
| 7 - Your Portfolio | Yes This becomes the org layer | Skip, unless they own two or more products themselves |
| 8 - Your Team | Yes Only the VP fills this | Skip |
A persona written by the person who does the customer calls is different from one written two levels up. If a PM fills nothing else properly, this part still has to be theirs.
"What is your biggest challenge right now" and "where do you want AI leverage" are the questions that tune the whole system to one person. Answered by someone else, they tune it to the wrong person.
The VP's worksheet produces two different things, and they go to two different places.
Their own instance - the same files any PM gets, scoped to their portfolio view, plus R-Relationships/Team/Roster.md from Part 8.
The org layer - the six files every PM's session reads before anything else.
| Org file | Comes from |
|---|---|
vp/shared/Vision.md | Part 1 + Part 2, at company altitude |
vp/shared/Strategy.md | Part 2 - how we win |
vp/shared/OKRs.md | Part 2 - metrics and targets |
vp/shared/Strategic-Bets.md | Part 2 - the 1–3 bets |
vp/shared/Portfolio-Roadmap.md | Part 7 |
vp/shared/Constraints.md | Part 3 |
shared/Vision.md, shared/Strategy.md, shared/OKRs.md and shared/Strategic-Bets.md on top of the Portfolio-Roadmap.md, Constraints.md and Stakeholders.md it already produces. No manual bridge step. shared/OKRs.md is the exception worth ten minutes of your attention: the worksheet collects metrics and bets, not formal OKRs, so that file comes out as a draft assembled from adjacent answers. Run the OKR-Partner skill on it before publishing, because it forces the bet linkage that makes the PMs' bets ladder up cleanly in the next phase. An invented org OKR is worse than a blank one, since the whole team plans against it.
The VP first, PMs second, reconcile upward third, then steady state. The third phase is the one teams skip, and it is the one that pays for the whole exercise.
60–90 minutes. Nobody else installs anything until this is done.
shared/OKRs.md with OKR-Partner, per section 1.03.[Missing - add manually] gets filled or explicitly deleted. A blank org file is better than a plausible invented one, because the invented one gets trusted.About 60 minutes each. Individually - different rooms or different slots.
bash setup.sh once.team_mode: individual in Settings.md.Structural-Integrity-Auditor on S-Strategy/ before doing any real work in the system.An org layer written alone in one sitting is a hypothesis about what the team is doing. The PM files are the evidence. This phase is where the hypothesis gets corrected, and it is not optional.
Prerequisite: each PM publishes their Vision, Strategic Bets and Personas up to the shared surface. The VP has no access to anyone's machine, so this is how the evidence reaches them. A copy-paste, once per reconciliation, not a continuous sync.
| What they find | What it means | What changes |
|---|---|---|
| A PM bet that ladders to no org bet | Either unfunded work, or a real bet missing from the org layer | Add the org bet, or stop the work. Both are decisions |
| The same constraint in two or more PM files | It is not a product constraint | Move it up to shared/Constraints.md |
| The same stakeholder in two or more PM files | Cross-product stakeholder | Move to shared/Stakeholders.md, one definition |
| Duplicate or conflicting personas | Two PMs describing one user two ways | One definition, in the shared templates |
| The same term defined differently by two PMs | The seam that costs you most | Into a shared glossary |
The VP changes org context and says so. Everyone re-reads or re-syncs. Once the rhythm holds, that refresh moves to session start automatically.
Re-run Phase 3 quarterly, or whenever the bets change.
The obvious way to organise a shared workspace is one page per PM with their products underneath. It is how a team thinks about itself, and it is wrong, because it assumes the person outlasts the product. In practice it is the other way round.
| Content | Lives as long as | Where it belongs |
|---|---|---|
| Vision, strategy, OKRs, bets, constraints | the company | The org layer, VP writes |
| Product strategy, personas, glossary, decision log | the product | Product workspaces, keyed by product |
| PM profile, PM voice, coaching log, 1:1 notes | the person | The PM's own machine, and the VP's private area |
Person-keyed pages give the middle row the wrong lifetime. When a PM leaves, years of product reasoning is sitting inside a page named after someone who no longer works there.
Reallocation breaks it before departure does. A PM owning two products is normal. The day one of them moves to a colleague, a page named after a person has to be surgically split and every inbound link rechecked. Keyed by product, that same reorg is one property change on one page. Reorgs are far more common than resignations, so this is the case that bites first.
Identity attaches to the durable thing. The volatile thing becomes an attribute of it.
| Property on each product page | Why |
|---|---|
Owner | The current PM. The field that absorbs all churn |
Previous owners | Who to ask about a decision made two years ago. Costs nothing, saves an afternoon |
Last reviewed | Blank it on handover. A new owner has not reviewed anything yet |
Status | Active / Paused / Retired. A retired product keeps its decision log |
Owner. Then a handover is one field change rather than a permissions rebuild.pm-alice/ is an installation - it holds that PM's Settings.md, their own PM-Profile.md, their session history, and it is meant to die when the laptop goes back. The shared surface is the record, and the record outlives every installation.| File | Transfers? | Why |
|---|---|---|
S-Strategy/ | Yes | Belongs to the product |
H-Hypotheses/, I-Initiatives/, P-Proof/ | Yes | Work in flight, and the record of what was already tested |
Users/Personas.md | Marked inherited | The users did not change |
Stakeholders/ | Marked inherited | The people are real, but "what makes them hard to align" was one PM's read. The new PM ratifies it, they do not adopt it blind |
Decision-Log.md | Yes | The most valuable file in the handover. Answers "why is it like this" when there is nobody left to ask |
Learning.md | Yes | Product learning compounds. Person learning is a small part of it |
Me/PM-Profile.md | Delete and rewrite | Otherwise every agent is tuned to a person who left |
Me/PM-Voice.md | Delete | Written output in a departed colleague's voice |
Me/Coaching-Log.md | Stays with the person | It was never about the product |
Settings.md | Partly | Modes transfer. voice and pm_voice do not - modes describe the setup, voice describes the person |
Previous owners.Last reviewedNot "today". The new owner has not reviewed it yet, and pretending otherwise is how stale context gets trusted.Owner, step 1 already did this.bash setup.sh, connect to the org layer.R-Relationships/Me/ and rewrite itThe single most important step, and the one that gets skipped - because the folder looks populated and harmless while it quietly tunes every agent to somebody else.inherited: <date>, from <name> to the front matter of every transferred file. A new PM needs to know which claims they have ratified and which they merely have not deleted yet - and after three months, nobody can tell the difference from memory.If a PM leaves and there is no replacement for two months, the Owner field sits empty and the context quietly rots. Two guards:
| Anti-pattern | What it produces |
|---|---|
| One shared worksheet, several people editing it | A single blended PM who does not exist. Every instance is tuned to a person who is not in the room |
| The lead fills it in for each PM | Agents optimise for the lead's challenge. The PM never owns the file, never updates it, and it is stale in six weeks |
| Everyone fills theirs in one room together | The loudest PM's answers become the template, and the inconsistency between PMs - the finding you want - disappears |
| PMs install before the org layer exists | Their strategy has to be reconciled against org context afterwards, which is a rewrite, not a review |
[Missing] markers resolvedshared/ files generated and reviewed, with OKRs.md refined through OKR-PartnerOwner setteam_mode: lead set in Settings.mdbash setup.sh run oncevp/shared/ populatedteam_mode: individual confirmed in Settings.mdStructural-Integrity-Auditor run on S-Strategy/shared/Constraints.mdshared/Stakeholders.mdAI-SHIPR Workshop by Yaniv Yaakubovich