design

Installation
SKILL.md

Design

A design proposal answers the questions in proposal.md. Use them while designing, as the questions to ask, and when presenting, as the shape of the proposal.

Levels

A proposal is written at one of two levels. Say which one you're asking for, or writing.

  • Sketch: enough to compare against alternatives and choose a shape. Open questions are fine. Use it when exploring alternatives: detail spent on a design that loses is wasted.
  • Detailed: enough to split into ready tickets without making new decisions, so each part could be built as written (see /ready-ticket). Every question is resolved or explicitly left to the builder. Use it for the design that's agreed and built.

A detailed design continues the chosen sketch; it doesn't start again.

Scale

Installs
22
GitHub Stars
1
First Seen
Nov 4, 2026