sdd-propose

Generate structured markdown change proposals for software development projects.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Portmeo/rag-chat-project --skill sdd-propose-portmeo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-propose
Source: https://github.com/Portmeo/rag-chat-project/tree/main/.claude/skills/sdd-propose
Command: npx skills add https://github.com/Portmeo/rag-chat-project --skill sdd-propose-portmeo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the creation of structured change proposals, ensuring all necessary components like intent, scope, and approach are clearly defined.

Core Features & Use Cases

  • Structured Proposal Generation: Creates proposal.md files within a specified change directory.
  • Dependency Management: Integrates with exploration analysis and existing specifications.
  • Use Case: When a new feature is proposed, this Skill can automatically generate a draft proposal document outlining the technical plan, risks, and rollback strategy.

Quick Start

Use the sdd-propose skill to create a proposal for the change named 'add-user-authentication'.

Frequently Asked Questions about sdd-propose

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

FAQPage Schema
How do I generate a structured change proposal for a software development project?

To generate a structured change proposal, you need to document the intent, scope, approach, risks, and rollback plans. This skill automates that process by creating a structured markdown file outlining the technical plan within a specified change directory.

What should be included in a technical change proposal draft?

A technical change proposal draft should include the project intent, scope, implementation approach, affected areas, potential risks, and rollback plans. This ensures all necessary components for clear documentation of the proposed software changes are defined.

Can I use openspec conventions to persist change proposal artifacts?

Yes, you can use openspec conventions to persist change proposal artifacts. The proposal generation process supports artifact persistence through openspec or engram conventions to maintain documentation continuity.

How do I document rollback plans and risks when proposing a new feature?

To document rollback plans and risks when proposing a new feature, you outline the technical plan and potential failure points. This skill automatically generates a draft proposal document integrating these critical risk management and rollback strategy sections.

Does this proposal generation tool integrate with existing software specifications?

Yes, the proposal generation tool integrates with existing software specifications. It uses dependency management to incorporate exploration analysis and current specifications directly into the generated change proposal document.

When do I need to draft a formal change proposal in software development?

You need to draft a formal change proposal in software development when a new feature is proposed or significant modifications are planned. It streamlines the creation of structured documentation to ensure the technical plan and affected areas are clearly defined.