10x-shape

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

Updated May 24, 2026
One-click install
npx skills add https://github.com/DevMachaj/Projekt-certyfikacyjny --skill 10x-shape-devmachaj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: 10x-shape
Source: https://github.com/DevMachaj/Projekt-certyfikacyjny/tree/main/.claude/skills/10x-shape
Command: npx skills add https://github.com/DevMachaj/Projekt-certyfikacyjny --skill 10x-shape-devmachaj

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 that conversation phase by phase, capturing decisions into a resumable shape-notes.md file that the /10x-prd skill can consume directly. ## Core Features & Use Cases - Greenfield and brownfield auto-detection: Scans the working directory for git history, lockfiles, and manifests to detect project context and adapts all six discovery phases accordingly. - Six-phase facilitated discovery: Walks through vision and problem, persona and access control, MVP scoping, functional requirements, a Socrates challenge round per FR, and business logic — never inventing content the user did not say. - Resumable checkpoints: Writes a checkpoint block into shape-notes.md frontmatter so interrupted sessions resume at the next unfinished phase. - Use Case: A solo founder says "/10x-shape a recipe app that suggests meals from fridge contents" and is guided through scoped discovery, ending with shape-notes.md ready for /10x-prd. ## Quick Start Run /10x-shape followed by your idea in your own words, for example "/10x-shape a recipe app that suggests meals from what's in my fridge", and answer the guided discovery questions.

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 with AI?

Start with /10x-shape followed by your idea in freeform text. The skill runs a six-phase discovery conversation covering vision, persona, MVP scope, functional requirements, and business logic, then writes shape-notes.md which /10x-prd converts into a full PRD.

What is the difference between greenfield and brownfield shaping?

Greenfield shaping assumes a new project built from scratch, while brownfield shaping describes changes to an existing system. The skill auto-detects context from git history, lockfiles, and manifests in the working directory, and brownfield mode adds Current System and Constraints sections.

Can I resume an interrupted discovery session?

Yes. The skill writes a checkpoint block into shape-notes.md frontmatter tracking the current phase and completed phases. On re-invocation it detects the prior session and offers to resume from the next unfinished phase without replaying completed ones.

When should I not use a discovery shaping 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 within an existing codebase. Those cases call for lighter reframing or planning tools instead of full discovery.

Does the shaping skill decide my tech stack?

No. The skill deliberately never commits to frameworks, databases, or hosting platforms. It captures only product-level priors like product type, target scale, and timeline budget; stack selection happens in a downstream step after the PRD.