// FlexPrice Docker/Makefile shortcuts — dev-setup, compose services, Kafka UI profile, logs. Deep env wizard is devenv. Trigger: compose, docker dev, dev-setup.
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.
gh CLI for FlexPrice repos — PRs, checks, issues. Trigger: gh, github pr.
FlexPrice Go fmt, vet, race tests, make test. Trigger: godev, run tests, go vet.
Swagger + Speakeasy SDK/MCP pipeline (make swagger, sdk-all), api/custom merge. Trigger: openapi, swagger, sdk-all, MCP.
| name | compose |
| description | FlexPrice Docker/Makefile shortcuts — dev-setup, compose services, Kafka UI profile, logs. Deep env wizard is devenv. Trigger: compose, docker dev, dev-setup. |
compose — Docker dev shortcutsFor modes, .env*, Kafka topic quirks, migrations: use devenv.
make dev-setup
docker compose up -d postgres kafka clickhouse temporal temporal-ui
make up # start all services
make down # stop
make restart-flexprice # restart app services, not infra
docker compose --profile dev up -d kafka-ui
See AGENTS.md / CLAUDE.md tables (API 8080, Temporal UI 8088, Kafka UI 8084, ClickHouse 8123).
docker compose logs -f flexprice-api
docker compose logs -f flexprice-consumer
docker compose logs -f flexprice-worker
FLEXPRICE_* env vars or .env to compose services when troubleshooting connection refused errors.