sdd-propose

Generate structured change proposals with scope, approach, and risks.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/aroca89/roca_teams --skill sdd-propose-aroca89
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-propose
Source: https://github.com/aroca89/roca_teams/tree/main/skills/sdd-propose
Command: npx skills add https://github.com/aroca89/roca_teams --skill sdd-propose-aroca89

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill keeps the SDD pipeline moving by turning exploration outputs or direct change intent into a consistent, documented proposal with clear intent, scope, approach, risks, rollback, dependencies, and success criteria so the orchestrator never loses context.

Core Features & Use Cases

  • Context-aware proposal drafting: Digest exploration analysis or user descriptions, summarize the key problems, in/out scope, approach, affected areas, risks, rollback plan, and success criteria into the required proposal template.
  • Multi-mode persistence: Honor engram, openspec, hybrid, and none modes by reading Engram observations when available, writing openspec/changes/{change-name}/proposal.md, and calling mem_save with the defined topic key so downstream phases can find the artifact.
  • Pipeline-ready response: Deliver an envelope with status, executive summary, artifacts, and next recommended steps so the orchestrator can proceed to specs or design without manual translation.

Quick Start

Generate a structured change proposal by invoking sdd-propose with the change name and exploration summary so it can persist the document in the requested mode.

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 structured change proposal for spec-driven development?

To create a structured change proposal for spec-driven development, you transform exploration conclusions into a document defining intent, scope, approach, risks, rollback, dependencies, and success criteria. This ensures your orchestrator pipeline retains full context for downstream phases.

What is spec-driven development proposal persistence and when do I need it?

Spec-driven development proposal persistence saves your change proposal artifacts so downstream pipeline phases can locate them. You need it when running an SDD orchestrator to prevent losing context between exploration and design phases across engram, openspec, hybrid, or none modes.

How do I write change proposals to openspec directories?

You write change proposals to openspec directories by generating a proposal markdown file at `openspec/changes/{change-name}/proposal.md`. This enforces persistence contracts so the orchestrator can automatically access the documented scope, risks, and approach.

Can I use direct user intent instead of exploration output to generate an SDD proposal?

Yes, you can use direct user intent instead of exploration output to generate an SDD proposal. The system digests direct change descriptions or exploration analysis to draft the required proposal, summarizing key problems, affected areas, and success criteria.

Does the SDD proposal phase support Engram memory persistence?

Yes, the SDD proposal phase supports Engram memory persistence by calling `mem_save` with a defined topic key and metadata. It honors engram, hybrid, and none modes, reading Engram observations when available to maintain pipeline context.

What limitations exist when generating change proposals without exploration output?

Generating change proposals without exploration output limits the context available for documenting intent and affected areas. You must manually provide direct change descriptions, which may increase the risk of missing implicit scope, dependencies, or rollback criteria typically identified during exploration.