sw-design

Research codebases, design solutions, and challenge them adversarially to produce design artifacts.

9|1|Updated Feb 9, 2026
One-click install
npx skills add https://github.com/Obsidian-Owl/specwright --skill sw-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sw-design
Source: https://github.com/Obsidian-Owl/specwright/tree/main/skills/sw-design
Command: npx skills add https://github.com/Obsidian-Owl/specwright --skill sw-design

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps users design robust software solutions by researching the codebase, architecting a design, and challenging it adversarially to ensure quality and trust.

Core Features & Use Cases

  • Interactive Solution Architecture: Guides users through the process of designing software.
  • Codebase Research: Analyzes existing code to inform design decisions.
  • Adversarial Challenge: Critiques proposed designs to identify flaws and risks.
  • Artifact Generation: Produces key design documents like design.md, context.md, and optionally decisions.md, data-model.md, etc.
  • Use Case: When starting a new feature, use this Skill to explore the existing codebase, propose an architecture, and get feedback on potential issues before writing any code.

Quick Start

Use the sw-design skill to design a new user authentication module for the application.

Frequently Asked Questions about sw-design

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

FAQPage Schema
What is software solution architecture and when do I need to design it?

Software solution architecture involves researching your codebase and designing a structured solution before writing code. You need this process when starting a new feature to ensure your design aligns with existing project practices and avoids potential flaws.

How do I design software architecture by analyzing an existing codebase?

You design software architecture by interactively researching existing code to inform decisions, proposing an architecture, and generating design artifacts like design.md and context.md. This ensures your new features integrate smoothly with the current project state.

Why should I use adversarial testing for software design?

Adversarial testing critiques your proposed solution architecture to identify flaws and risks early. Challenging your design adversarially ensures quality and trust, producing robust design artifacts before you commit to writing implementation code.

Can I generate design documents like data models and context files for a new feature?

Yes, you can generate key design documents including design.md, context.md, and optionally decisions.md and data-model.md. These artifacts capture your software architecture and align it with your project configuration and existing state.

Does this solution design process work without external dependencies?

Yes, the solution design process works without external dependencies, relying instead on integrating directly with your project configurations and existing codebase state to guide the interactive architecture design and adversarial challenge workflow.