design

Clarify requirements, design architecture through adversarial discussion, and guide implementation with tests and commits.

Updated Jul 5, 2025
One-click install
npx skills add https://github.com/sqfzy/my_configs --skill design-sqfzy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design
Source: https://github.com/sqfzy/my_configs/tree/main/claude/skills/design
Command: npx skills add https://github.com/sqfzy/my_configs --skill design-sqfzy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides an end-to-end workflow to clarify requirements, architect features through structured adversarial discussion, implement with tests, verify outcomes, and manage commits within a repeatable process.

Core Features & Use Cases

  • Requirement clarification and phase-gated design for new features.
  • Adversarial discussion workflows (default mode with 3 roles and 2 rounds; deep mode with multi-role debate) that surface trade-offs and converge on a concrete design.
  • Automatic design documentation generation and artifact storage when design milestones are triggered (e.g., new feature, new module, or initial discussion).
  • Phase-based workflow guidance, including automatic mode inference, and explicit project glossary and acceptance criteria generation.

Quick Start

Describe a feature and initiate the default end-to-end design workflow (3 roles, 2 rounds) to generate and save a design report.

Frequently Asked Questions about design

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

FAQPage Schema
How do I design software architecture through adversarial discussion?

Adversarial architecture design uses structured multi-role debate to surface trade-offs and converge on concrete features. You initiate a workflow with 3 roles across 2 rounds, or use deep mode for multi-role debates, to automatically generate actionable design documentation.

What is phase-gated feature design and how does it clarify requirements?

Phase-gated feature design structures end-to-end implementation into distinct milestones. It clarifies requirements upfront, generates a project glossary, and establishes explicit acceptance criteria before guiding implementation with tests and commits.

How do I generate design documentation and artifacts for a new module?

To generate design documentation, describe a new feature or module to trigger the design milestone. The workflow automatically infers the mode, creates artifact storage, and outputs a structured design report containing the project glossary and acceptance criteria.

Can I use a multi-role debate workflow for complex feature requirements?

Yes, you can use deep mode for complex feature requirements. Deep mode initiates a multi-role debate that challenges architecture decisions more rigorously than the default 3-role, 2-round mode, ensuring thorough evaluation of edge cases before finalizing the design.

Does the design workflow support automatic test generation and commit management?

Yes, the workflow supports test generation and commit management. After clarifying requirements and finalizing the architecture through adversarial review, it guides the implementation phase by integrating tests and managing commits within the repeatable process.