sdd-propose

Generate structured architectural change proposals with configurable Engram or OpenSpec persistence.

1|1|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/RamonsDka/the-architect-overlay --skill sdd-propose-ramonsdka
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-propose
Source: https://github.com/RamonsDka/the-architect-overlay/tree/main/skills/sdd-propose
Command: npx skills add https://github.com/RamonsDka/the-architect-overlay --skill sdd-propose-ramonsdka

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Proposals for architectural changes can be verbose and inconsistent; this Skill standardizes the creation of concise, actionable change proposals that capture intent, scope, approach, risks, and validation criteria.

Core Features & Use Cases

  • Generate a structured change proposal from exploration analysis or direct user input.
  • Define Intent, Scope, Approach, Affected Areas, Risks, Rollback, and Success Criteria in a consistent format.
  • Persist proposals to Engram or Openspec backends depending on mode; can also write to filesystem when using hybrid mode.

Quick Start

Provide the change name and a short description to generate a proposal scaffold ready for review.

Frequently Asked Questions about sdd-propose

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

FAQPage Schema
How do I draft an architectural change proposal that captures intent, scope, and approach?

You can generate a structured architectural change proposal by providing a change name and short description. The resulting scaffold defines intent, scope, approach, risks, rollback, and success criteria in a consistent format for reviewable architectural changes.

What is an architectural change proposal and when do I need one?

An architectural change proposal standardizes the documentation of intent, scope, and approach for system modifications. You need one during design phases to ensure traceable, reviewable changes that prevent verbose, inconsistent architectural documentation.

Can I persist change proposals to Engram or OpenSpec backends?

Yes, change proposals can persist directly to Engram or OpenSpec backends depending on your selected mode. Hybrid mode also supports writing the architectural change documentation directly to the filesystem for offline review.

How do I standardize architectural documentation to include risks and rollback criteria?

You standardize architectural documentation by generating a structured proposal scaffold. This enforces a consistent format that captures intent, scope, approach, affected areas, risks, rollback, and success criteria for every architectural change.

What is the best way to ensure traceable architectural changes during system design?

The best way to ensure traceable architectural changes is to generate structured proposals during exploration or design phases. This standardizes scope and approach documentation, making modifications reviewable and persistent across Engram or OpenSpec backends.

Does generating an architecture proposal require detailed input or can I use a short description?

Generating an architecture proposal requires only a change name and a short description as input. The system uses this minimal input to generate a full structured scaffold ready for review, capturing intent, scope, and validation criteria.