system-design

Classify projects and document architectural decisions using fixed ADR templates.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture decision-making is often inconsistent, undocumented, and hard to audit across projects; this framework standardizes context gathering, decision records, and pattern routing to ensure repeatable guidance.

Core Features & Use Cases

  • Context discovery for project classification and requirements gathering.
  • ADR-based trade-offs with fixed templates and a deterministic decision path.
  • Pattern selection and validation workflow to produce production-ready recommendations.

Quick Start

Provide a concise project context and let the framework generate a complete ADR-driven architecture plan.

Frequently Asked Questions about system-design

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

FAQPage Schema
How do I document architectural decisions for complex systems?

Document architectural decisions by applying a fixed ADR template to classify project context and validate trade-offs. This framework standardizes context discovery and decision records to ensure repeatable, auditable guidance across projects.

What is the best way to select architecture patterns for an enterprise application?

The best way to select architecture patterns is using a validation workflow that evaluates enterprise context against a 6-item checklist. This ensures pattern selection produces production-ready recommendations tailored to your specific scale.

How do I create an Architecture Decision Record for a SaaS project?

Create an ADR for a SaaS project by providing concise project context to trigger context discovery. The framework applies a deterministic decision path and fixed ADR format to generate trade-off documentation for SaaS environments.

Can I use a validation checklist to ensure my architecture decisions are production-ready?

Yes, you can use a 6-item validation checklist to ensure architecture decisions are production-ready. The framework applies this checklist during the pattern selection workflow to validate outputs across MVP, SaaS, and Enterprise contexts.

Why does my architecture decision-making process lack consistency across different projects?

Architecture decision-making lacks consistency when context gathering and documentation are not standardized. Applying a deterministic framework with fixed ADR templates and pattern routing ensures repeatable guidance and eliminates undocumented decisions.

When should I not use a standardized ADR framework for system design?

You should avoid a standardized ADR framework when a project requires highly bespoke architectural decisions outside standard MVP, SaaS, or Enterprise contexts. The framework's deterministic decision path and fixed templates may not accommodate unconventional requirements.