spec-propose

Analyzes project context and proposes the next features to build with priority reasoning.

Updated Mar 11, 2026
One-click install
npx skills add https://github.com/julien-m/livespec --skill spec-propose-julien-m
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-propose
Source: https://github.com/julien-m/livespec/tree/main/.agent-sync/skills/spec-propose
Command: npx skills add https://github.com/julien-m/livespec --skill spec-propose-julien-m

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Deciding what to build next in a spec-driven project is hard when features, roles, and roadmap items are scattered across files. This Skill reads the full project context and produces ranked, justified feature proposals so teams always know the highest-priority next step. ## Core Features & Use Cases - Gap Analysis Across Five Dimensions: Evaluates role coverage, domain coverage, dependency order, status gaps, and the MVP critical path to find what is missing. - Ranked Feature Proposals: Scores candidates by MVP criticality, dependency unblocking, role coverage, scope fit, roadmap alignment, and deferred user intent, then presents the top N with scope estimates and quick-start commands. - Read-Only Operation: Creates or modifies no files, making it safe to run anytime for reassessment. - Use Case: After finishing a messaging feature, run the command to discover that the Admin role has zero coverage and receive a ready-to-run /spec-specify command for an admin moderation feature. ## Quick Start Ask the assistant to run /spec-propose to analyze the project context and propose the next feature to build.

Frequently Asked Questions about spec-propose

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

FAQPage Schema
How do I decide which feature to build next in a spec-driven project?

Run /spec-propose to scan your project context, existing features, and roadmap. It performs gap analysis across roles, domains, dependencies, and MVP criticality, then presents ranked proposals with reasoning and a ready-to-run /spec-specify command.

How to get multiple feature proposals instead of just one?

Use the --count flag, for example /spec-propose --count 3, to receive up to five ranked proposals in a table. You can combine it with --role to focus on a specific user role or --mvp to restrict to MVP-critical features.

Does spec-propose modify any project files?

No, it is a strictly read-only command. It reads .specs/project.md, feature specs, and roadmap.md but creates or modifies nothing, making it safe to run anytime to reassess priorities.

What happens if I run spec-propose before initializing the project?

If the .specs/ directory does not exist, the command stops and suggests running /spec-init first. Project context files like project.md are required preconditions for meaningful proposals.

How does spec-propose handle deferred roadmap items?

Deferred items from previous /spec-specify splits receive a +1 priority boost because they represent explicit user intent. When a proposal originates from the Deferred section, the original request context is shown alongside it.