workbench-design-docs

name	workbench-design-docs
description	Product design, technical design documents, user-facing copy, specs, diagrams, and handoff documentation.

Workbench Design Docs

Use this skill for product design, technical design documents, user-facing copy, specs, diagrams, and handoff docs.

Design Standard

• Start from the actual user workflow, not a marketing page.
• Define the first usable screen, control surface, success state, error state, and handoff path.
• For internal tools, prefer dense, scannable, operational UI and docs.
• Keep language precise and action-oriented.
• Avoid feature claims that are not implemented or verified.

Documentation Standard

• Keep one canonical version whenever possible.
• Update durable docs when live behavior changes.
• Separate strategy, decisions, logs, issue templates, and automation specs.
• Include IDs, commands, schedules, and evidence only when they help future recovery.
• Do not include secrets or private credentials.
• Keep skills/README.md aligned with live skill IDs and agent attachment maps.
• For SDD work, keep stage artifacts scannable and avoid burying the actual artifact in discussion replies.

Output Contract

For product design:

• USER GOAL
• WORKFLOW
• SUCCESS CRITERIA
• NON-GOALS
• OPEN QUESTIONS

For docs:

• what changed,
• why it matters,
• where the canonical source now lives,
• what must be verified next.