sdd-propose

Creates structured SDD change proposals with intent, scope, capabilities, and rollback plans.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/albersg/dotfiles --skill sdd-propose-albersg
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sdd-propose
Source: https://github.com/albersg/dotfiles/tree/main/dotfiles-opencode/.opencode/skills/sdd-propose
Command: npx skills add https://github.com/albersg/dotfiles --skill sdd-propose-albersg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a vague feature idea into a structured, reviewable change proposal is slow and inconsistent. This Skill generates a standardized proposal.md document capturing intent, scope, capabilities, risks, and rollback plans so teams can align before writing specs or code. ## Core Features & Use Cases - Structured Proposal Generation: Produces a proposal.md with intent, in/out scope, capabilities, approach, affected areas, risks, rollback plan, and success criteria. - Interactive Question Rounds: Runs product-focused question rounds to uncover business rules, edge cases, and scope boundaries before finalizing the proposal. - Multi-Mode Persistence: Supports engram, openspec, hybrid, and none artifact storage modes, writing to openspec/changes/ or an Engram store as configured. - Use Case: After exploring a codebase for a dark-mode feature, delegate to this Skill to produce a concise proposal defining new and modified capabilities that downstream spec and design agents consume. ## Quick Start Ask the orchestrator to create an SDD proposal for your change, for example: create a proposal for the add-dark-mode change based on the exploration analysis.

Frequently Asked Questions about sdd-propose

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

FAQPage Schema
How do I create an SDD change proposal?▼

Delegate the change name and exploration analysis to the sdd-propose sub-agent through your orchestrator. It runs a product question round, then writes a proposal.md with intent, scope, capabilities, risks, and success criteria.

What is spec-driven development with OpenSpec?▼

Spec-driven development structures changes as proposals, specs, and designs stored under openspec/changes/. The proposal phase defines new and modified capabilities that later spec and design agents turn into detailed requirements.

Can I use this skill without creating openspec files?▼

Yes. Set the artifact store mode to engram to persist the proposal in the Engram memory store, or none to return the proposal inline without creating or modifying any project files.

Why must the proposal include a Capabilities section?▼

The Capabilities section is the contract between the proposal and spec phases. The sdd-spec agent reads it to know exactly which spec files to create or update, so it must list new and modified capabilities using existing spec names.

What are the limitations of the proposal artifact?▼

The proposal must stay under 450 words and use bullet points and tables rather than prose. It is a thinking tool, not a full PRD, and it requires a rollback plan and success criteria in every proposal.