The journey
| Say this |
What happens |
run-pestle-analysis |
Scan the macro environment: Political, Economic, Social, Technological, Legal, Environmental |
run-porters-five-forces |
Map competitive forces: supplier/buyer power, new entrants, substitutes, rivalry |
run-bcg-matrix |
Position each initiative in the portfolio: Stars, Cash Cows, Question Marks, Dogs |
run-swot |
Synthesize the situation picture: Strengths, Weaknesses, Opportunities, Threats |
run-okr-cascade |
Cascade OKRs, identify gaps, and route them to the PE shaping queue |
write-prfaq |
Draft the press release + FAQ before the product exists |
synthesize-stakeholder-research |
Synthesize desk-research outputs into a strategic narrative by theme |
define-ux-strategy |
Set the experience vision, goals, and plan — upstream of journey-mapping |
define-content-strategy |
Set the content governance layer — upstream of content-design |
1. Analyze the market situation
Run the market analysis sequence — run-pestle-analysis (macro environment) → run-porters-five-forces (competitive landscape) → run-bcg-matrix (portfolio position) — then run-swot to synthesize all three into the capstone situation picture.
run-swot
Quadrant Items
───────────── ──────────────────────────────────────────────────
Strengths Developer-first positioning; fast iteration cycle
Weaknesses Low brand awareness outside early-adopter segment
Opportunities AI-native distribution; enterprise channel open
Threats Funded competitor entering adjacent market
Approve the situation picture? ›
- You decide: approve the SWOT before the PRFAQ and OKR cascade build on it — a vague situation picture means downstream artifacts build on ungrounded assumptions.
- Output:
docs/product/shaping/swot-analysis.md — the capstone situation picture built from macro-environment.md, competitive-landscape.md, and portfolio-position.md.
- State: draft
2. Commit altitude-0 direction
Type write-prfaq and describe the product concept; the agent drafts the press release and FAQ, naming the specific customer, the measurable benefit, and the hardest objection a skeptical stakeholder would raise.
write-prfaq
Headline: [Company] ships workspace.toml — product engineers who
coordinate AI agent work across sessions.
Customer: A solo engineer shipping a 3-person startup's backlog
with AI coding agents.
Problem: Every session starts blind. The agent doesn't know
what was decided, what's blocked, or what ships next.
Solution: workspace.toml — a version-controlled queue the agent
reads at session start. One grep, full context.
Approve the PRFAQ? ›
- You decide: approve the PRFAQ — if the press release doesn’t name a specific person or deliver a measurable benefit, redirect before the cascade sets gaps against an underspecified vision.
- Output:
docs/product/shaping/prfaq.md — the altitude-0 forcing function initiative briefs trace back to.
- State: draft
3. Cascade OKRs to the shaping queue
Type run-okr-cascade; the agent derives team-level OKRs from company targets, identifies gaps between current state and each target, and prepares strategy-type entries for workspace.toml.
run-okr-cascade
Gap slug KR Priority
────────────────── ────────────────────── ──────────
retention-cohort Retain 60% at week 4 High
activation-depth 3 features in 14 days High
channel-enterprise ARR from enterprise Medium
Approve and write to workspace.toml? ›
- You decide: approve the gap list — confirm each gap reflects an actual OKR delta, is ranked by OKR weight, and is specific enough for
frame-situation to scope without re-scoping from scratch.
- Output:
docs/product/shaping/okr-cascade.md and strategy-type entries in workspace.toml — gaps product engineers pick up from workspace-status.
- State: confirmed-write
4. Set experience and content direction
Type define-ux-strategy to commit the experience vision, goals with measures, and plan; type define-content-strategy to commit the organizational and governance layer for content.
define-ux-strategy
Vision: Reduce session-start friction for engineers who run AI
coding agents daily — every agent reads context in under
10 seconds.
Goals:
KR-1 Task-completion rate > 80% without re-scoping
KR-2 Session-start orient time < 10 s (p75)
committed docs/product/shaping/ux-strategy.md
- Output:
docs/product/shaping/ux-strategy.md and docs/product/shaping/content-strategy.md — the anchors the experience-design pack reads from when journey-mapping and content-design run.
- State: draft