10x-shape

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

Updated Aug 26, 2026
One-click install
npx skills add https://github.com/michaail/hybrid-logs-analyzer --skill 10x-shape-michaail
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: 10x-shape
Source: https://github.com/michaail/hybrid-logs-analyzer/tree/main/.cursor/skills/10x-shape
Command: npx skills add https://github.com/michaail/hybrid-logs-analyzer --skill 10x-shape-michaail

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Turning a raw project idea or a proposed change to an existing system into a well-structured PRD is hard: ideas arrive vague, scope balloons, and key decisions go unrecorded. This Skill runs a guided, phase-by-phase discovery conversation that captures vision, personas, access control, MVP scope, functional requirements, and business logic into a resumable shape-notes.md file that the /10x-prd skill can convert into a schema-conformant PRD. ## Core Features & Use Cases - Greenfield/brownfield auto-detection: Scans the working directory for git history, lockfiles, and manifests to detect project context and adapts its questioning accordingly. - Checkpointed, resumable sessions: Writes a checkpoint block into shape-notes.md frontmatter so an interrupted discovery session can resume from the correct phase without replaying completed work. - Facilitator discipline with Socratic challenge: Never invents domain content; surfaces gray-area decisions with recommended options, challenges each functional requirement with a counter-argument round, and flags empty-CRUD and oversized-MVP anti-patterns. - Use Case: A developer says "I have an idea for a recipe app that suggests meals from fridge contents." The skill walks them through six discovery phases, challenges each requirement, and produces context/foundation/shape-notes.md ready for /10x-prd. ## Quick Start Invoke the skill with your idea inline, for example "/10x-shape a recipe app that suggests meals from what's in your 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 project idea into a PRD with an AI assistant?

Run the discovery skill with your idea as an argument, then answer its phase-by-phase questions covering vision, persona, access control, MVP scope, requirements, and business logic. It writes shape-notes.md, which the /10x-prd skill converts into a schema-conformant 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 manifests 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 requirements. On re-invocation it detects the file, summarizes completed phases, and resumes at the next unfinished phase.

When should I not use a full discovery workflow?

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. In those cases a lighter reframing skill such as /10x-frame is the right tool.

Does the discovery skill decide my tech stack?

No. It deliberately never 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 the PRD.