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/adr-service-extraction-and-example.md

View on GitHub
# Architecture Decision Records — Service Extraction Template and Worked Example

Companion to `adr-format-and-templates.md` (ADR format, when to write, database/auth templates).

---

## Template: Service Extraction

```markdown
# ADR-NNN: Extract [Feature] into Separate Service

## Context
[Why now? What pain in the monolith? Be specific: deploy coupling, scaling bottleneck, team contention]

## Decision
Extract [feature] into a standalone service communicating via [HTTP / gRPC / events].

## Extraction Checklist
- [ ] Feature has clear bounded context (few shared data dependencies)
- [ ] Team can independently deploy and operate the service
- [ ] CI/CD pipeline exists for the new service
- [ ] Monitoring and alerting configured
- [ ] Rollback plan defined
- [ ] Data migration plan (if splitting database)

## Boundary Definition
| Data/Entity | Stays in Monolith | Moves to New Service |
|---|---|---|
| Users | X | |
| Orders | | X |
| Payments | | X |
| Products | X | |

## Communication Pattern
| Interaction | Pattern | Why |
|---|---|---|
| Create order | Sync HTTP | Caller needs confirmation |
| Order shipped | Async event | Notification, non-blocking |
| Get user for order | Sync HTTP | Need data to process |

## Alternatives Considered
### Keep in Monolith + Modularize
- Pros: No distributed system complexity, shared transactions
- Cons: Doesn't solve [specific pain point]

### Extract as Library
- Pros: Code reuse without network boundary
- Cons: Still coupled deployment
```

---

## Worked Example: ADR-001 Use PostgreSQL as Primary Database

```markdown
# ADR-001: Use PostgreSQL as Primary Database

**Status:** Accepted
**Date:** 2026-01-15
**Deciders:** Backend team (3 engineers)

## Context

Building an e-commerce API for a B2B marketplace. Expected load: ~5K RPM initially,
growing to ~50K RPM in 12 months. Data includes products, orders, users, and inventory.
Team has strong SQL experience. Need full-text search for products and transactional
consistency for orders.

## Decision

Use PostgreSQL 16 as the sole database. Use built-in tsvector for full-text search.
Add Redis later only if measured latency exceeds targets.

## Alternatives Considered

### MongoDB
- Pros: Flexible product schemas, horizontal scaling
- Cons: Weaker transactions, no MongoDB experience, needs separate search solution
- Why rejected: Transaction safety for orders is critical. Product schema is actually
  structured. Team learning curve adds timeline risk.

### PostgreSQL + Elasticsearch
- Pros: Best-in-class search
- Cons: Two systems to maintain, data sync complexity
- Why rejected: PostgreSQL tsvector + GIN index handles requirements. ParadeDB is a
  drop-in upgrade without a separate system if needed.

## Consequences

### Positive
- Single database to operate, monitor, and backup
- ACID transactions for order processing
- Team productive immediately (familiar technology)
- Extension path: pgvector for recommendations, ParadeDB for advanced search

### Negative
- Horizontal scaling harder than MongoDB (not needed at 50K RPM)
- Schema changes require migrations (mitigated by golang-gin-psql-dba migration safety guide)

### Risks
- Unpredictable product schemas → mitigated by JSONB columns
- Full-text search outgrows tsvector → mitigated by ParadeDB upgrade path

## Follow-up Actions
- [x] Set up PostgreSQL 16 with Docker
- [x] Define initial schema
- [ ] Configure connection pooling
- [ ] Set up backup strategy
```

---

## ADR Index Template

`docs/adr/README.md`:

```markdown
# Architecture Decision Records

| # | Title | Status | Date |
|---|---|---|---|
| 001 | [Use PostgreSQL as Primary Database](001-use-postgresql.md) | Accepted | 2026-01-15 |
| 002 | [JWT with Refresh Tokens for Auth](002-jwt-auth.md) | Accepted | 2026-01-20 |
| 003 | [URL Path API Versioning](003-api-versioning.md) | Accepted | 2026-02-01 |
```

**Naming convention:** `NNN-short-slug.md` (e.g., `001-use-postgresql.md`)

Caching and versioning ADR templates: see **[adr-format-and-templates.md](adr-format-and-templates.md)**.
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