makinari-rol-backend

Automate backend API endpoints and webhooks with dual-mode test and prod parity.

1|Updated May 8, 2025
One-click install
npx skills add https://github.com/Uncodier/API --skill makinari-rol-backend
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: makinari-rol-backend
Source: https://github.com/Uncodier/API/tree/main/src/skills/makinari-rol-backend
Command: npx skills add https://github.com/Uncodier/API --skill makinari-rol-backend

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Backend teams need end-to-end API endpoints and webhook handlers that work in both test and production modes, with strict contract adherence and zero silent failures.

Core Features & Use Cases

  • Dual-mode API endpoints that switch behavior based on ?mode=test or ?mode=prod, with deterministic test responses and real prod execution.
  • Input validation, idempotency, structured logging, and environment/config discipline to enforce safety and auditability.
  • Webhook processing, API route scaffolding under src/app/api, and readiness for DB migrations per the contract.

Quick Start

Deploy and test the dual-mode backend by calling endpoints with ?mode=test to verify deterministic responses, then switch to ?mode=prod for real data.

Frequently Asked Questions about makinari-rol-backend

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

FAQPage Schema
How do I build backend API endpoints with dual-mode test and prod behavior?

Dual-mode backend APIs switch behavior based on the ?mode=test or ?mode=prod parameter, providing deterministic test responses and real prod execution. This enforces strict contract parity across both environments without silent failures.

How do I implement idempotency and input validation for webhook processing?

Webhook processing and API routes enforce idempotency, input validation, and structured logging to guarantee safety and auditability. Scaffolding routes under src/app/api ensures production-grade endpoints boot and return real data.

What is the best way to scaffold API routes in a Vercel Sandbox environment?

Scaffolding API routes under src/app/api in the Vercel Sandbox environment provides production-grade endpoints that boot and run. This approach applies to API contracts, DB migrations, and environment config discipline.

Does this dual-mode API approach work without mock data in test mode?

The dual-mode API approach provides deterministic, mock-free results in test mode while executing real data operations in prod mode. This satisfies requirements for strict contract adherence and zero silent failures across both modes.

How do I apply structured logging and DB migrations to dual-mode webhooks?

Structured logging and DB migrations apply to webhook processing by enforcing environment and config discipline. This readiness ensures production-grade endpoints maintain auditability across test and prod modes.

Why do my API endpoints fail silently when switching between test and prod environments?

Silent endpoint failures occur without strict dual-mode parity between test and prod. Applying input validation, idempotency, and structured logging enforces safety and auditability, eliminating zero silent failure scenarios.