sdd-propose

Creates structured change proposals with intent, scope, approach, risks, and rollback plans.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/juanjo-zurich/juarvis-v4 --skill sdd-propose-juanjo-zurich
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sdd-propose
Source: https://github.com/juanjo-zurich/juarvis-v4/tree/main/plugins/sdd/skills/sdd-propose
Command: npx skills add https://github.com/juanjo-zurich/juarvis-v4 --skill sdd-propose-juanjo-zurich

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When starting a software change, teams often skip structured planning and jump straight to code, leading to unclear scope, missed risks, and no rollback strategy. This Skill produces a standardized proposal.md document that captures intent, scope, approach, affected areas, risks, and success criteria before any implementation begins. ## Core Features & Use Cases - Structured Proposal Generation: Produces a proposal.md with intent, in/out of scope, technical approach, affected areas, risk table, rollback plan, dependencies, and success criteria. - Multi-Mode Persistence: Stores the proposal in Engram memory (mem_save with topic_key upserts), the openspec/ filesystem, both (hybrid), or returns it inline (none), depending on the artifact store mode. - Pipeline Integration: Consumes exploration analysis from sdd-explore, reads the project skill registry, and hands off to downstream phases like sdd-spec and sdd-design. - Use Case: An orchestrator launches this sub-agent with a change name like "add-dark-mode" plus exploration findings; it returns a concise proposal with a risk level and a structured envelope for the next pipeline phase. ## Quick Start Ask the orchestrator to create a proposal for your change, for example: create an SDD proposal for the change named add-dark-mode using the exploration results.

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 change proposal in a spec-driven development workflow?▼

Invoke this skill through the orchestrator with a change name and either exploration analysis or a direct description. It writes a proposal.md covering intent, scope, approach, risks, rollback plan, and success criteria, then persists it according to your artifact store mode.

What sections should a software change proposal include?▼

A complete proposal includes intent, in-scope and out-of-scope items, technical approach, an affected areas table, a risk table with mitigations, a rollback plan, dependencies, and measurable success criteria. This skill enforces all of these sections.

Does sdd-propose work without the openspec filesystem?▼

Yes. In engram mode it persists the proposal via mem_save with a topic_key for upserts, and in none mode it returns the proposal inline without creating any files. The openspec directory is only created in openspec or hybrid modes.

What happens if a proposal already exists for the change?▼

The skill reads the existing proposal first and updates it rather than overwriting blindly. In engram mode, saving with the same topic_key performs an upsert that updates the stored observation instead of duplicating it.

Why does the SDD pipeline break after the proposal step?▼

The pipeline breaks when the persistence step is skipped, because downstream phases like sdd-spec retrieve the proposal from Engram or the openspec filesystem. The skill mandates the persistence step to keep the artifact discoverable.