go-add-entity

Go Add Entity

Generate a complete CRUD vertical slice for a new entity in an existing GOB Go microservice. This creates 8-10 files following all project conventions.

Trigger Phrases

"add entity", "new entity", "nova entidade", "add CRUD", "adicionar recurso", "add resource"

Arguments

$ARGUMENTS should specify:

• Service name (e.g., gob-member-service) — required
• Entity name (e.g., ServiceGroup, Topic) — required, in PascalCase
• Fields/columns — list of fields with types (can be informal, will be normalized)
• Relations (optional) — foreign keys to other entities
• Features (optional) — e.g., "with soft delete", "with status enum", "with search"

Pre-Flight Reads

Before generating ANY code, read these files from the target service (in parallel):

1. go.mod — module path (e.g., github.com/gob/gob-process-service)
2. internal/factory/factory.go — existing repos, factory pattern in use
3. internal/repository/repository.go — existing interfaces, import paths
4. migrations/ (ls directory) — next migration number
5. cmd/api/main.go — wiring point, existing services/handlers, route groups
6. internal/dto/dto.go — existing shared types (ErrorResponse, Response, Pagination)
7. internal/domain/ (ls directory) — existing domain models for reference

Also determine:

• Schema name from service-to-schema mapping (see go-add-migration skill)
• Table name: plural snake_case of entity (e.g., ServiceGroup → service_groups)
• Next migration number: highest existing + 1, zero-padded to 3 digits

Files to Generate

1. Domain Model — internal/domain/{entity_snake}.go

package domain

import (
    "time"
    "github.com/google/uuid"
)

// {Entity} represents a {description}.
type {Entity} struct {
    ID          uuid.UUID  `json:"id" db:"id"`
    // ... fields with both json and db tags ...
    CreatedAt   time.Time  `json:"created_at" db:"created_at"`
    UpdatedAt   *time.Time `json:"updated_at,omitempty" db:"updated_at"`
}