sdd-propose

Generate openspec-compatible proposal.md documents with rollback and success criteria.

1.3k|159|Updated Feb 16, 2026
One-click install
npx skills add https://github.com/Gentleman-Programming/agent-teams-lite --skill sdd-propose
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-propose
Source: https://github.com/Gentleman-Programming/agent-teams-lite/tree/main/skills/sdd-propose
Command: npx skills add https://github.com/Gentleman-Programming/agent-teams-lite --skill sdd-propose

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This tool helps orchestrators generate a formal change proposal by converting exploration analysis or user input into a structured document that guides implementation and governance.

Core Features & Use Cases

  • Converts exploration results into a proposal.md with sections for Intent, Scope, and Approach.
  • Reads and respects openspec conventions to ensure consistency with artifact storage and review workflows.
  • Validates and includes rollback plans, success criteria, and dependencies to enable safe, auditable changes.

Quick Start

Provide the change name and exploration notes, then request a proposal to be created and stored under openspec/changes/{change-name}/proposal.md.

Frequently Asked Questions about sdd-propose

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

FAQPage Schema
How do I create a formal change proposal document for an engineering change request?

To create a change proposal, provide the change name and exploration notes to generate a structured proposal.md. This document includes Intent, Scope, and Approach sections to guide implementation and governance.

What is the openspec convention for storing change proposals?

The openspec convention requires storing change proposals at openspec/changes/{change-name}/proposal.md. This ensures consistency with artifact storage and review workflows for engineering change requests.

Does a generated change proposal include rollback plans and success criteria?

Yes, a generated change proposal validates and includes rollback plans, success criteria, and dependency references. These elements enable safe, auditable changes during engineering change management.

Can I convert exploration analysis directly into a structured proposal?

You can convert exploration analysis or user input directly into a structured proposal document. The output applies openspec conventions to produce a formal proposal.md with all required governance sections.

What is the best way to document change dependencies and scope for governance review?

The best way to document change dependencies and scope is using a structured proposal format. This approach respects openspec conventions and validates rollback plans alongside dependency references for auditable governance.

When do I need a formal proposal document instead of just tracking change requests?

You need a formal proposal document when managing engineering change requests that require rollback plans, success criteria, and dependency references. It converts exploration analysis into auditable artifacts for safe implementation.