PM Trend to Decision
Use this skill when a new release note, platform change, developer-tool update,
policy note, competitor move, or trend digest creates a product question. Keep
the source, observed change, possible impact, and next validation separate. A
trend brief should make a decision easier to review; it should not manufacture
urgency.
When to use
Use it for:
- AI model, agent, or platform release notes;
- API, SDK, developer-tool, pricing, or access changes;
- competitor or market notes that need a product response;
- an internal trend digest that needs source checking before circulation;
- a question about who may be affected and what to validate first.
Do not use it to:
- predict adoption or market size from one announcement;
- replace an official changelog, policy, or compatibility document;
- turn a vendor claim into a verified product capability;
- write a launch decision with no affected user, source, or test;
- present an AI-generated digest as independent evidence.
Guardrails
- Treat the supplied material as the evidence boundary. If an origin, URL,
date, version, denominator, user context, or outcome is absent, write
Not provided or Not verified.
- Keep four things separate: the observed change, what it may affect, what it
does not prove, and what would be tested next.
- Give every source a stable ID. Preserve source type, origin, date/version,
and whether the source is primary, secondary, internal, or AI-generated when
that information is supplied.
- A vendor announcement can show an intended or documented change. It does
not by itself prove reliability, compatibility, user demand, adoption,
business impact, or production readiness.
- Treat an AI-generated summary as an artifact to inspect. Trace any material
claim to the underlying source or mark it
Not verified.
- Preserve conflicting sources and later corrections. Do not turn disagreement
into a single confident trend line.
- Mark thresholds, sample sizes, time windows, and decision rules as
proposed unless the input establishes them.
- Remove names, private tickets, credentials, and confidential roadmap detail
from the handoff unless the user supplied a safe public form.
Workflow
1. Frame the decision
Write one sentence:
We need to decide whether ... for ... because ....
If the decision or affected user is missing, say Decision on the desk: Not provided or Affected user/product: Not provided. Do not fill the gap with a
generic recommendation.
2. Build the change ledger
Give each source a stable ID such as S1, S2, or the ID already present in
the input. Record the source type, origin, date/version, and a short exact line
when possible. Otherwise label a faithful paraphrase as a paraphrase.
For every observed change, answer both questions:
- What does this source support?
- What does this source not prove?
3. Map possible impact
For each affected area, name the user or product surface, the possible impact,
the evidence status, and the unknown that could change the decision. Use
source-backed, hypothesis, or Not verified; do not use a confidence score
to hide missing evidence.
4. Write candidate implications
Keep each implication narrow enough to review. The implication may be to
trial, update, defer, or monitor, but it is not a final decision unless
the supplied evidence supports that level. Attach source IDs and one
limitation to every source-backed implication.
5. Choose the smallest validation
Propose one reversible test that could change the decision. Specify:
- question: what uncertainty the test is meant to reduce;
- change: what will be different;
- audience or context: who will encounter it and where;
- primary metric: the one observable outcome;
- guardrail: what must not get worse;
- decision rule: what result would change the next step;
- timebox: how long or how many observations, labelled
proposed when needed.
If the input does not justify a metric, use Proposed metric and explain what
would make it measurable.
6. Hand off for human review
End with Not covered and a short review ask. The reviewer should be able to
correct the source mapping, impact wording, limitation, or validation without
rewriting the whole brief.
Output contract
Return these sections in this order:
## Decision on the desk
...
## Change ledger
| ID | Source and type | Date/version | Observed change | Does not prove |
|---|---|---|---|---|
## Impact map
| Area | Affected user/product | Possible impact | Evidence status | Unknown |
|---|---|---|---|---|
## Candidate implications
| ID | Implication | Status | Source IDs | Limitation |
|---|---|---|---|---|
## Smallest validation
- Question:
- Change:
- Audience or context:
- Primary metric:
- Guardrail:
- Decision rule:
- Timebox:
## Not covered
- ...
## Review ask
...
Keep the brief short enough to review in one sitting. If the source set is
large, keep the main ledger focused and point to an appendix rather than
burying uncertainty in a long trend summary.
Edge cases
- Undated change: keep the source, write
Date/version: Not provided, and
state that freshness is unresolved.
- One vendor announcement: record the documented change, then mark demand,
reliability, compatibility, and production impact as
Not verified unless
other sources establish them.
- AI-generated trend digest: keep it as an artifact, trace each material
line to underlying sources, and do not count the digest as a second source.
- Conflicting sources: show both observations, name the conflict, and make
the validation distinguish between the competing explanations.
- No decision supplied: provide the source and impact ledgers, keep the
decision as
Not provided, and ask for the smallest decision that matters.
- Broad trend claim without a denominator: preserve the wording as a claim
to inspect and mark prevalence, adoption, and market size
Not verified.
- No affected user or product surface: keep the change ledger, mark impact
as
Not verified, and do not recommend a build from novelty alone.
Final check
Before returning the brief, confirm:
- every observed change has a source ID and an evidence boundary;
- dates, versions, source type, and missing origin are visible;
- no availability claim became an adoption, reliability, or business claim;
- every proposed implication has a status, source IDs where applicable, and a
limitation;
- the validation has one primary metric, one guardrail, a decision rule, and a
proposed timebox or a stated measurement gap;
Not covered names the most important unresolved uncertainty;
- no number, quote, user, outcome, market size, or adoption claim was added
from guesswork.
For a ready-to-paste fictional first run, read examples/first-run.md. For a
full fictional output shape, read references/platform-change-review.md.
1---2name: pm-trend-to-decision3description: Turn a dated AI, platform, developer-tool, or market change note into a source-linked PM decision brief with impact, uncertainty, and one smallest validation. Use when a PM needs to decide whether a change matters, who it affects, or what to test next.4---56# PM Trend to Decision78Use this skill when a new release note, platform change, developer-tool update,9policy note, competitor move, or trend digest creates a product question. Keep10the source, observed change, possible impact, and next validation separate. A11trend brief should make a decision easier to review; it should not manufacture12urgency.1314## When to use1516Use it for:1718- AI model, agent, or platform release notes;19- API, SDK, developer-tool, pricing, or access changes;20- competitor or market notes that need a product response;21- an internal trend digest that needs source checking before circulation;22- a question about who may be affected and what to validate first.2324Do not use it to:2526- predict adoption or market size from one announcement;27- replace an official changelog, policy, or compatibility document;28- turn a vendor claim into a verified product capability;29- write a launch decision with no affected user, source, or test;30- present an AI-generated digest as independent evidence.3132## Guardrails33341. Treat the supplied material as the evidence boundary. If an origin, URL,35 date, version, denominator, user context, or outcome is absent, write `Not36 provided` or `Not verified`.372. Keep four things separate: the observed change, what it may affect, what it38 does not prove, and what would be tested next.393. Give every source a stable ID. Preserve source type, origin, date/version,40 and whether the source is primary, secondary, internal, or AI-generated when41 that information is supplied.424. A vendor announcement can show an intended or documented change. It does43 not by itself prove reliability, compatibility, user demand, adoption,44 business impact, or production readiness.455. Treat an AI-generated summary as an artifact to inspect. Trace any material46 claim to the underlying source or mark it `Not verified`.476. Preserve conflicting sources and later corrections. Do not turn disagreement48 into a single confident trend line.497. Mark thresholds, sample sizes, time windows, and decision rules as50 `proposed` unless the input establishes them.518. Remove names, private tickets, credentials, and confidential roadmap detail52 from the handoff unless the user supplied a safe public form.5354## Workflow5556### 1. Frame the decision5758Write one sentence:5960> We need to decide whether `...` for `...` because `...`.6162If the decision or affected user is missing, say `Decision on the desk: Not63provided` or `Affected user/product: Not provided`. Do not fill the gap with a64generic recommendation.6566### 2. Build the change ledger6768Give each source a stable ID such as `S1`, `S2`, or the ID already present in69the input. Record the source type, origin, date/version, and a short exact line70when possible. Otherwise label a faithful paraphrase as a paraphrase.7172For every observed change, answer both questions:7374- What does this source support?75- What does this source not prove?7677### 3. Map possible impact7879For each affected area, name the user or product surface, the possible impact,80the evidence status, and the unknown that could change the decision. Use81`source-backed`, `hypothesis`, or `Not verified`; do not use a confidence score82to hide missing evidence.8384### 4. Write candidate implications8586Keep each implication narrow enough to review. The implication may be to87`trial`, `update`, `defer`, or `monitor`, but it is not a final decision unless88the supplied evidence supports that level. Attach source IDs and one89limitation to every source-backed implication.9091### 5. Choose the smallest validation9293Propose one reversible test that could change the decision. Specify:9495- question: what uncertainty the test is meant to reduce;96- change: what will be different;97- audience or context: who will encounter it and where;98- primary metric: the one observable outcome;99- guardrail: what must not get worse;100- decision rule: what result would change the next step;101- timebox: how long or how many observations, labelled `proposed` when needed.102103If the input does not justify a metric, use `Proposed metric` and explain what104would make it measurable.105106### 6. Hand off for human review107108End with `Not covered` and a short review ask. The reviewer should be able to109correct the source mapping, impact wording, limitation, or validation without110rewriting the whole brief.111112## Output contract113114Return these sections in this order:115116```markdown117## Decision on the desk118...119120## Change ledger121| ID | Source and type | Date/version | Observed change | Does not prove |122|---|---|---|---|---|123124## Impact map125| Area | Affected user/product | Possible impact | Evidence status | Unknown |126|---|---|---|---|---|127128## Candidate implications129| ID | Implication | Status | Source IDs | Limitation |130|---|---|---|---|---|131132## Smallest validation133- Question:134- Change:135- Audience or context:136- Primary metric:137- Guardrail:138- Decision rule:139- Timebox:140141## Not covered142- ...143144## Review ask145...146```147148Keep the brief short enough to review in one sitting. If the source set is149large, keep the main ledger focused and point to an appendix rather than150burying uncertainty in a long trend summary.151152## Edge cases153154- **Undated change:** keep the source, write `Date/version: Not provided`, and155 state that freshness is unresolved.156- **One vendor announcement:** record the documented change, then mark demand,157 reliability, compatibility, and production impact as `Not verified` unless158 other sources establish them.159- **AI-generated trend digest:** keep it as an artifact, trace each material160 line to underlying sources, and do not count the digest as a second source.161- **Conflicting sources:** show both observations, name the conflict, and make162 the validation distinguish between the competing explanations.163- **No decision supplied:** provide the source and impact ledgers, keep the164 decision as `Not provided`, and ask for the smallest decision that matters.165- **Broad trend claim without a denominator:** preserve the wording as a claim166 to inspect and mark prevalence, adoption, and market size `Not verified`.167- **No affected user or product surface:** keep the change ledger, mark impact168 as `Not verified`, and do not recommend a build from novelty alone.169170## Final check171172Before returning the brief, confirm:173174- every observed change has a source ID and an evidence boundary;175- dates, versions, source type, and missing origin are visible;176- no availability claim became an adoption, reliability, or business claim;177- every proposed implication has a status, source IDs where applicable, and a178 limitation;179- the validation has one primary metric, one guardrail, a decision rule, and a180 proposed timebox or a stated measurement gap;181- `Not covered` names the most important unresolved uncertainty;182- no number, quote, user, outcome, market size, or adoption claim was added183 from guesswork.184185For a ready-to-paste fictional first run, read `examples/first-run.md`. For a186full fictional output shape, read `references/platform-change-review.md`.