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-format-and-templates.md

View on GitHub
# Architecture Decision Records — Format and Templates

Lightweight templates for documenting architecture decisions. Store in `docs/adr/` in your project.

Companion to `adr-service-extraction-and-example.md` (service extraction template, worked example).

---

## ADR Format

```markdown
# ADR-NNN: [Short Decision Title]

**Status:** Proposed | Accepted | Deprecated | Superseded by ADR-XXX
**Date:** YYYY-MM-DD
**Deciders:** [who was involved]

## Context
What is the problem? Why are we making this decision now?
What forces are at play (technical, business, team)?

## Decision
What did we choose? State it clearly in one sentence, then elaborate.

## Alternatives Considered

### Option A: [Name]
- Pros: ...
- Cons: ...
- Why rejected: ...

## Consequences
- Positive: What gets better?
- Negative: What gets worse or harder?
- Risks: What could go wrong?

## Follow-up Actions
- [ ] Action items resulting from this decision
```

Rules: number sequentially (ADR-001, ADR-002, ...); never delete — mark as `Deprecated` or `Superseded by ADR-XXX`; keep short (1-2 pages); write ADRs for decisions, not implementations.

**When to write:** choosing between 2+ technologies; changing an established pattern; adding infrastructure; making an irreversible or expensive-to-reverse decision; decision affects multiple teams.

**Don't write for:** obvious choices, minor refactoring, bug fixes, style preferences.

ADR lifecycle: `Proposed → Accepted → [lives forever] → Deprecated | Superseded by ADR-XXX`

---

## Template: Database Choice

```markdown
# ADR-NNN: Database Selection for [Feature/Service]

## Context
[Describe data requirements: volume, access patterns, consistency needs, team familiarity]

## Decision
Use [PostgreSQL / MongoDB / Redis / etc.] as the primary datastore for [scope].

## Evaluation Criteria
| Criteria | Weight | Option A | Option B |
|---|---|---|---|
| Team familiarity | High | ... | ... |
| Query flexibility | Medium | ... | ... |
| Operational cost | High | ... | ... |

## Alternatives Considered
### PostgreSQL
- Pros: ACID, mature ecosystem, pgvector/PostGIS, team knows SQL
### MongoDB
- Pros: Flexible schema, easy horizontal scaling
- Cons: Eventual consistency by default, weaker joins

## Follow-up Actions
- [ ] Set up database infrastructure; define schema; configure connection pooling
```

---

## Template: Auth Strategy

```markdown
# ADR-NNN: Authentication and Authorization Strategy

## Context
[Who are the users? Internal/external? Mobile/web/API? Security requirements?]

## Decision
Use [JWT with refresh tokens / session cookies / OAuth2 + OIDC / API keys]
for authentication. Use [RBAC / ABAC / simple role check] for authorization.

## Alternatives Considered
### JWT with Refresh Tokens
- Pros: Stateless verification, works across services, mobile-friendly
- Cons: Can't revoke individual tokens without a blocklist
### Session Cookies
- Pros: Simple, revocable, well-understood
- Cons: Requires session store (Redis), not ideal for mobile
### OAuth2 + External Provider
- Pros: Offload auth complexity, social login support
- Cons: Vendor dependency, more complex integration
```

---

## Template: Caching Layer

```markdown
# ADR-NNN: Caching Strategy for [Feature/System]

## Context
[What's slow? Read/write ratio? Current latency? Target latency? Freshness requirements?]

## Decision
Use [HTTP cache headers / in-memory cache / Redis] for [scope].
Cache TTL: [duration]. Invalidation strategy: [TTL / write-through / event-driven].

## Alternatives Considered
### No Cache (Optimize Queries) — Try this first
### In-Memory (ristretto) — < 100MB, single-instance
### Redis — > 100MB, multi-instance, need consistent cache
```

---

## Template: API Versioning

```markdown
# ADR-NNN: API Versioning Strategy

## Decision
Use URL path versioning (`/api/v1/`, `/api/v2/`) with minimum 3-month
deprecation notice for external consumers.

## Version Bumping Rules
| Change Type | Version Bump? |
|---|---|
| Add response field | No |
| Remove response field | Yes |
| Change field type | Yes |
| Change pagination format | Yes |
```

---

## See Also

- `adr-service-extraction-and-example.md` — service extraction template and worked PostgreSQL example
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