# Go Development

> Go development workflow including verification commands and self-review checklist. Use when modifying Go code in internal/, pkg/, or cmd/ directories.

- Skill: `hiromaily/go-development` (Agent Skill)
- Install (CLI): `npx skillmds@latest add hiromaily/go-development`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hiromaily/go-development/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: hiromaily (https://skillmd.com/u/hiromaily)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hiromaily/go-development

---


# Go Development Workflow

Workflow for Go code changes in this repository.

## Prerequisites

- **Use `git-workflow` Skill** for branch management, commit conventions, and PR creation.
- **Refer to `.claude/rules/go.md`** for detailed verification commands and coding rules (SSOT).

## Applicable Directories

| Directory   | Description                                |
| ----------- | ------------------------------------------ |
| `internal/` | Core application code (Clean Architecture) |
| `pkg/`      | Reusable shared packages                   |
| `cmd/`      | Application entry points                   |

## Workflow

### 1. Make Changes

Edit Go files following the rules in `.claude/rules/go.md`.

### 2. Verify (from rules/go.md)

```bash
make go-lint && make tidy && make check-build && make go-test
```

### 3. Self-Review Checklist

- [ ] Domain layer has ZERO infrastructure dependencies
- [ ] Error handling uses `fmt.Errorf("context: %w", err)`
- [ ] No private keys or sensitive data logged
- [ ] Auto-generated files not edited

## Database Changes

If modifying database schema, use `db-migration` skill.

## Related

- `.claude/rules/go.md` - Go rules (SSOT)
- `git-workflow` - Branch, commit, PR workflow
- `db-migration` - Database schema workflow