backend-system-design

Generate a 12-section backend system-design RFC persisted as BACKEND_SYSTEM_DESIGN.md.

6|Updated Jul 10, 2026
One-click install
npx skills add https://github.com/Mozurok/fhorja.dev --skill backend-system-design-mozurok
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: backend-system-design
Source: https://github.com/Mozurok/fhorja.dev/tree/main/.claude/skills/backend-system-design
Command: npx skills add https://github.com/Mozurok/fhorja.dev --skill backend-system-design-mozurok

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Backend features often get coded before the architecture is decided, leading to rework, unreviewed trade-offs, and design decisions lost in chat history. This Skill produces a staff-grade, 12-section system-design RFC for a new service, endpoint, or backend feature and persists it as BACKEND_SYSTEM_DESIGN.md so the architecture is reviewable before any slicing or implementation. ## Core Features & Use Cases - 12-Section Design Document: Covers problem statement, requirements, architecture, data model, API contract, caching, scaling, reliability and SLOs, security, observability, rollout, and trade-offs. - Capability-Routed, Stack-Agnostic: Designs for the stack the task actually uses (monolith, service, queue worker, serverless) read from task memory, never assuming a database or framework. - Decision and Evidence Grounding: Respects locked decisions in DECISIONS.md, marks ungrounded external contracts, and refuses to assert scale or SLO numbers without a cited source. - Use Case: Before building a new API endpoint, run this Skill to produce a complete design RFC covering the data model, failure modes, and rollout plan, then hand off to implementation-plan for slicing. ## Quick Start Ask the AI to run backend-system-design for the active task to produce the 12-section architecture RFC before any code is written.

Frequently Asked Questions about backend-system-design

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

FAQPage Schema
How do I write a backend system design document before coding?▼

Run backend-system-design on the active task to produce a 12-section RFC covering problem, requirements, architecture, data model, API contract, caching, scaling, reliability, security, observability, rollout, and trade-offs. The document is persisted as BACKEND_SYSTEM_DESIGN.md for review before implementation.

What sections should a backend architecture RFC include?▼

This Skill produces 12 sections: problem statement, functional and non-functional requirements, high-level architecture, data model and storage, API contract, caching strategy, scaling and bottlenecks, reliability and SLOs, security, observability, rollout and migration, and trade-offs with rejected alternatives.

Does backend-system-design work with any tech stack?▼

Yes, it is capability-routed rather than stack-specific. It reads the actual stack from SOURCE_OF_TRUTH.md or DECISIONS.md and designs for monoliths, services, queue workers, or serverless functions without assuming a specific database or framework.

When should I not use backend-system-design?▼

Do not use it to slice an already-designed change (use implementation-plan), analyze blast radius (use impact-analysis), review an API contract in isolation (use api-contract-review), or design frontend surfaces. It also requires an active task folder created by task-init first.

How does the design handle unknown scale or performance numbers?▼

Unknown scale signals are marked explicitly rather than invented. Latency targets, SLOs, and cost figures must cite a measured baseline, published standard, or user-supplied target, or they are marked PROPOSED-pending-baseline.