// FlexPrice Go fmt, vet, race tests, make test. Trigger: godev, run tests, go vet.
Dev environment wizard โ hybrid by default: .env/.env.local creds for RDS, managed Kafka, etc.; Docker only for components the user says are local; idempotent Compose checks when applicable; **Local Compose:** always use localhost creds (**ยงC1** in `.env.local`) before migrations, seeds, `go run`/run-local-*; **Effort โ model (**ยงM**):** classify S/M/L, use fast models for checklist work, escalate to **Claude Sonnet 4.x (e.g. 4.7 when offered)** / strongest reasoning tier for hybrid/RDS churn; **Parallelism (**ยงN**):** spawn **Cursor Task subagents** for independent probes or read-only investigate paths when it speeds **ยงF** convergence. Kafka: prompt before default-topic creation (**`make init-kafka`**). Modes api/consumer/temporal_worker/local. Trigger: devenv, local dev, run-local.
Master HTTP QA: chains devenv then interactive API key / X-Environment-ID then real curls. Shards suites to parallel workers. Trigger: apitest, api test, curl localhost, QA local API.
FlexPrice repo architecture โ docs/ layering, deps, hotspots, flows, Graphify. Say arch, repo architecture, FLEXPRICE structure, onboarding codebase.
FlexPrice Docker/Makefile shortcuts โ dev-setup, compose services, Kafka UI profile, logs. Deep env wizard is devenv. Trigger: compose, docker dev, dev-setup.
gh CLI for FlexPrice repos โ PRs, checks, issues. Trigger: gh, github pr.
Swagger + Speakeasy SDK/MCP pipeline (make swagger, sdk-all), api/custom merge. Trigger: openapi, swagger, sdk-all, MCP.
| name | godev |
| description | FlexPrice Go fmt, vet, race tests, make test. Trigger: godev, run tests, go vet. |
godev โ Go dev loopgo.mod and Makefile.make targets when they exist; fall back to raw go commands.gofmt -w .
go vet ./...
Focused test (preferred during iteration):
go test -v -race ./path/to/package -run TestSpecificName
Full suite:
make test
Other useful Makefile targets from project docs:
make test-verbosemake test-coveragego test -race ./internal/service -run TestNamegofmt -w on touched packages (or whole repo if unsure).go vet ./... or at minimum go vet on affected packages.go test -race for packages you edited plus immediate dependents.make generate-ent then tests + migrations workflow per AGENTS.md.verification-before-completion discipline).go test without -race on concurrency-sensitive packages (internal/kafka, internal/pubsub, services with goroutines).