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.