10x-shape

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

Updated Jul 4, 2026
One-click install
npx skills add https://github.com/Assamir/ai-toolkit --skill 10x-shape-assamir
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: 10x-shape
Source: https://github.com/Assamir/ai-toolkit/tree/main/.cursor/skills/10x-shape
Command: npx skills add https://github.com/Assamir/ai-toolkit --skill 10x-shape-assamir

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Turning a raw project idea into a well-structured PRD requires disciplined discovery, and most teams skip straight to writing requirements without validating the problem, persona, scope, or business logic. This Skill runs a guided, phase-by-phase discovery conversation that captures decisions into a resumable shape-notes.md file, ready for downstream PRD generation. ## Core Features & Use Cases - Greenfield and brownfield auto-detection: Scores the working directory against git history, lockfiles, and manifest files to detect whether the session shapes a new project or a change to an existing system. - Six-phase discovery with checkpoints: Walks through vision and problem, persona and access control, MVP discipline, functional requirements with a Socrates challenge round, business logic, and stack openness, writing checkpoint frontmatter so interrupted sessions resume without replaying completed phases. - Scope-cost and empty-CRUD guardrails: Surfaces oversized MVP timelines with explicit scope-down or commit options, and flags CRUD-only products that lack a domain rule. - Use Case: A developer with an idea for a recipe app runs the skill, answers structured questions about the pain, persona, and MVP flow, and ends with a shape-notes.md that the /10x-prd skill converts into a schema-conforming PRD. ## Quick Start Ask the AI to shape your idea by saying: run /10x-shape with a short description of the project or change you want to build, then answer the discovery questions phase by phase.

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 project idea into a PRD?

Run /10x-shape with your idea as an argument, then answer the guided discovery questions across six phases. The skill writes shape-notes.md, which the /10x-prd skill converts into a schema-conforming PRD.

What is the difference between greenfield and brownfield discovery?

Greenfield shapes a new project from scratch, while brownfield shapes a change to an existing system and additionally captures the current system, preserved behavior, and constraints. The skill auto-detects the mode from git history, lockfiles, and manifest files in the working directory.

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 without replaying completed ones.

When should I not use a full discovery workflow?

Skip it when the project already has a PRD or ADR set, or when the task is a single bug, refactor, or small feature that does not warrant a full PRD. In those cases a lighter reframing skill such as /10x-frame is the right starting point.

Does the discovery skill decide my tech stack?

No. The skill never pre-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.