maestro: Skill for Claude Code

Backend API Patterns (TEMPLATE)

This is a TEMPLATE skill. Copy this directory and customize it for your backend framework.

Quick reference for backend development patterns. For detailed examples, see linked guides.

Skill Usage

Aspect	Details
Consumer	subagent-backend-architect
Purpose	Code patterns and examples for backend implementation
Invocation	Subagents read this skill; NOT directly invocable by users
How to Customize	Replace examples below with your framework's patterns

---

Step 1: Choose Your Framework

Replace this section with your framework-specific requirements:

Option A: Express.js (Node.js)

// Example: Express with TypeScript
import { Router, Request, Response } from 'express'

const router = Router()

router.get('/api/resource', async (req: Request, res: Response) => {
  try {
    const data = await service.getData()
    res.json(data)
  } catch (error) {
    res.status(500).json({ error: error.message })
  }
})

Option B: Django (Python)

# Example: Django REST Framework
from rest_framework import viewsets
from rest_framework.response import Response

class ResourceViewSet(viewsets.ViewSet):
    def list(self, request):
        data = service.get_data()
        serializer = ResourceSerializer(data, many=True)
        return Response(serializer.data)

Option C: Spring Boot (Java)

// Example: Spring Boot REST Controller
@RestController
@RequestMapping("/api/resource")
public class ResourceController {

    @Autowired
    private ResourceService service;

    @GetMapping
    public ResponseEntity<List<Resource>> getResources() {
        List<Resource> resources = service.getAll();
        return ResponseEntity.ok(resources);
    }
}

Option D: FastAPI (Python)

# Example: FastAPI with Pydantic
from fastapi import APIRouter, Depends
from pydantic import BaseModel

router = APIRouter()

class Resource(BaseModel):
    id: int
    name: str

@router.get("/api/resource", response_model=List[Resource])
async def get_resources(service: ResourceService = Depends()):
    return await service.get_all()