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.