ddd-endpoint-specialist

Generate REST API endpoints, DTOs, and OpenAPI docs for the mgamadeus/ddd framework.

3|Updated Feb 12, 2024
One-click install
npx skills add https://github.com/mgamadeus/ddd --skill ddd-endpoint-specialist
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ddd-endpoint-specialist
Source: https://github.com/mgamadeus/ddd/tree/main/.claude/skills/ddd-endpoint-specialist
Command: npx skills add https://github.com/mgamadeus/ddd --skill ddd-endpoint-specialist

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Standardize and accelerate the creation of REST API endpoints, DTOs, routing attributes, and OpenAPI documentation within the mgamadeus/ddd framework, reducing boilerplate and ensuring consistency.

Core Features & Use Cases

  • Scaffold and template-driven controllers and DTOs for Admin, Client, Public, and Batch audiences.
  • Enforce OpenAPI annotations, route attributes, and error handling conventions across endpoints.
  • Use when designing or modifying API endpoints, DTOs, or controller logic within a Symfony/DDD PHP project.

Quick Start

Create or update an API endpoint by following the DDD Endpoint Specialist templates to generate controllers, DTOs, route attributes, and OpenAPI documentation.

Frequently Asked Questions about ddd-endpoint-specialist

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

FAQPage Schema
How do I scaffold REST API endpoints and DTOs in a DDD PHP project?

To scaffold REST API endpoints and DTOs in a DDD PHP project, use template-driven code generation to automatically create controllers, request/response DTOs, and route attributes. This ensures consistent naming conventions and standardized error handling across your application.

How do I generate OpenAPI documentation for Symfony controllers?

Generate OpenAPI documentation for Symfony controllers by applying standardized OpenAPI annotations directly to your endpoint templates. This automated enforcement ensures your API routes and response schemas remain consistently documented across Admin, Client, Public, and Batch audiences.

Does this DDD endpoint scaffolding work with Admin, Client, Public, and Batch API audiences?

Yes, this DDD endpoint scaffolding supports Admin, Client, Public, and Batch API audiences. It applies template-driven code generation to generate standardized controllers, DTOs, and routing attributes tailored for each specific audience within your Symfony project.

What is the best way to standardize error handling and naming conventions across API endpoints?

The best way to standardize error handling and naming conventions across API endpoints is to implement template-driven code generation. This enforces consistent API structures, DTOs, and route attributes automatically, reducing boilerplate and ensuring long-term maintainability.

When do I need to regenerate request and response DTOs for my API?

You need to regenerate request and response DTOs for your API whenever you create or modify endpoint controller logic. Using template-driven scaffolding ensures the new DTOs align with established OpenAPI documentation and route attributes within the DDD framework.