What problem does it solve? Setting up a new web service in a multi-tenant Python monorepo involves dozens of files—app factory, container, gateway, routers, wire types, settings, Dockerfile, Terraform modules, CI workflows—and each must follow strict architectural conventions. This Skill generates the entire service skeleton in the prescribed shape so nothing is missed. ## Core Features & Use Cases - Full service scaffolding: Creates the distribution, settings, app container, app factory with fixed middleware order, console entry point (serve, migrate, bootstrap, grant-operator, openapi), Docker image, and tests under services/<service-name>/. - Gateway and routing layer: Writes credential parsing, operator gate, error handlers, rate limiting, edge idempotency, request-id middleware, routers, wire types, and service interfaces with in-process impls—written once and shared via a root gateway/ distribution on later services. - Optional realtime and app-specific modes: --realtime adds the websocket channel (tickets, send buffer, typed envelopes, replay route); --app builds an app-specific service composing domain operations; --container adds the service to the full compose file. - Use Case: After scaffolding namespaces for a new product, run this Skill to create the first API process hosting every namespace, complete with health/readiness probes, OpenAPI emission via make openapi, Terraform service modules per environment, and deploy workflow entries. ## Quick Start Ask the AI to run the arch-scaffold-service skill with a service name such as "api" to scaffold the complete FastAPI service with gateway, routers, and tests.
