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/skill-orchestration-workflows.md

View on GitHub
# Skill Orchestration — Workflows, Composition, and Boundaries

Companion to `skill-orchestration-overview.md` (skill overview and decision matrix).

---

## Common Workflows

### New Feature (End-to-End)

```
1. golang-gin-architect  → Assess complexity, choose patterns
2. golang-gin-psql-dba   → Design schema, plan migration
3. golang-gin-database   → Implement repository + migration files
4. golang-gin-api        → Implement handler + service + routes
5. golang-gin-auth       → Add auth middleware (if protected)
6. golang-gin-testing    → Write unit + integration tests
7. golang-gin-deploy     → Update Docker/K8s configs (if needed)
```

**For simple CRUD (80% of cases), skip step 1** — go directly to schema → repository → handler → tests.

### Add Authentication to Existing App

```
1. golang-gin-auth       → JWT middleware, login/register handlers, RBAC
2. golang-gin-database   → User model, token store (if refresh tokens in DB)
3. golang-gin-psql-dba   → User table schema, indexes on email
4. golang-gin-api        → Wire auth middleware to route groups
5. golang-gin-testing    → Auth test helpers, protected route tests
```

### Performance Investigation

```
1. golang-gin-psql-dba   → EXPLAIN ANALYZE, index analysis, query optimization
2. golang-gin-architect  → Caching strategy, read replicas decision
3. golang-gin-database   → Optimize repository queries, connection pool tuning
4. golang-gin-testing    → Benchmark tests
5. golang-gin-deploy     → Horizontal scaling, resource limits
```

### Database Migration (Schema Change)

```
1. golang-gin-psql-dba   → Migration safety analysis (lock levels, zero-downtime)
2. golang-gin-database   → Write migration files (golang-migrate)
3. golang-gin-testing    → Test migration up/down
4. golang-gin-deploy     → Update deployment to run migration before app starts
```

### Greenfield Project Setup

```
1. golang-gin-architect  → Project structure, technology choices, ADRs
2. golang-gin-api        → Server setup, project layout, base middleware
3. golang-gin-database   → Database connection, initial schema
4. golang-gin-psql-dba   → Schema design, initial indexes
5. golang-gin-auth       → Auth setup (if needed from start)
6. golang-gin-testing    → Test infrastructure, CI integration
7. golang-gin-deploy     → Docker, docker-compose for local dev
```

---

## Skill Composition Patterns

### Pattern 1: Schema-First (Recommended)

```
golang-gin-psql-dba (schema) → golang-gin-database (repository) → golang-gin-api (handler) → golang-gin-testing
```

**Why:** Schema changes are the hardest to modify later. Get the data model right first.

### Pattern 2: API-First

```
golang-gin-api (contract/types) → golang-gin-database (repository) → golang-gin-psql-dba (schema)
```

**When:** External consumers need to see the contract before implementation. Use OpenAPI spec as starting point.

### Pattern 3: Test-First (TDD)

```
golang-gin-testing (test) → golang-gin-api (handler) → golang-gin-database (repository) → golang-gin-psql-dba (schema)
```

**When:** Requirements are clear and well-defined. Each test drives the next implementation layer.

---

## Skill Boundary Rules

### What Each Skill Should NOT Do

| Skill | Should NOT |
|---|---|
| golang-gin-api | Write SQL queries, design schemas, make auth decisions |
| golang-gin-auth | Design database schemas, set up deployment |
| golang-gin-database | Decide index types, analyze EXPLAIN plans, choose extensions |
| golang-gin-psql-dba | Write Go repository code, implement handlers |
| golang-gin-testing | Implement features, change production code |
| golang-gin-deploy | Make architecture decisions, change business logic |
| golang-gin-architect | Write implementation code (routes to specific skills instead) |

### Overlap Resolution

| Overlap Area | Owner | Other Skill's Role |
|---|---|---|
| Database connection setup | golang-gin-database | golang-gin-psql-dba advises pool sizing |
| Migration files | golang-gin-database | golang-gin-psql-dba reviews safety |
| Auth middleware | golang-gin-auth | golang-gin-api wires it to routes |
| Error handling | golang-gin-api | golang-gin-architect defines strategy |
| Docker health checks | golang-gin-deploy | golang-gin-api implements `/health` endpoint |
| Test infrastructure | golang-gin-testing | golang-gin-deploy sets up test DB in CI |

---

## Troubleshooting: Which Skill?

1. **Code or decisions?** — Code → specific skill; Decisions → golang-gin-architect
2. **HTTP or data?** — HTTP (routes, handlers) → golang-gin-api; Data → golang-gin-database or golang-gin-psql-dba
3. **Go code or PostgreSQL?** — Go code → golang-gin-database; PostgreSQL DDL/indexes → golang-gin-psql-dba
4. **Building or running?** — Building → api/database/auth; Running → golang-gin-deploy
5. **Verifying correctness?** — golang-gin-testing

### Common Misroutes

| User Says | Seems Like | Actually |
|---|---|---|
| "Add a database" | golang-gin-database | golang-gin-psql-dba (schema) THEN golang-gin-database (code) |
| "Make it faster" | golang-gin-architect | golang-gin-psql-dba first (90% of perf issues are DB) |
| "Add middleware" | golang-gin-api | golang-gin-auth if it's auth middleware |
| "Set up migrations" | golang-gin-psql-dba | golang-gin-database (tooling) + golang-gin-psql-dba (safety review) |
| "Scale the app" | golang-gin-deploy | golang-gin-architect first (is scaling the right answer?) |
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: 322kUpdated 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