skills.rest
nicholasgriffintn
nicholasgriffintnCOMMUNITY
Explore all skills by this author →
Website𝕏@ngriffin_ukGitHub

backend-design

Plan backend systems, APIs, and data models with structured architecture decisions.

2|1|Updated Dec 19, 2022
Search Tags:#design#architecture#backend#observability#reliability#APIs#data-modeling
One-click install
npx skills add https://github.com/nicholasgriffintn/machine-setup --skill backend-design-nicholasgriffintn
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: backend-design
Source: https://github.com/nicholasgriffintn/machine-setup/tree/main/ai-tooling/skills/backend-design
Command: npx skills add https://github.com/nicholasgriffintn/machine-setup --skill backend-design-nicholasgriffintn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Designing scalable, reliable backends and APIs is challenging without a clear blueprint. This skill provides a structured approach to architecture decisions, data modeling, API contracts, and deployment considerations.

Core Features & Use Cases

  • API contract design & versioning: Define stable interfaces that evolve safely.
  • Data modeling & invariants: Specify entities, relationships, lifecycle, and data integrity rules.
  • Reliability, security & observability: Outline error handling, authentication, authorization, auditing, metrics, and tracing.
  • Use Case: Design a shopping-cart microservice with well-defined API surfaces and a scalable data model.

Quick Start

Request a complete backend design brief for a new service, including endpoints, data models, and non-functional requirements.

Frequently Asked Questions about backend-design

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

FAQPage Schema
How do I design a backend system with clear API contracts and data models?▼

To design a backend system, you need a structured approach that defines API endpoints, data invariants, service boundaries, and failure modes. This ensures your interfaces evolve safely while maintaining data integrity rules.

What is the best way to plan API contract design and versioning for a new service?▼

The best way to plan API contract design is to define stable interfaces, specify endpoints, and outline failure modes upfront. This approach ensures your API surfaces evolve safely without breaking existing consumers.

How do I structure data modeling and invariants for a scalable backend?▼

Structuring data modeling requires specifying entities, relationships, and data lifecycle rules. Enforcing strict data invariants ensures your backend maintains integrity and handles relationships reliably as it scales.

How do I include observability and security when planning backend architecture?▼

Including observability and security in backend architecture involves outlining error handling, authentication, authorization, auditing, metrics, and tracing. This provides a complete blueprint for system reliability and operational visibility.

Can I use this approach to design a microservice with well-defined service boundaries?▼

Yes, you can use this approach to design a microservice by defining clear service boundaries, API surfaces, and a scalable data model. It applies directly to scenarios like deployment considerations and API contract design.

What non-functional requirements do I need to consider for backend reliability?▼

For backend reliability, you must consider performance, security, failure modes, and data invariants. Addressing these non-functional requirements during architecture planning prevents operational issues and ensures system stability.

Related Skills

Explore More Software Engineering Skills→
hilaryosbornehilaryosborne

sa-planning

Facilitate strategic planning and high-level scoping for solution architecture initiatives.

Community
Basic
felvieirafelvieira
22

backend-api

Define API contracts and data models for Node.js backend applications.

Community
Advanced
sami-abdulsami-abdul
3

backend-code

Build REST or GraphQL endpoints with database operations and generate API_SUMMARY.md contracts.

Community
Advanced
arbazkhan971arbazkhan971
26

ddd

Model complex business domains into bounded contexts, aggregates, and event catalogs.

Community
Advanced