create-microservice

Scaffold a microservice with Clean Architecture, Hexagonal ports, and DDD.

Updated Oct 27, 2025
One-click install
npx skills add https://github.com/mariotoffia/gobridge --skill create-microservice
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-microservice
Source: https://github.com/mariotoffia/gobridge/tree/main/.cursor/skills/create-microservice
Command: npx skills add https://github.com/mariotoffia/gobridge --skill create-microservice

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The skill scaffolds a production-ready microservice with Clean Architecture, Hexagonal ports, and DDD.

Core Features & Use Cases

  • Establishes a monorepo-style structure with multiple entry points (API, worker, event handlers).
  • Enforces domain-driven design, ports/adapters, and OpenAPI contracts for contract-driven development.
  • Includes infrastructure-as-code guidance and automated scaffolding steps to accelerate delivery across teams.
  • Use Case: A team can bootstrap a fully wired microservice from scratch, ready for deployment in a serverless environment.

Quick Start

Create the initial project structure for a new microservice named my-svc as described in the steps, then implement domain models and adapters according to the blueprint.

Frequently Asked Questions about create-microservice

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

FAQPage Schema
How do I scaffold a microservice with clean architecture and DDD?

To scaffold a microservice with clean architecture and DDD, this skill generates a production-ready project structure featuring hexagonal ports, domain-driven design layers, and dependency injection wiring to bootstrap your service from scratch.

What is hexagonal ports and adapters architecture for microservices?

Hexagonal ports and adapters architecture isolates a microservice's core domain logic from external concerns, enabling contract-driven development with OpenAPI and allowing multiple entry points like API, worker, and event handlers within a monorepo structure.

Can I use this scaffolding for a serverless microservice deployment?

Yes, this scaffolding targets serverless deployment patterns and includes infrastructure-as-code guidance, allowing you to bootstrap a fully wired microservice ready for deployment in a serverless environment.

Does the scaffold include an OpenAPI contract for contract-driven development?

Yes, the scaffold implements an OpenAPI contract as part of its standard setup, enforcing contract-driven development alongside domain-driven design and ports/adapters to accelerate delivery across teams.

What's the best way to structure a monorepo with multiple microservice entry points?

The best way to structure a monorepo with multiple entry points is to establish a project layout supporting API, worker, and event handlers, which this scaffold provides through automated scaffolding steps and dependency injection wiring.

When should I not use a hexagonal architecture scaffold for my microservice?

You should avoid using a hexagonal architecture scaffold if your project does not require multiple entry points, strict domain-driven design boundaries, or contract-driven OpenAPI development, as it enforces these structural patterns by default.