Skip to content

henriqueatila/golang-gin-best-practices / skills/golang-gin-architect

golang-gin-architect

Verified

Software architect for Go Gin APIs. Use when making architecture decisions, evaluating complexity, designing systems, choosing patterns, or coordinating across gin skills.

FileKindSize
SKILL.mdskill md10.7 KB
metadata.jsonconfig466 B
references/adr-format-and-templates.mdmarkdown4.1 KB
references/adr-service-extraction-and-example.mdmarkdown4.0 KB
references/api-design-error-contract-docs.mdmarkdown1.8 KB
references/api-design-filtering-bulk-evolution.mdmarkdown3.8 KB
references/api-design-versioning-pagination.mdmarkdown4.3 KB
references/clean-architecture-feature-module.mdmarkdown4.5 KB
references/clean-architecture-layers-di.mdmarkdown5.2 KB
references/complexity-assessment-budget.mdmarkdown5.6 KB
references/complexity-assessment-gates.mdmarkdown4.2 KB
references/complexity-assessment-patterns.mdmarkdown5.0 KB
references/cross-cutting-health-checks.mdmarkdown1.7 KB
references/cross-cutting-observability.mdmarkdown3.9 KB
references/cross-cutting-security-config.mdmarkdown4.4 KB
references/data-ownership-boundaries.mdmarkdown4.5 KB
references/data-ownership-sync-migration.mdmarkdown4.3 KB
references/data-patterns-cqrs.mdmarkdown3.8 KB
references/data-patterns-event-sourcing-aggregate.mdmarkdown2.2 KB
references/data-patterns-event-store.mdmarkdown3.7 KB
references/data-patterns-outbox.mdmarkdown3.7 KB
references/data-patterns-read-replicas.mdmarkdown2.6 KB
references/data-patterns-saga.mdmarkdown3.6 KB
references/error-flow-domain-layers.mdmarkdown5.3 KB
references/error-flow-handler-chain.mdmarkdown4.7 KB
references/golden-main-medium-project.mdmarkdown3.0 KB
references/golden-main-medium-startup.mdmarkdown2.8 KB
references/golden-main-small-project.mdmarkdown4.0 KB
references/grpc-interop-gateway-docker.mdmarkdown2.1 KB
references/grpc-interop-server-client.mdmarkdown2.7 KB
references/grpc-interop-setup.mdmarkdown3.6 KB
references/messaging-consumer-docker.mdmarkdown1.6 KB
references/messaging-consumer-workqueues.mdmarkdown3.6 KB
references/messaging-dlq-idempotency.mdmarkdown3.1 KB
references/messaging-dlq-setup.mdmarkdown2.4 KB
references/messaging-pubsub-exchanges.mdmarkdown3.6 KB
references/messaging-rabbitmq-connection.mdmarkdown3.2 KB
references/messaging-rabbitmq-producer.mdmarkdown2.4 KB
references/object-storage-download-presign.mdmarkdown3.5 KB
references/object-storage-multipart-minio.mdmarkdown2.2 KB
references/object-storage-setup-upload.mdmarkdown4.2 KB
references/redis-cache-warming-pubsub.mdmarkdown3.2 KB
references/redis-caching-patterns.mdmarkdown4.3 KB
references/redis-session-distributed-lock.mdmarkdown3.9 KB
references/resilience-circuit-breaker-bulkhead.mdmarkdown4.3 KB
references/resilience-retry-rate-limiting.mdmarkdown4.0 KB
references/skill-orchestration-overview.mdmarkdown3.2 KB
references/skill-orchestration-workflows.mdmarkdown5.4 KB
references/system-design-bounded-contexts.mdmarkdown4.1 KB
references/system-design-c4-model.mdmarkdown4.6 KB
references/system-design-dependency-graphs.mdmarkdown2.6 KB
references/system-design-domain-modeling.mdmarkdown3.5 KB
references/system-design-project-structure.mdmarkdown4.2 KB
references/tech-debt-identification-prioritization.mdmarkdown5.1 KB
references/tech-debt-refactoring-communication.mdmarkdown4.0 KB

references/messaging-dlq-setup.md

View on GitHub
# Messaging — Dead Letter Queues

How to handle message failures safely with DLQ. Companion to `messaging-dlq-idempotency.md` (idempotent consumers).

---

## Gate

Add DLQ when message loss on failure is unacceptable. Without DLQ, rejected messages vanish.

**Cost: MEDIUM** — requires separate DLX, DLQ, and a monitoring consumer.

---

## Declare DLX and DLQ

```go
// pkg/messaging/dlq.go
package messaging

import (
	"fmt"
	amqp "github.com/rabbitmq/amqp091-go"
)

// SetupDLQ declares dead letter exchange + queue and binds them.
// Call this before declaring the primary queue that uses DLX.
func SetupDLQ(ch *amqp.Channel, dlxName, dlqName string) error {
	if err := ch.ExchangeDeclare(dlxName, "direct", true, false, false, false, nil); err != nil {
		return fmt.Errorf("SetupDLQ exchange %q: %w", dlxName, err)
	}
	dlq, err := ch.QueueDeclare(dlqName, true, false, false, false, nil)
	if err != nil {
		return fmt.Errorf("SetupDLQ queue %q: %w", dlqName, err)
	}
	if err := ch.QueueBind(dlq.Name, "", dlxName, false, nil); err != nil {
		return fmt.Errorf("SetupDLQ bind: %w", err)
	}
	return nil
}
```

---

## Primary Queue Using DLX

```go
// In consumer setup:
if err := messaging.SetupDLQ(ch, "dlx.email", "dlq.email"); err != nil {
    return fmt.Errorf("setup dlq: %w", err)
}

q, err := messaging.DeclareQueue(ch, messaging.QueueOpts{
    Name:    "email.send",
    Durable: true,
    DLX:     "dlx.email", // failed messages go here
})
```

---

## DLQ Monitor Consumer

```go
// internal/worker/dlq_monitor.go
package worker

import (
	"context"
	"log/slog"

	amqp "github.com/rabbitmq/amqp091-go"
	"yourmodule/pkg/messaging"
)

type DLQMonitor struct {
	conn    *messaging.Connection
	alerter Alerter // PagerDuty, Slack, etc.
	logger  *slog.Logger
}

func (m *DLQMonitor) Run(ctx context.Context, dlqName string) error {
	ch, _ := m.conn.Channel()
	defer ch.Close()

	q, _ := messaging.DeclareQueue(ch, messaging.QueueOpts{Name: dlqName, Durable: true})
	deliveries, _ := ch.Consume(q.Name, "", false, false, false, false, nil)

	for {
		select {
		case <-ctx.Done():
			return nil
		case d, ok := <-deliveries:
			if !ok {
				return nil
			}
			m.logger.ErrorContext(ctx, "dead letter received",
				"message_id", d.MessageId,
				"routing_key", d.RoutingKey,
				"body", string(d.Body),
			)
			m.alerter.Alert(ctx, "dead letter: "+d.RoutingKey, d.Body)
			_ = d.Ack(false) // ack to remove from DLQ after alerting
		}
	}
}
```
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 323kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall