sdd-propose

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a rough feature idea or exploration analysis into a well-structured change proposal is slow and inconsistent. This Skill standardizes the proposal phase of spec-driven development by generating a concise proposal.md with intent, scope, capabilities, risks, and success criteria. ## Core Features & Use Cases - Structured Proposal Generation: Produces a proposal.md with Intent, Scope, Capabilities, Approach, Affected Areas, Risks, Rollback Plan, and Success Criteria sections. - Multi-Mode Persistence: Supports engram, openspec, hybrid, and none artifact store modes, writing to openspec/changes/ or an Engram store as configured. - Interactive Question Round: Offers a proposal-shaping question round covering business rules, edge cases, and scope boundaries before finalizing. - Use Case: After exploring a codebase for a new dark-mode feature, delegate to this Skill to produce a proposal defining which capabilities are new or modified, so the sdd-spec phase knows exactly which spec files to create. ## 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 via the orchestrator. It generates a proposal.md with intent, scope, capabilities, approach, risks, rollback plan, and success criteria, then persists it according to the configured artifact store mode.

What is the difference between openspec and engram persistence modes?▼

Openspec mode writes proposal.md to the openspec/changes/{change-name}/ directory on the filesystem. Engram mode stores the artifact under the topic key sdd/{change-name}/proposal instead, while hybrid mode does both and none returns the result inline only.

Can the orchestrator run the sdd-propose skill directly?▼

No. The skill has an orchestrator gate that forbids inline execution when loaded via the skill tool. The orchestrator must delegate to the dedicated sdd-propose sub-agent, which acts as the executor.

What goes in the Capabilities section of a proposal?▼

The Capabilities section lists new capabilities (which become new spec files under openspec/specs/) and modified capabilities (which become delta specs). It is the contract with the sdd-spec phase, so existing spec names must be researched first.

Why does my proposal need a rollback plan and success criteria?▼

The skill mandates both sections in every proposal. The rollback plan describes how to revert if something goes wrong, and success criteria define measurable outcomes that confirm the change succeeded.