openspec-propose

Generate OpenSpec change proposals with kebab-case IDs and spec deltas.

Updated Oct 26, 2025
One-click install
npx skills add https://github.com/discountedcookie/10x-mapmaster --skill openspec-propose-discountedcookie
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/discountedcookie/10x-mapmaster/tree/main/.opencode/skills/openspec-propose
Command: npx skills add https://github.com/discountedcookie/10x-mapmaster --skill openspec-propose-discountedcookie

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps draft OpenSpec proposals for new features or architectural changes and requires approval before implementation.

Core Features & Use Cases

  • Proposal drafting: Openspec project, goals, impact, and tasks.
  • Spec delta planning: Documents modified or added specs per capability.
  • Approval workflow: Guides to request explicit user approval.

Quick Start

Create a proposal and associated tasks for a new feature, awaiting approval.

Frequently Asked Questions about openspec-propose

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

FAQPage Schema
How do I create a change proposal for a new feature?

A change proposal documents the feature's goals, impact, and implementation tasks before development begins. Generate a proposal by defining the project scope, assigning a kebab-case change ID, drafting specifications, and listing required tasks. This enforces approval-first workflows and produces proposal.md, tasks.md, and design.md outputs for review.

What is a spec delta and why do I need one?

A spec delta captures modified or added specifications for each capability affected by your change. It documents what changes in the existing design or behavior, enabling reviewers to assess impact quickly and maintain accurate system documentation as features evolve.

How do I enforce NO IMPLEMENTATION WITHOUT APPROVAL in my workflow?

Structure your change process in phases: proposal, review, and approval before coding starts. This Skill guides you through generating phase-based outputs that block implementation until explicit user approval is granted, preventing unvetted changes from reaching production.

Can I use this for architectural changes, not just new features?

Yes. This Skill handles both new features and architectural changes during product evolution cycles. The same proposal, task, and spec delta process applies to any significant behavioral or structural change requiring stakeholder review.

What outputs do I get from drafting a proposal?

You receive proposal.md describing the feature and goals, tasks.md listing implementation work, design.md capturing architectural decisions when needed, and spec deltas documenting all modified or new specifications. These artifacts are ready for team review and approval.