All authors

Claude Skills by reliant-labs
github.com/reliant-labs258 skills0 installs195 views
- Openbao PublicPublishing forge.OpenBao on a Gateway so clusters elsewhere can read from it — the listener and certificate forge adds, the three paths the route allows (everything else is a 404), the re-encrypt and what verifies it, the limits and their scope, how X-Forwarded-For reaches the audit log, and each refusal with its escape. Use when you declare OpenBao.public, debug a remote SecretStore that is NotReady or a 404/403/503 on the public host, or review what the internet can reach.Votes: 0GitHub stars: 10
- OpenbaoRunning a self-run secret store with forge.OpenBao — what the component renders, how its clients authenticate (JWT only), the ordering of an ADOPTION of a live store (ship every consumer's JWT flip in the same release), the HA node spread, and the failure windows each step costs. Use when you declare Bundle.openbao, when you replace a hand-run OpenBao with the component, when you plan a rollout that moves a store's clients, or when two store pods land on one node.Votes: 0GitHub stars: 10
- OverridesChange one field of a forge-rendered object without forking the template — Bundle.overrides, keyed by Kind/name, applied at render, conflicts fail the render.Votes: 0GitHub stars: 10
- PdbPodDisruptionBudgets — the pdb-blocks-drain lint and render warning for a PDB that can never allow a disruption, and the pruning of stale forge-labelled PDBs when a workload drops to one replica.Votes: 0GitHub stars: 10
- PlanReading the deploy plan `forge env deploy` prints and `--approve` binds — what it diffs against (the last succeeded apply, recorded by env and bundle digest), who computes it (the control plane or forge), object added/removed/changed with field paths, secret presence read from the cluster, and what `no recorded config to compare against` means.Votes: 0GitHub stars: 10
- Pod PrioritypriorityClassName on a workload — when pods share nodes with ranked pods, an unranked pod is priority 0 and gets preempted, and a rollout's surge pod can stall in FailedScheduling. Apply the PriorityClass to the cluster first.Votes: 0GitHub stars: 10
- Polyrepoforge across several repositories, in any language — (a) each repo its own forge project sharing an envs/infra repo's KCL by git pin (`[forge_projects] x = { repo, ref, commit }`, no go.mod), or (b) one deploy repo building N app repos' images (`DockerBuild.context = forge.GitSource`). Pins, the shared source cache, the local override file, offline renders, the provenance a release records, and what each step costs.Votes: 0GitHub stars: 10
- PreviewPer-PR and per-branch preview environments — `forge env preview create|delete|name` and `forge env gc`. The committed template env they copy, how an instance is named, its TTL and who deletes it when it expires (the control plane for a hosted preview, `forge env gc` for a cluster you operate), the namespace-per-preview convention, and the GitHub Actions recipe that creates, deploys, comments the URL and deletes on close.Votes: 0GitHub stars: 10
- RecordRecord deploys your OWN CI does — one `forge release record` step after the existing deploy job, in any repo and any language, no deploy/kcl, forge builds and applies nothing. Monitoring then gets deploy markers (`forge obs changes`), per-release verdicts (`forge obs check --wait`) and a Releases page labelled "recorded by CI". Copy-paste recipes for GitHub Actions (step and vendored composite action), GitLab CI and Buildkite. Use when a team keeps its pipeline and wants forge's release track...Votes: 0GitHub stars: 10
- ReleaseWhat `forge env deploy <env>` does end to end — the two forms (ship this checkout vs deploy a named release), the confirm gate and exit 5, what the plan diffs against, scoped deploys, where releases are recorded (control plane vs machine ledger, FORGE_LEDGER=machine), the live preflight, pre-rollout migrations, and verify + recover by rolling forward (no rollback).Votes: 0GitHub stars: 10
- Rollback FloorRollback floors — "never deploy anything older than X to this env". `forge env floor show|set|lower|clear|lift`, `forge env deploy <env> <v> --floor "<why>"`, and the declared floors a promote raises from a forge:breaks-rollback migration or a deploy/rollback-floors/<id>.yaml declaration. Use when a deploy is refused with below_rollback_floor (exit 1), to make an env roll-forward-only, or to declare that an API, feature or data change cannot be rolled back past.Votes: 0GitHub stars: 10
- RoutesRoutes and their backends — a route targets a `service` or a `workload` (resolved per env to its Service or to the host process), port inference, and the typed per-route `traffic` policy (retries, request timeout, active health check with expected statuses, outlier detection) that replaced the dead `raw_policy`.Votes: 0GitHub stars: 10
- ShapeWhat an environment DECLARES, as a value — `forge env shape`, the projection it prints, why it never carries a secret value, and the declaration `forge env build` / `forge env deploy` record on the control plane so the console works with no daemon online.Votes: 0GitHub stars: 10
- Statefulset VolumesGrowing a StatefulSet's volume — raise the declared size and forge converges it (a pre-rollout resize Job grows the claims and orphan-recreates the StatefulSet), under direct apply and under Flux. Refuses a shrink or any other volumeClaimTemplate change. Opt-out and image knobs.Votes: 0GitHub stars: 10
- Static SiteShip a landing page, marketing/docs site, SPA or PWA with Reliant Forge — no backend needed. When forge is the right call for one, `project new --kind site` (new or adopted), the static export, hosted static hosting (platform owns bucket + CDN; one hosted site per person free across their unplanned orgs, counted across envs) or your own bucket, custom domains, and the build-once → promote release flow.Votes: 0GitHub stars: 10
- DevLocal-cluster dev loop primitives — cluster lifecycle, status, logs, ingress URLs, host/cluster split. Compose with project-specific bash for sibling-repo deploys, helm bootstraps, and webhook listeners.Votes: 0GitHub stars: 10
- DiagramsDrawing architecture, flow, and relationship diagrams without coordinate drift — reach for the component library first, declare a shared coordinate space when hand-rolling SVG+DOM, and explore multiple layouts for fan-out/anywhere topologies before committing.Votes: 0GitHub stars: 10
- Forge LibrariesAdopt-or-port judgment for forge's Go and frontend libraries — forge/pkg and @reliantlabs/forge-web-runtime. Read this BEFORE porting a utility from an existing codebase — the equivalent may already exist. `forge project libraries <pkg>` prints any package's full signatures; never read forge's source to find one.Votes: 0GitHub stars: 10
- Frontend Api BriefFrontend API brief — the forge-specific facts to know at step 0 before writing pages against the generated Connect RPC clients, so you don't re-derive them from generated source. Enum member names, what List requests actually filter, FK ids vs display names, no aggregate RPCs, App Router Suspense, and component export shapes.Votes: 0GitHub stars: 10
- Frontend RuntimeThe forge frontend runtime, @reliantlabs/forge-web-runtime — the web twin of forge/pkg. Transport interceptor stack (error normalization, auth, brand, a client span per RPC with redacted failure forensics, W3C traceparent; React Query owns retries), app-shell providers (session, error boundary, toast host), the generic <Resource> data-table container, and browser telemetry (the HyperDX SDK: errors, console, network, traces — to ClickStack through a same-origin /_otel route).Votes: 0GitHub stars: 10
- ConfigPer-env values a forge frontend reads at runtime — config_gen.ts and window.__FORGE_CONFIG__ from <basePath>/config.js, which runtime_config keys a bundle accepts (config_schema_gen.json, did-you-mean on a typo), required and required_when keys, the mode selector, and a frontend whose code lives in another repo (FORGE_RUNTIME_CONFIG_FILE, forgeRuntimeConfig()).Votes: 0GitHub stars: 10
- ResourceThe forge-web-runtime <Resource> data-table container — the loading/error/empty/data ladder, debounced server-side filter and cursor pagination with useQueryResource and a generated list hook, its layout, sorting (sortKey / order_by) and row clicks.Votes: 0GitHub stars: 10
- ShellThe forge-web-runtime app shell — RuntimeShell wired once in providers.tsx (auth as a structural SessionAuth prop, toast subscribe/render), useSession(), RuntimeErrorBoundary, RuntimeToastHost, and RouteGuard as a render gate, not a security boundary.Votes: 0GitHub stars: 10
- TelemetryBrowser telemetry in forge frontends — the HyperDX SDK forge scaffolds and initialises (otel_gen.ts, SERVICE_NAME), the same-origin /_otel route and who forwards it, the env knobs, the cookieless analytics tiers (off < aggregate < identified < full; identified by default: nothing stored on the device, the signed-in user's opaque id on events; full only with mode full + grantAnalyticsConsent; optOutOfAnalytics; GPC/DNT caps at aggregate), automatic page views with referrer/utm/click_id, flag e...Votes: 0GitHub stars: 10
- TransportThe forge-web-runtime transport interceptor stack — buildRuntimeInterceptors (error-normalize → auth → brand → rpc span → traceparent; React Query owns retries), always-on W3C traceparent tracing, one client span per RPC with redacted failure forensics, and typed errors: ConnectClientError, the total .reason vocabulary, userMessage(err), normalizeError, never matching on message text.Votes: 0GitHub stars: 10
- Frontend TestingFrontend testing methodology for forge — what to test, what NOT to test, recipes for utilities/pages/stores, the mockTransport seam (with generated service defaults + mockService overrides), and anti-patterns to forbid.Votes: 0GitHub stars: 10
- Frontend WorkspacesOpt-in pnpm-workspaces layout for sharing TypeScript code across multiple frontends (web + mobile). When to use it, the resulting layout, how to add new shared packages, and the dev loop.Votes: 0GitHub stars: 10
- FrontendFrontends with or without a backend — Next.js static exports, Vite SPAs, Expo: the component library, Tailwind v4, build shapes, runtime config, visual verification, and generated Connect RPC hooks when there is an API.Votes: 0GitHub stars: 10
- AdoptGenerating into a frontend forge did not scaffold — an existing app moved under frontends/ or named by a KCL path. What forge writes and withholds, one writer per src/gen, hand-written barrels and case collisions, and the package.json "forge" block (routes, hooks, components_dir).Votes: 0GitHub stars: 10
- ComponentsThe base UI primitives every forge frontend ships under src/components/ui/ (button, input/label/form with FormField auto-binding, card, status/tag/mono, tabs, table, select, the toast stack), the other auto-installed components, the Badge and Modal aliases, and the owned higher-level components (status-badge, enum-select, entity-picker/entity-name, session_nav).Votes: 0GitHub stars: 10
- DesignVisual-design discipline for forge frontends — brief the work before building (never invent an aesthetic without user input), declare the design system before coding, lean on the component library, use restrained color/type systems, never hand-draw complex SVGs, and verify visually before declaring done.Votes: 0GitHub stars: 10
- VerifyVisual verification before declaring frontend work done — the screenshot/viewport checklist and the auditOverflow browser probe that finds escaped text, clipped cards, and horizontal scroll the diff never shows.Votes: 0GitHub stars: 10
- Mock ModeConnect RPC clients in a forge frontend and opt-in mock mode — the generated transport in src/lib/connect.ts, mock_api ("", "true", "hybrid") and the signed-in user each gives, the mock banner, where the mock pipeline lives (fixtures, service defaults, scenarios), dispatch order, generated defaults for every service (vendored ones too), and overriding an RPC with forge scaffold scenario + mockService/patch.Votes: 0GitHub stars: 10
- PagesCookbook — scaffold a CRUD page with React Query hooks + Zustand state + forge component library + Tailwind v4.Votes: 0GitHub stars: 10
- PatternsFrontend component patterns — composition, container/presentational split, effects discipline, typed boundaries, and keeping components focused.Votes: 0GitHub stars: 10
- Runtime ConfigWhere a forge frontend gets per-env values and backend URLs — config_gen.ts and <basePath>/config.js at runtime (never NEXT_PUBLIC_*/VITE_* for per-env values), typed config vs runtime_config, forge.WorkloadURL and who resolves it per env, a hosted site's hostname, and CORS_ORIGINS naming the site.Votes: 0GitHub stars: 10
- ScaffoldedThe systems forge scaffolds into every frontend for you to extend — native auth (useAuth), the typed event bus, the Zustand UI store, format-utils and admin-url — and the dev workflow: forge env up dev-serving each frontend on its KCL-declared PORT.Votes: 0GitHub stars: 10
- ServingHow a forge frontend is built and served — the three output shapes (static by default, standalone, server), static-exportable routes, how a static host resolves them, fenced build dirs, and mounting under a URL prefix with base_path and joinBasePath.Votes: 0GitHub stars: 10
- StateFrontend state management — choosing the right tool for each kind of state, ownership rules, and async handling in Forge frontends.Votes: 0GitHub stars: 10
- GreenfieldA Reliant Forge app with an API, from an empty directory to a deployed release — `forge project new` with every service named up front and the flags that matter, evolving the schema with migrations, where business logic goes, running it locally (`forge env up`), and shipping it to Reliant hosting.Votes: 0GitHub stars: 10
- InteractorUse-case orchestrators — a service whose Deps are other services. Deps are interfaces only, so the workflow unit-tests against generated mocks alone.Votes: 0GitHub stars: 10
- LlmUsing an LLM from a forge app's Go backend — the decision first (agentic or judgement work belongs in a Reliant workflow and keeps the app LLM-free; small inline classify, summarise or extract calls may use the gateway), then the call itself with the official anthropic-go and openai-go clients unmodified, model names, who pays, the errors (out of credit, budget, video routes), and tracing each call with pkg/observe/genai so the console's AI hub shows it. Declaring the gateway in KCL is deploy...Votes: 0GitHub stars: 10
- Migration CliMigrate a CLI / library project to forge — --kind cli, second binaries, when contract.go isn't worth it.Votes: 0GitHub stars: 10
- Migration ServiceMigrate a server-shaped project to forge — services, operators, workers, webhooks, packs, multi-binary cmd/, k8s manifests.Votes: 0GitHub stars: 10
- Migration UpgradeUpgrade a forge project to a newer forge binary version — version pinning in forge.yaml, the per-version migration skills, the supported upgrade window (N minors back), and the compatibility policy (semver at major 1; what a major owes you).Votes: 0GitHub stars: 10
- MigrationMigrate an existing project to forge — pre-flight, project shape, module path strategy, package porting order, common gotchas.Votes: 0GitHub stars: 10
- OwnershipTelling forge which parts of a repository are yours — one file (`forge project disown`, `--absent`), whole areas forge must never write (`scaffold.exclude` in forge.yaml), and the files a feature pinned off leaves behind (`forge generate`'s orphan report, `forge project prune --orphans`). Use when adopting forge in an existing repo, when forge writes somewhere it should not, or after switching a feature off.Votes: 0GitHub stars: 10
- V0.1.44Convert a Next.js frontend's generated CRUD routes from dynamic `/<slug>/[id]` pages to static `/<slug>/view?id=…` and `/<slug>/edit?id=…` pages, so `output: static` (the new scaffold default, and the only shape hosted static hosting serves) can build. Use when `next build` fails with "missing generateStaticParams()", or before binding a frontend to `forge.OnHosted {}`. Separately, keep the version-stamping code generators (protoc-gen-es, protoc-gen-go) out of `.github/dependabot.yml`, whose ...Votes: 0GitHub stars: 10
- V0.1.45Upgrade a project to forge v0.1.45. One section per change — (1) the typed `forge.Observability` declaration replaces the bare `_observability` toggle; (2) continuous profiles, on by default beside the local ClickStack (`profiles_port`, the `otel-profiles` collector); (3) `gen/go.mod` requiring the retired `github.com/reliant-labs/forge/pkg` module, which `forge generate` now rewrites (the root `go.mod` is yours to fix); (4) the gitignored `.npmrc` (`legacy-peer-deps`) that stops `npm install...Votes: 0GitHub stars: 10
- Control Plane SecretsUpgrade v0.1.45 environments from optional or hand-provisioned telemetry secrets to declared ControlPlaneSecret delivery.Votes: 0GitHub stars: 10