| name | testing-workflows |
| description | Run, debug, and structure tests for this Go project (unit + integration), including generation prerequisites. Use when changing domain logic, repositories, HTTP handlers, or migrations. |
| license | MIT |
| compatibility | Requires bash, git, Go, and make. |
| metadata | [object Object] |
| allowed-tools | Bash(git:*) Bash(make:*) Bash(go:*) Read |
Tooling assumptions
- Use a terminal runner with bash and git available.
- Prefer
maketargets when available; fall back to direct CLI commands when needed.
Fast paths
- All tests (runs generation first):
make test
- Unit tests only:
make test-unit
- Integration tests only (HTTP server suite):
make test-integration
Debugging failures
- If you see compile errors for generated packages, run:
make generate
- Re-run the failing package with verbose output:
go test -v ./path/to/pkg
- If the failure is DB-related, confirm
DATABASE_URLis correct and migrations are applied (for integration setups).
What to cover when adding features
- Domain validation (table-driven tests).
- Repository behavior (in-memory SQLite tests).
- HTTP behavior (status codes + auth + schemas).