Verve-PM Verve-PM ← All Resources
AI-SHIPR

Team Rollout: Who Fills What

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.

Section 1
The Rule
The rule
One worksheet per person. Each person answers about their own scope. Nobody answers on behalf of anyone else.

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.

LayerWho writes itWho 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
Shared where it must be shared, personal where it must be personal. A VP answering for everyone collapses the second layer into the first - and the second layer is where the actual PM work happens.
The common mistake. A team lead reading "Team lead" in the worksheet's setup question naturally hears "I answer for the team." It is the single most frequent rollout failure, and it produces one blended PM who does not exist.

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.

PartVP (team_mode: lead)Each PM (team_mode: individual)
Setup Q1 - productsThe whole portfolioWhatever they own. Usually one
Setup Q2 - teamTeam leadIndividual PM
1 - Your ProductsEvery product, one paragraph each. Portfolio altitudeTheir product only, in depth
2 - Your StrategyOrg bets and OKRs. The 1–3 bets the company is makingProduct bets, each laddering to one of the VP's
3 - Your ConstraintsOrg constraints: headcount, budget, regulatory, platform realityConstraints specific to their product and squad
4 - Your RoleTheir own role, challenge and time split, as the leadTheir own role, challenge and time split, as a PM
5 - Your StakeholdersExec, commercial, customer-side, cross-productTheir tech lead, designer, and the stakeholders they personally align
6 - Your UsersSkip. Personas belong to the PM who owns the productTheir personas, in depth. The highest-value part for a PM
7 - Your PortfolioYes This becomes the org layerSkip, unless they own two or more products themselves
8 - Your TeamYes Only the VP fills thisSkip
Part 6 is where the PM earns their instance

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.

Part 4 cannot be delegated

"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 fileComes from
vp/shared/Vision.mdPart 1 + Part 2, at company altitude
vp/shared/Strategy.mdPart 2 - how we win
vp/shared/OKRs.mdPart 2 - metrics and targets
vp/shared/Strategic-Bets.mdPart 2 - the 1–3 bets
vp/shared/Portfolio-Roadmap.mdPart 7
vp/shared/Constraints.mdPart 3
The one file to check before the team reads it. Populate-Strategy generates all six org files from your worksheet: its Lead Mode section writes 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.
Section 2
The Sequence

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.

Phase 0 prep - access, repo, pilot group Phase 1 the VP alone → the org layer exists Phase 2 each PM individually → product layers exist Phase 3 reconcile UPWARD → the org layer gets corrected re-run quarterly, or whenever the bets change
  • 1
    Get access approved Shared drive, wiki space, or connector - whichever the team is using. In a regulated org, security review of a new tool is the long pole and everything else waits behind it if it starts late.
  • 2
    Create the runtime repo One repo holding the AI-SHIPR runtime plus the shared templates, so every machine installs the same thing and template changes get reviewed rather than appearing overnight.
  • 3
    Pick the pilot Two or three PMs, not the whole department. A rollout that stalls at five machines is harder to restart than one that succeeded at three.

