system-design

Diagnose architectural problems and guide design decisions for solo developers.

Updated Jan 6, 2026
One-click install
npx skills add https://github.com/jwynia/teach --skill system-design-jwynia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: system-design
Source: https://github.com/jwynia/teach/tree/main/.claude/skills/system-design
Command: npx skills add https://github.com/jwynia/teach --skill system-design-jwynia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose design problems and guide architecture decisions for solo developers, helping translate validated requirements into practical designs without over-engineering.

Core Features & Use Cases

  • Diagnose design problems and guide architecture decisions for solo developers
  • Translate validated requirements into architecture decisions, component designs, and interface definitions
  • Produce artifacts like ADRs, component maps, and walking skeletons to support implementation and communication

Quick Start

Summarize validated requirements, identify constraints, and define a minimal end-to-end path to validate the architecture.

Frequently Asked Questions about system-design

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

FAQPage Schema
How do I translate validated requirements into architecture decisions for a solo project?

To translate validated requirements into architecture decisions, you summarize the requirements, identify constraints, and define a minimal end-to-end path to validate the design. This produces explicit tradeoffs across components, interfaces, and integration points.

What is a walking skeleton in system design and when do I need one?

A walking skeleton in system design is a minimal end-to-end implementation path that validates your core architecture. You need one to prove integration points and component interfaces work together before building out full features.

How do I write an Architecture Decision Record for component interfaces?

Writing an Architecture Decision Record for component interfaces involves documenting explicit design tradeoffs and constraints. You map validated requirements to specific component designs and interface definitions to ensure architectural clarity.

What is the best way to diagnose architectural problems without over-engineering?

The best way to diagnose architectural problems without over-engineering is to evaluate explicit design tradeoffs against clear requirements. Focusing on a minimal walking skeleton prevents unnecessary complexity while resolving integration bottlenecks.

Can I use system design documentation for a solo development workflow?

Yes, you can use system design documentation for a solo development workflow. It guides you from problem analysis to design docs and ADRs, ensuring architectural decisions are explicit and practical for individual developers.

When should I not use comprehensive architecture tradeoff analysis?

You should not use comprehensive architecture tradeoff analysis when project requirements are unclear or volatile. This approach applies to projects where requirements are already validated and design tradeoffs must be explicitly defined.