Commands Overview

Goca provides a comprehensive set of commands to generate Clean Architecture components and manage your project structure.

Command Categories

Project Initialization

• goca init - Initialize a new Clean Architecture project

Complete Features

• goca feature - Generate a complete feature with all layers
• goca integrate - Integrate existing features with DI and routing

Layer-Specific Generation

Domain Layer

• goca entity - Generate domain entities

Application Layer

• goca usecase - Generate use cases and DTOs
• goca interfaces - Generate interface contracts

Infrastructure Layer

• goca repository - Generate repositories

Adapter Layer

• goca handler - Generate handlers (HTTP, gRPC, CLI, etc.)
• goca middleware - Generate composable HTTP middleware package

Configuration & Templates

• goca config - Manage .goca.yaml configuration files
• goca template - Manage custom code generation templates

Utilities

• goca di - Generate dependency injection container
• goca messages - Generate error messages and constants
• goca mocks - Generate testify/mock mocks for all interfaces
• goca doctor - Check project health and Clean Architecture structure
• goca analyze - Deep self-analysis: architecture, security, quality, standards, tests, dependencies
• goca ci - Generate CI/CD pipeline configuration (GitHub Actions)
• goca mcp-server - Start MCP server for AI assistant integration (GitHub Copilot, Claude, Cursor)
• goca upgrade - Upgrade project configuration to current Goca version
• goca version - Display version information

Testing

• goca test-integration - Generate integration test scaffolding

Quick Reference

Command	Purpose	Auto-Integration
goca init	Create new project	Complete setup
goca feature	Generate full feature	Automatic
goca integrate	Wire existing features	Automatic
goca entity	Create entities only	Manual
goca usecase	Create use cases only	Manual
goca repository	Create repositories only	Manual
goca handler	Create handlers only	Manual
goca middleware	Generate HTTP middleware package	Manual
goca di	Generate DI container	Manual
goca interfaces	Generate interface contracts	Manual
goca messages	Generate error message constants	Manual
goca mocks	Generate testify/mock mocks	Manual
goca test-integration	Generate integration test files	Manual
goca config	Manage project configuration	—
goca template	Manage custom templates	—
goca ci	Generate CI/CD pipelines	—
goca mcp-server	MCP server for AI assistants	—
goca doctor	Project health checks	—
goca analyze	Deep project self-analysis	—
goca upgrade	Upgrade config/metadata	—

Common Workflows

Workflow 1: Quick Start (Recommended)

# Initialize project
goca init myproject --module github.com/user/myproject

# Generate complete features
goca feature User --fields "name:string,email:string"
goca feature Product --fields "name:string,price:float64"

# Everything is integrated automatically!
go run cmd/server/main.go

Workflow 2: Layer-by-Layer

# Generate entity
goca entity Order --fields "customer:string,total:float64"

# Generate use case
goca usecase OrderService --entity Order

# Generate repository
goca repository Order --database postgres

# Generate handler
goca handler Order --type http

# Wire everything together
goca integrate --all

Workflow 3: Add to Existing Project

# Generate new feature
goca feature Payment --fields "amount:float64,method:string"

# Automatically integrated with existing features

Global Flags

All commands support these flags:

--help, -h          Show help for command
--verbose, -v       Enable verbose output (includes debug details)
--quiet, -q         Suppress all output except errors and success messages
--dry-run           Show what would be generated without creating files
--no-color          Disable colored output
--no-interactive    Disable interactive prompts

Examples by Use Case

Building a REST API

goca init ecommerce-api --module github.com/user/ecommerce
cd ecommerce-api

goca feature Product --fields "name:string,price:float64,stock:int"
goca feature Order --fields "customer:string,total:float64,status:string"
goca feature User --fields "name:string,email:string,role:string"

Building a Microservice

goca init payment-service --module github.com/user/payment
cd payment-service

goca feature Payment --fields "amount:float64,currency:string,status:string"
goca handler Payment --type grpc
goca handler Payment --type http

Building a CLI Tool

goca init data-processor --module github.com/user/processor
cd data-processor

goca feature DataProcessor --fields "input:string,output:string"
goca handler DataProcessor --type cli

Next Steps

Choose a command to learn more:

Essential Commands

• goca init - Start here
• goca feature - Fastest way to add features
• goca integrate - Wire everything together

Detailed Generation

• 🟡 goca entity - Domain layer
• 🔴 goca usecase - Application layer
• 🔵 goca repository - Infrastructure layer
• 🟢 goca handler - Adapter layer

Utilities

• goca di - Dependency injection
• 📝 goca messages - Messages and constants
• goca version - Version info