# Go Backend

> Implements and modifies Go backend services for this project—gRPC handlers, services, domain logic, repositories, and Protocol Buffers. Use when building or changing backend APIs, business logic, domain entities, or repository layer. Use when this capability is needed.

- Skill: `tomevault-io/go-backend-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/go-backend-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/go-backend-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/go-backend-2

---


# Go Backend Skill

## When to use

- Building or changing backend APIs, gRPC endpoints, or REST Gateway surface
- Implementing or updating domain entities, value objects, or business logic
- Adding or changing handlers, services, or repository implementations
- Editing Protocol Buffers or generated gRPC/gateway code workflow
- Fixing backend bugs (follow TDD: failing test first, then fix)

For **migrations** (schema, up/down), use the `database-migrations` skill. For **testing** focus (TDD, mocks, integration), use the `testing` skill.

## References

| File | Purpose |
|------|---------|
| [.cursor/rules/project-context.mdc](.cursor/rules/project-context.mdc) | Project overview, ports, layout, tech stack |
| [.cursor/rules/architecture.mdc](.cursor/rules/architecture.mdc) | Layered architecture (Handler→Service→Domain→Repository), DDD, aggregates, repository pattern, error handling |
| [.cursor/rules/go-style-guide.mdc](.cursor/rules/go-style-guide.mdc) | Naming, context, structs, interfaces, domain/service/handler guidelines |
| [.cursor/rules/authentication-security.mdc](.cursor/rules/authentication-security.mdc) | JWT, Principal, `auth.GetPrincipal(ctx)`, password hashing, authorization patterns |
| [.cursor/rules/database-migrations.mdc](.cursor/rules/database-migrations.mdc) | Repository and SQL patterns, connection pooling; for migration files see `database-migrations` skill |
| [.cursor/rules/agent-behavior.mdc](.cursor/rules/agent-behavior.mdc) | TDD, docs, code review, common patterns (new entity, new endpoint) |

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/pedromsmoreira) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->

