sdd-propose

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

Updated Aug 25, 2026
One-click install
npx skills add https://github.com/CarlosWilliamsR/SketchOS --skill sdd-propose-carloswilliamsr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-propose
Source: https://github.com/CarlosWilliamsR/SketchOS/tree/main/.config/opencode/skills/sdd-propose
Command: npx skills add https://github.com/CarlosWilliamsR/SketchOS --skill sdd-propose-carloswilliamsr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a rough change idea into a well-structured proposal is slow and inconsistent. This Skill generates a standardized proposal.md document capturing intent, scope, capabilities, risks, and rollback plans so spec and design phases have a clear contract to build on. ## 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 Proposal Shaping: Runs a product question round covering business rules, edge cases, and tradeoffs before finalizing the proposal. - Multi-Mode Persistence: Supports engram, openspec, hybrid, and none artifact store modes, writing to Engram topics or openspec/changes/ folders as configured. - Use Case: After exploring a codebase for a dark-mode feature, the orchestrator delegates to this Skill to produce a concise proposal defining new and modified capabilities that the sdd-spec agent will turn into specs. ## 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 to the sdd-propose sub-agent with a change name and exploration analysis or user description. It runs a product question round, then writes a proposal.md with intent, scope, capabilities, risks, and rollback plan.

What sections does an SDD proposal document contain?

The proposal includes Intent, In/Out Scope, Capabilities (new and modified), Approach, Affected Areas, Risks, Rollback Plan, Dependencies, and Success Criteria. The Capabilities section acts as the contract for the downstream sdd-spec phase.

Can sdd-propose work without writing files to the repository?

Yes. In engram mode it persists the proposal to an Engram topic, and in none mode it returns the result inline without creating or modifying any project files. Only openspec and hybrid modes write to openspec/changes/.

What is the difference between new and modified capabilities in a proposal?

New capabilities become entirely new spec files under openspec/specs/, while modified capabilities reference existing specs whose requirements change and produce delta specs in the change folder. Pure refactors with no spec-level change should list None under both.

Why does the proposal phase ask product questions before writing?

The question round uncovers business rules, edge cases, scope boundaries, and tradeoffs that make the proposal ambiguous or risky if missed. Users can answer, skip, or request a second round before the proposal is finalized.