backend-service-scaffolding

Scaffold backend services in the ValueOS monorepo with Zod validation and tenant isolation.

Updated Nov 17, 2025
One-click install
npx skills add https://github.com/Valynt/ValueOS --skill backend-service-scaffolding
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: backend-service-scaffolding
Source: https://github.com/Valynt/ValueOS/tree/main/.windsurf/skills/backend-service-scaffolding
Command: npx skills add https://github.com/Valynt/ValueOS --skill backend-service-scaffolding

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Scaffold new backend services in the ValueOS monorepo with tenant isolation, Zod validation, audit logging, and co-located tests.

Core Features & Use Cases

  • Standardizes service scaffolding under packages/backend/src/services and provides an entity-driven workflow.
  • Enforces tenant-aware queries, input validation via Zod, and audit logging for CRUD operations.
  • Provides templates and wiring patterns to accelerate onboarding of new domain services and ensure consistent exports.

Quick Start

Follow the standard entity scaffolding procedure in the monorepo to scaffold a new service.

Frequently Asked Questions about backend-service-scaffolding

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

FAQPage Schema
How do I scaffold a backend service with tenant isolation and Zod validation?

Scaffolding a backend service with tenant isolation and Zod validation generates service files under packages/backend/src/services, wires exports, and enforces tenant-aware queries to ensure a consistent project structure.

What is the best way to generate unit tests for CRUD operations in a backend monorepo?

Generating unit tests for CRUD operations in a backend monorepo uses automated templates that mock the Supabase client and validate tenant-context aware queries, ensuring robust and isolated test coverage for new domain services.

Does the backend service scaffolding workflow require a centralized logger for audit logging?

The backend service scaffolding workflow requires a centralized logger to enforce audit logging for CRUD operations, ensuring all tenant-context aware queries and data modifications are properly tracked.

Can I use this scaffolding workflow to add audit logging to existing CRUD operations?

This scaffolding workflow adds audit logging to CRUD operations by generating new service files with built-in audit logging capabilities, ensuring consistent project structure from the start rather than retrofitting existing services.

How do I enforce runtime validation with Zod when creating new domain services?

Enforcing runtime validation with Zod when creating new domain services is automated by the scaffolding workflow, which injects Zod validation directly into the generated service files for all input handling and CRUD operations.

Why do my scaffolded backend service tests need to mock the Supabase client?

Scaffolded backend service tests need to mock the Supabase client to validate tenant-context aware queries in isolation, preventing live database calls and maintaining consistent unit test behavior across entities.