// Swagger + Speakeasy SDK/MCP pipeline (make swagger, sdk-all), api/custom merge. Trigger: openapi, swagger, sdk-all, MCP.
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.
FlexPrice Go fmt, vet, race tests, make test. Trigger: godev, run tests, go vet.
| name | openapi |
| description | Swagger + Speakeasy SDK/MCP pipeline (make swagger, sdk-all), api/custom merge. Trigger: openapi, swagger, sdk-all, MCP. |
openapi โ OpenAPI & SDKsinternal/api/**.docs/swagger/ (run generation โ do not hand-edit JSON as primary source).After route or Swagger annotation changes:
make swagger
make sdk-all
make sdk-all (per AGENTS.md) validates, generates SDKs/MCP, merges api/custom/**.
OpenAPI-only validation:
make speakeasy-validate
api/go, api/typescript, api/python, api/mcp.api/custom/<lang>/ and rely on make merge-custom (often part of sdk-all).Filtered spec and allowed tags live under .speakeasy/mcp/ โ changing exposed tools requires config update + regenerate flow documented in AGENTS.md.
sdk-allSmall internal-only HTTP tweak with no exported contract change: make swagger alone may suffice; coordinate with reviewers if public SDK repos are consumers.
api/tests if behavior is user-facing SDK contract.