openspec-propose

Generate proposal.md, design.md, and tasks.md for a change.

25|7|Updated Mar 4, 2019
One-click install
npx skills add https://github.com/smart-swimmingpool/pool-controller --skill openspec-propose-smart-swimmingpool
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/smart-swimmingpool/pool-controller/tree/main/.github/skills/openspec-propose
Command: npx skills add https://github.com/smart-swimmingpool/pool-controller --skill openspec-propose-smart-swimmingpool

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Propose a new change and automatically generate all artifacts (proposal.md, design.md, tasks.md) in one streamlined step, reducing manual coordination and ensuring consistency across documentation and planning.

Core Features & Use Cases

  • Automatically scaffolds a change with all required artifacts
  • Keeps design, rationale, and implementation tasks aligned
  • Useful for fast-forward planning of new features, fixes, or experiments

Quick Start

Describe the change you want to build to generate a complete proposal with design, specs, and tasks.

Frequently Asked Questions about openspec-propose

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

FAQPage Schema
How do I generate a complete change proposal with design docs and task plans?

You can generate a complete change proposal with design docs and task plans by describing the intended change, which automatically scaffolds proposal.md, design.md, and tasks.md in a single step to accelerate planning.

What is an OpenSpec change proposal and when do I need one?

An OpenSpec change proposal is a structured set of artifacts that keeps design rationale and implementation tasks aligned. You need one when planning new features or fixes to ensure consistent documentation across engineering teams.

How do I scaffold project artifacts for a new feature in one step?

To scaffold project artifacts for a new feature in one step, describe the change you want to build. This generates the required proposal, design, and tasks files simultaneously, reducing manual coordination.

Does generating a design doc automatically create a task plan?

Yes, generating a design doc automatically creates a task plan. The scaffolding process outputs proposal.md, design.md, and tasks.md together, ensuring your implementation tasks remain perfectly aligned with your design rationale.

Can I use this to track dependencies for engineering task planning?

Yes, you can use this for engineering task planning to track dependencies. It satisfies the OpenSpec workflow by scaffolding the necessary artifacts and mapping out the implementation tasks required for your proposed changes.

What is the best way to plan software fixes without manual documentation coordination?

The best way to plan software fixes without manual coordination is using an automated proposal scaffolding process. It generates design and task artifacts simultaneously, ensuring fast-forward planning and documentation consistency.