60–90 minutes. Nobody else installs anything until this is done.

  • 1
    Fill the Setup WorksheetTheir own scope, per the table in section 1.02.
  • 2
    Run Populate-StrategyIt writes all six org files. Then refine shared/OKRs.md with OKR-Partner, per section 1.03.
  • 3
    Review every generated fileAnything marked [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.
  • 4
    Publish the org layerInto the shared surface, read-only for the team.
Why the VP goes first. A PM's strategy generated before the org layer exists has to be reconciled against it afterwards, and reconciliation after the fact is a rewrite. Generated after, it comes out already aligned - which is the entire reason the org layer is read first at session start.

About 60 minutes each. Individually - different rooms or different slots.

  • 1
    InstallClone the repo, extract AI-SHIPR into their own folder, run bash setup.sh once.
  • 2
    Connect to the org layerMount the shared drive, or run the sync if the shared surface is a wiki. Confirm team_mode: individual in Settings.md.
  • 3
    Read the org layerTen minutes, actually reading it. This is the step that gets skipped, and it is the one that makes step 4 worth anything.
  • 4
    Fill their own Setup WorksheetParts 1–6. Then run Populate-Strategy and review the output.
  • 5
    AuditRun Structural-Integrity-Auditor on S-Strategy/ before doing any real work in the system.
Do this in the room, not as homework. Forty-five minutes of protected time with someone present converts at a rate a calendar reminder does not. Worksheets assigned as homework are, in practice, worksheets that do not get filled.
Individually, not round-robin. In a group, the first PM to answer sets the frame and the rest anchor to it. The inconsistency between PMs is a finding you want to see clearly, not something to average away in a workshop.

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 the VP looks for
What they findWhat it meansWhat changes
A PM bet that ladders to no org betEither unfunded work, or a real bet missing from the org layerAdd the org bet, or stop the work. Both are decisions
The same constraint in two or more PM filesIt is not a product constraintMove it up to shared/Constraints.md
The same stakeholder in two or more PM filesCross-product stakeholderMove to shared/Stakeholders.md, one definition
Duplicate or conflicting personasTwo PMs describing one user two waysOne definition, in the shared templates
The same term defined differently by two PMsThe seam that costs you mostInto a shared glossary
The last row is the highest-value output of the whole install. Two PMs using the same word for different things is exactly the failure that shows up three steps later as a ticket engineering cannot estimate. This phase makes it visible in the PMs' own words, without anyone being told they are the inconsistent one.
Steady state

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.

Section 3
When a PM Changes

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.

ContentLives as long asWhere it belongs
Vision, strategy, OKRs, bets, constraintsthe companyThe org layer, VP writes
Product strategy, personas, glossary, decision logthe productProduct workspaces, keyed by product
PM profile, PM voice, coaching log, 1:1 notesthe personThe 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.

The rule
Churn should be a property change, not a page move.

Identity attaches to the durable thing. The volatile thing becomes an attribute of it.

Property on each product pageWhy
OwnerThe current PM. The field that absorbs all churn
Previous ownersWho to ask about a decision made two years ago. Costs nothing, saves an afternoon
Last reviewedBlank it on handover. A new owner has not reviewed anything yet
StatusActive / Paused / Retired. A retired product keeps its decision log
Set page permissions to follow Owner. Then a handover is one field change rather than a permissions rebuild.
The local folder stays person-keyed, and that asymmetry is deliberate. 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.
FileTransfers?Why
S-Strategy/YesBelongs to the product
H-Hypotheses/, I-Initiatives/, P-Proof/YesWork in flight, and the record of what was already tested
Users/Personas.mdMarked inheritedThe users did not change
Stakeholders/Marked inheritedThe 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.mdYesThe most valuable file in the handover. Answers "why is it like this" when there is nobody left to ask
Learning.mdYesProduct learning compounds. Person learning is a small part of it
Me/PM-Profile.mdDelete and rewriteOtherwise every agent is tuned to a person who left
Me/PM-Voice.mdDeleteWritten output in a departed colleague's voice
Me/Coaching-Log.mdStays with the personIt was never about the product
Settings.mdPartlyModes transfer. voice and pm_voice do not - modes describe the setup, voice describes the person
On the shared surface - by the VP
  • 1
    Move the Owner propertyFrom the departing PM to the new one, and add the old owner to Previous owners.
  • 2
    Blank Last reviewedNot "today". The new owner has not reviewed it yet, and pretending otherwise is how stale context gets trusted.
  • 3
    Move edit accessGrant the new PM, remove the old one. If permissions follow Owner, step 1 already did this.
  • 4
    Archive the person-scoped pages1:1 notes and PM profile. Do not pass them to the successor.
Nothing moves, nothing is renamed, no links break, and no page ends up misattributed. That is the whole return on keying by product.
On the new PM's machine
  • 5
    Fresh installClone, bash setup.sh, connect to the org layer.
  • 6
    Copy in the product foldersPer the transfer table above.
  • 7
    Delete 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.
  • 8
    Fill Parts 4 and 5 onlyThen run Populate-Strategy scoped to those parts.
A handover is a partial worksheet, not a fresh one. Parts 1, 2, 3 and 6 are inherited product content the new PM reviews and challenges. Parts 4 and 5 are personal and get answered from scratch. Same split as the table in section 1.02.
Mark what is inherited. Add 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:

  • 1
    Flag empty Owner, not only stale datesWhatever check you run for stale context should treat an unowned page as the louder of the two problems.
  • 2
    The VP takes Owner in the interimCaretaker ownership beats no ownership, and it puts the gap on someone's list rather than nobody's.
Unowned shared context is more dangerous than no context, because people still trust it. A context layer nobody owns goes stale in about six weeks.
Section 4
Getting It Wrong
Anti-patternWhat it produces
One shared worksheet, several people editing itA 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 PMAgents 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 togetherThe loudest PM's answers become the template, and the inconsistency between PMs - the finding you want - disappears
PMs install before the org layer existsTheir strategy has to be reconciled against org context afterwards, which is a rewrite, not a review
The VP
  • Access to the shared surface approved
  • Setup Worksheet filled for their own scope - Parts 1–5, 7, 8
  • Populate-Strategy run, output reviewed, [Missing] markers resolved
  • All six shared/ files generated and reviewed, with OKRs.md refined through OKR-Partner
  • Org layer published, read-only for the team
  • Product pages created - one per product, with Owner set
  • team_mode: lead set in Settings.md
Each PM
  • Installed, bash setup.sh run once
  • Connected to the org layer, vp/shared/ populated
  • Org layer actually read
  • team_mode: individual confirmed in Settings.md
  • Own Setup Worksheet filled - Parts 1–6
  • Populate-Strategy run, output reviewed
  • Structural-Integrity-Auditor run on S-Strategy/
Together, once every PM is set up
  • Each PM has published Vision, Strategic Bets and Personas to the product page they own
  • Bets laddered: every PM bet maps to an org bet, or the gap is named
  • Repeated constraints moved up to shared/Constraints.md
  • Shared stakeholders moved up to shared/Stakeholders.md
  • Personas de-duplicated into one definition each
  • Conflicting terms collected into the shared glossary
  • Org layer updated, everyone re-synced

AI-SHIPR Workshop by Yaniv Yaakubovich

Workshop Info All Resources Contact verve-pm.com