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.