write-design

Generate a structured SDLC proposal document with problem framing, options, and reviewers.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/mattschwartz/systemos --skill write-design
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: write-design
Source: https://github.com/mattschwartz/systemos/tree/main/.claude/skills/write-design
Command: npx skills add https://github.com/mattschwartz/systemos --skill write-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing clear, debatable proposals for large or ambiguous design decisions is hard without a structured process. This skill guides you to formalize the problem, options, reviewers, and the path forward so teams can agree before work begins.

Core Features & Use Cases

  • Structured draft creation: produces a complete proposal document with clear problem framing, decision scope, and reviewer notes.
  • SDLC-ready workflow: supports multi-agent review and tracking from draft to final decision.
  • Collaboration-ready: exports a proposal that can be loaded into a shared workflow and commit to disk.

Quick Start

Provide a draft SDL proposal by answering the key decision questions and writing the proposal to disk.

Frequently Asked Questions about write-design

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

FAQPage Schema
How do I draft an SDLC design proposal for stakeholder alignment?▼

Draft an SDLC design proposal by formalizing the problem framing, decision options, and reviewer notes into a structured document. This ensures stakeholder alignment before development begins and writes the output to a designated draft location for later review.

What is the best way to structure design documentation for ambiguous decisions?▼

Structure design documentation by producing an end-to-end proposal that includes a debatable problem statement, decision scope, and designated reviewers. This formalizes ambiguous decisions into a clear path forward ready for team commit.

Does this proposal workflow support multi-agent review for design decisions?▼

Yes, the proposal workflow supports multi-agent review and tracking from draft to final decision. It exports a collaboration-ready document that can be loaded into a shared SDLC workflow for formal stakeholder commit.

Can I use this to write a design proposal directly to disk for later commit?▼

Yes, you can write the structured design proposal directly to disk. The skill outputs the finalized stakeholder documentation to a designated draft location, enabling later review and formal commit within your SDLC.

When do I need a formal proposal document for a design decision?▼

You need a formal proposal document when facing large or ambiguous design decisions requiring stakeholder alignment. It frames the problem and available options so teams can agree on a committed path before implementation work begins.

What limitations exist when formalizing stakeholder documentation for the SDLC?▼

The skill focuses on producing structured draft proposals for design decisions but requires explicit inputs to frame the debatable proposal statement. It outputs to a draft location for review rather than finalizing the commit automatically.