aet-req-design

Transforms requirements analysis specifications into SDD-style system design documents.

7.1k|1.1k|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/openJiuwen-ai/jiuwenswarm --skill aet-req-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aet-req-design
Source: https://github.com/openJiuwen-ai/jiuwenswarm/tree/main/jiuwenswarm/agents/harness/code/rails/sdd/design_rail/skills/aet-req-design
Command: npx skills add https://github.com/openJiuwen-ai/jiuwenswarm --skill aet-req-design

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Turning a requirements analysis into an implementable system design is error-prone: modules get rewritten unnecessarily, interface contracts are retrofitted, and design decisions lose traceability to requirements. This Skill guides an AI agent through a disciplined four-stage pipeline that produces a Requirements Design Specification grounded in the actual codebase.

Core Features & Use Cases

  • Codebase-Grounded Design Exploration: Analyzes the existing project code and architecture before designing, with effort-tiered subagent exploration (Low/Medium/High).
  • Architecture & Interface Change Planning: Produces module add/modify/protect/freeze plans, Mermaid architecture change diagrams, and interface contracts with compatibility impact.
  • Template-Driven Document Generation: Assembles SDD-style design documents from modular components via Node.js scripts, with dynamic checklists for quality review.
  • Feasibility Verification & Review: Delegates red-team feasibility checks and deliverable reviews to subagents using dedicated checklists.
  • Use Case: After completing requirements analysis for a new feature, run this Skill to generate a design specification covering module changes, data models, interfaces, DFx strategy, and SR-AR decomposition, ready for development planning.

Quick Start

Use the aet-req-design skill to turn my requirements analysis specification into a system design document based on the current project codebase.

Frequently Asked Questions about aet-req-design

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

FAQPage Schema
How do I generate a system design document from requirements analysis?

Provide the requirements analysis specification and access to the project codebase as mandatory inputs. The skill runs a four-stage pipeline: codebase exploration, design with feasibility verification, template-based document generation, and an optional review stage, producing an SDD-style design specification.

What inputs are required for requirements design with this skill?

Two mandatory inputs are required: the requirements analysis specification from the previous phase and access to the current project codebase. Optional inputs include codebase analysis documents, reference projects, domain materials, and existing design references.

What does the generated design document contain?

The document includes design decisions, architecture change overviews with Mermaid diagrams, module change tables with frozen zones, feature impact mapping, core workflows, algorithm and data model design, interface contracts, and DFx strategy covering availability, performance, and security.

Does the design process verify feasibility before generating documents?

Yes, at High effort level a red-team feasibility verification is delegated to a subagent using a dedicated checklist covering facts, omissions, and practicality. Low and Medium effort levels skip this verification step.

Can I skip stages in the requirements design workflow?

Only the final review stage (A4) can be declined by the user. Stages A1 through A3 are strictly sequential, and the skill refuses to skip them because each stage depends on the completion of the previous one.

Why does template generation fail with missing file errors?

Generation requires running the assemble-template.mjs Node script with the req-design argument rather than reading template files directly. If workflow SOP files or template components are missing, the skill aborts and lists the files that must be provided.