How does it handle re-design requests?

The skill checks project.yaml for a 'rejected' or 'conditional' status in the design review section and prioritizes addressing any 'open' issues found there.

What kind of diagrams does this skill generate?

It creates Mermaid sequence diagrams and state transition diagrams to visualize process flows, specifically comparing 'before' and 'after' states for clarity.

Can this skill help with testing?

Yes, it generates a complete test plan including unit, integration, and E2E test cases, and maps them to the project's original acceptance criteria.

Where are the design artifacts stored?

Detailed design documents are output to the docs/{target_repo}/design/ directory, and a summary is updated in the project.yaml design section.

What inputs does the design skill require?

It primarily uses project.yaml as a Single Source of Truth, referencing functional requirements, non-functional requirements, and previous investigation findings.

Structured System Design

Name: Structured System Design
Author: NagasakaH

byNagasakaH

0•

Productivity & Workflow

Generates comprehensive technical design documents, API specifications, and data structures based on project requirements and investigation results.

The Design skill automates the transition from research to implementation by generating detailed technical documentation within a structured development workflow. It consumes project metadata and prior investigation findings to produce standardized design artifacts, including implementation strategies, interface definitions, data models, and process flows. By utilizing a project.yaml file as the Single Source of Truth (SSOT), it ensures that all architectural decisions are documented, traceable, and ready for development, complete with automated test planning and side-effect verification to prevent regressions.

Key Features

01Comprehensive test strategy planning including Unit, Integration, and E2E cases

020 GitHub stars

03Detailed API, interface, and data structure design based on investigation findings

04Visual process flow modeling using Mermaid sequence and state diagrams

05Automated generation of implementation approaches and technical strategies

06Maintains project.yaml as a Single Source of Truth for the entire development lifecycle

Use Cases

01Converting business requirements and technical research into actionable implementation plans

02Standardizing technical documentation across a development team using a structured markdown format

03Iterating on system architecture by automatically addressing review feedback and rejected design statuses

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nagasakah/dev-process design

For use in Claude.ai and ChatGPT

Download Skill