spex-design

Plan implementation from a behavioral spec into a testable design plan.

Updated Feb 12, 2026
One-click install
npx skills add https://github.com/dmayerdesign/spex --skill spex-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spex-design
Source: https://github.com/dmayerdesign/spex/tree/main/.claude/skills/spex-design
Command: npx skills add https://github.com/dmayerdesign/spex --skill spex-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Translating behavioral specifications into concrete, buildable design plans is often error-prone and slow. This skill provides a structured approach to bridge the gap between spec and implementation, enabling faster, more reliable design work.

Core Features & Use Cases

  • Extract entities, boundaries, and responsibilities from the spec to form a coherent component model.
  • Define interfaces, data flows, and a step-by-step build sequence that supports test-driven design.
  • Recommend technology choices, testing strategies, and traceability from scenarios to design artifacts.

Quick Start

Provide a behavioral spec and trigger the plan-building workflow to generate a buildable design outline.

Frequently Asked Questions about spex-design

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

FAQPage Schema
How do I translate a behavioral spec into a buildable design plan?

To translate a behavioral spec into a buildable design plan, you extract entities, boundaries, and responsibilities to form a coherent component model. This structured approach bridges the gap between specification and implementation, enabling faster and more reliable architecture design.

What is the best way to define component boundaries and data flows from a formal spec?

Defining component boundaries and data flows from a formal spec involves extracting entity models and interfaces to establish clear responsibilities. The process generates a concrete, testable design plan that maps data flows directly from the original behavioral scenarios.

How do I create a build sequence that supports test-driven design?

Creating a build sequence for test-driven design requires defining a step-by-step implementation plan derived from your behavioral spec. The sequence outlines technology choices and testing strategies while maintaining traceability from scenarios to design artifacts.

Do I need a formal behavioral spec before planning software architecture?

Yes, a formal behavioral spec is required before planning software architecture with this approach. The design plan generation applies only when a behavioral spec exists and you need entity models, interfaces, technology choices, and requirements traceability before coding.

How does requirements traceability work when generating a design plan from a spec?

Requirements traceability in design plan generation works by mapping behavioral scenarios directly to design artifacts like entity models and interfaces. This ensures every component and build step in the architecture remains verifiable against the original formal specification.

When should I not use spec-to-design planning for software implementation?

You should not use spec-to-design planning if you lack a formal behavioral specification or if your project does not require predefined entity models, component boundaries, and a structured build sequence before starting the coding phase.