workflow-system-design

Guide step-by-step system design discussions and update spec.md after confirmations.

159|47|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/davidYichengWei/agentic-engineering-framework --skill workflow-system-design
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: workflow-system-design
Source: https://github.com/davidYichengWei/agentic-engineering-framework/tree/main/skills/workflow-system-design
Command: npx skills add https://github.com/davidYichengWei/agentic-engineering-framework --skill workflow-system-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

AI-assisted system design coordination when the spec.md has background, goals, and requirements but the design section is empty. The Skill guides a structured, Socratic dialogue to fill in design sections one by one, ensuring user confirmation before moving on.

Core Features & Use Cases

  • Structured, one-section-at-a-time design discussions driven by the user as the decision-maker, with AI conducting background research from the codebase when available.
  • On-demand loading of relevant norms and best practices, and automatic updates to spec.md after user confirmation.
  • Supports a strict 4.1 -> 4.2 -> 4.3 workflow with pre-conditions and validation to keep design scope tight.

Quick Start

Begin a design session by stating the target section and objectives, then let the AI ask clarifying questions and guide the discussion.

Frequently Asked Questions about workflow-system-design

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

FAQPage Schema
How do I start AI-assisted system design when my spec.md has requirements but no architecture?▼

AI-assisted system design begins by stating your target section and objectives to initiate a Socratic dialogue. The AI then conducts background research from the codebase and asks clarifying questions to guide the structured design process.

What is the structured workflow for filling out a software design specification?▼

The structured workflow follows a strict 4.1 -> 4.2 -> 4.3 staged process. This enforces step-by-step dialogue with pre-condition validation to keep the design scope tight, requiring user confirmation before advancing to the next section.

How does Socratic prompting work for software architecture planning?▼

Socratic prompting for software architecture planning uses iterative, one-section-at-a-time discussions where the AI asks clarifying questions. The user acts as the decision-maker, ensuring requirements are met before the AI automatically updates the spec.md file.

Can I load specific design norms and best practices on-demand during system design?▼

You can load specific design norms and best practices on-demand during the system design dialogue. This conditional loading ensures relevant architectural guidelines are applied contextually to each section being discussed.

Do I need existing requirements before starting AI-guided system design coordination?▼

You need existing background, goals, and requirements in your spec.md before starting. The AI-guided system design coordination specifically targets the empty design section, using your defined requirements to drive the Socratic discussion.