10x-shape

Facilitates structured discovery conversations that turn product ideas into shape-notes.md for PRD generation.

Updated May 23, 2026
One-click install
npx skills add https://github.com/BMS-kmusial/bms-stream-monitor --skill 10x-shape-bms-kmusial
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: 10x-shape
Source: https://github.com/BMS-kmusial/bms-stream-monitor/tree/main/.claude/skills/10x-shape
Command: npx skills add https://github.com/BMS-kmusial/bms-stream-monitor --skill 10x-shape-bms-kmusial

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Turning a raw product idea or a proposed change to an existing system into a well-structured PRD requires disciplined discovery. This Skill guides users through a six-phase facilitated conversation that captures vision, personas, MVP scope, functional requirements, and business logic into a resumable shape-notes.md file that /10x-prd consumes directly. ## Core Features & Use Cases - Greenfield/Brownfield Auto-Detection: Scores project markers in the working directory (git history, lockfiles, manifests) to detect whether the session shapes a new project or a change to an existing system, adapting all six discovery phases accordingly. - Resumable Checkpoint Sessions: Writes a checkpoint block into shape-notes.md frontmatter so interrupted discovery sessions can resume from the exact phase where they left off. - Facilitator-Only Questioning: Uses gray-area multi-select questions, recommended answers, and a Socrates challenge round per functional requirement without ever inventing domain content the user did not state. - Use Case: A developer with an idea for a recipe app runs the skill, answers structured discovery questions across six phases, and ends with a complete shape-notes.md ready for /10x-prd to convert into a schema-conforming PRD. ## Quick Start Ask the AI to run /10x-shape with your idea, for example: shape my idea for a recipe app that suggests meals from what's in my fridge.

Frequently Asked Questions about 10x-shape

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn a product idea into a PRD?

Run /10x-shape with your idea as an argument, then answer the six discovery phases covering vision, persona, MVP scope, functional requirements, and business logic. The skill writes shape-notes.md, which /10x-prd converts into a schema-conforming PRD.

How does the skill detect greenfield vs brownfield projects?

It scores the working directory across three signal tiers: git history and lockfiles are strong brownfield signals, manifest files alone are ambiguous, and no signals means greenfield. You confirm or override the detected mode before discovery begins.

Can I resume an interrupted discovery session?

Yes. The skill writes a checkpoint block into shape-notes.md frontmatter tracking the current phase, completed phases, and drafted FRs. On re-entry it offers to resume from the next unfinished phase, restart from scratch, or cancel.

When should I not use this discovery skill?

Skip it when the project already has a PRD or ADR set, or when you are reasoning about a single bug, refactor, or small feature that does not warrant a full PRD. Use /10x-frame for small-scope reframing instead.

Does the skill decide the tech stack during discovery?

No. It never pre-commits to frameworks, databases, or hosting platforms. The PRD captures only product-level priors like product type, target scale, and timeline; stack selection happens in a downstream step after /10x-prd.