skills.rest
baristaze
baristazeCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

arch-scaffold-app

Scaffolds browser apps and Python CLIs with generated API clients, realtime channels, and deployment infrastructure.

89|10|Updated Sep 15, 2026
Search Tags:#typescript#React#openapi#scaffolding#WebSocket#Terraform#python cli
One-click install
npx skills add https://github.com/baristaze/swe_guidelines --skill arch-scaffold-app-baristaze
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: arch-scaffold-app
Source: https://github.com/baristaze/swe_guidelines/tree/main/skills/arch-scaffold-app
Command: npx skills add https://github.com/baristaze/swe_guidelines --skill arch-scaffold-app-baristaze

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a new client application that correctly follows a multi-tenant architecture guideline involves dozens of files: typed API clients, authentication flows, realtime socket handling, Terraform deployment modules, and CI workflows. This Skill generates the entire app skeleton in the prescribed shape so nothing is missed. ## Core Features & Use Cases - Browser App Scaffolding: Creates a portal or operator console with Vite, strict TypeScript, TanStack Query hooks, Zustand stores, an OpenAPI-generated typed client, and a single realtime WebSocket channel with replay-on-gap logic. - Python CLI Scaffolding: Builds a Typer-based CLI over REST with a generated httpx client, idempotency keys, bounded retries, and settings read once via BaseSettings. - Deployment Included: Writes Terraform static-site modules (S3, CloudFront, CSP headers), staging/production deploy workflows, and Makefile targets so make check covers the app. - Use Case: After scaffolding a service, run this Skill with customer-portal --kind portal to get a complete browser app wired to the service's OpenAPI contract, auth flow, and realtime stream. ## Quick Start Ask the assistant to scaffold a new client app named 'customer-portal' of kind portal against the existing service.

Frequently Asked Questions about arch-scaffold-app

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scaffold a new browser app from an OpenAPI spec?▼

Run the skill with an app name and --kind portal or admin. It copies the service's committed openapi.json, generates schema.d.ts via openapi-typescript, and creates the typed client, query hooks, stores, and screens in the prescribed structure.

How to build a Python CLI over a REST API with retries?▼

Use --kind cli to generate a Typer application importing the workspace's typed httpx client. The client owns the single bounded retry with backoff and jitter, sends Idempotency-Key on creating calls, and receives its base URL, credential, and timeout through its constructor.

What is the difference between portal and admin app kinds?▼

Portal is the product's browser app with the realtime WebSocket channel and tenant membership exchange. Admin is the operator console on its own origin with no socket, TOTP second-factor sign-in, and routes under /v1/admin/*, importing the portal's API client and design kit.

Does the scaffold include cloud deployment configuration?▼

Yes. Browser apps get a Terraform static-site module with a private S3 bucket, CloudFront distribution with origin access control, Content-Security-Policy headers, and staging/production GitHub workflows that build once and promote the bundle by commit.

How does the realtime WebSocket channel handle missed events?▼

The portal's RealtimeProvider tracks the last contiguous seq as a cursor. A head_seq above the cursor on hello or pong is treated as a gap, triggering replay from GET /v1/events?after_seq= rather than skipping events, and the same applies on reconnect.

When should I not use this scaffolding skill?▼

Skip it when the project does not follow the guideline's monorepo layout with pnpm or uv workspaces and committed OpenAPI contracts, since the generated structure, Makefile targets, and Terraform modules assume that exact tree and toolchain.

Related Skills

Explore More Software Engineering Skills→
SaintForeSaintFore

openapi-type-safe-sync

Generate TypeScript types and React Query hooks from openapi.json.

Community
Intermediate
kiranimmadi2kiranimmadi2

code-change-verification

Runs formatting, linting, type checking, and tests in parallel with fail-fast semantics.

Community
Advanced
MaShouoMaShouo

check-frontend

Identify frontend guideline violations in recent code changes and report fixes.

Community
Intermediate
simnovasimnova
18

apollo-client

Set up Apollo Client 4.x in React apps for GraphQL data and local state.

Official
Advanced