rainbond-fullstack-troubleshooter

Diagnose and repair build, runtime, and access failures for existing Rainbond applications.

7|1|Updated May 13, 2026
One-click install
npx skills add https://github.com/goodrain/rainskills --skill rainbond-fullstack-troubleshooter-goodrain
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rainbond-fullstack-troubleshooter
Source: https://github.com/goodrain/rainskills/tree/main/rainbond-fullstack-troubleshooter
Command: npx skills add https://github.com/goodrain/rainskills --skill rainbond-fullstack-troubleshooter-goodrain

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? When a full-stack app already deployed on Rainbond fails to build, start, or serve requests, this Skill performs a bounded troubleshooting phase: it classifies the runtime state, finds the dominant blocker from events, build logs, and pod diagnostics, applies only the smallest low-risk platform-side repair, and verifies the result with fresh evidence. ## Core Features & Use Cases - Runtime State Classification: Maps live evidence to canonical states such as topology_building, runtime_unhealthy, runtime_healthy, capacity_blocked, or code_or_build_handoff_needed. - Evidence-Anchored Diagnosis: Reads component summaries, pod details, events, and build logs keyed by event_id to pinpoint blockers like missing dependencies, wrong connection values, env naming incompatibility, or ConfigMap mount failures. - Bounded Low-Risk Repair: Adds dependency edges, fixes provider connection envs, adjusts build envs, or restarts components, with a strict one-retry budget per blocker and explicit stop boundaries. - Use Case: A user says "why did the backend build fail" for an existing Rainbond app; the Skill reads component events and build logs, classifies the failure as source build failed, and hands off to code/build work instead of looping on platform edits. ## Quick Start Ask the agent to troubleshoot why the backend component of your existing Rainbond app failed to build, checking events and build logs first.

Frequently Asked Questions about rainbond-fullstack-troubleshooter

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

FAQPage Schema
How do I troubleshoot a failed build on Rainbond?

Read the component events first to capture the failing build event_id, then read the build log anchored to that event_id before checking runtime container logs. Classify the result as source build failed or external artifact unreachable and hand off to code/build work if a low-risk build-env fix does not apply.

How do I fix a Rainbond app that cannot connect to its database?

Check whether the api-to-db dependency edge exists, then verify provider connection envs and port aliases on the database component. Add the missing dependency or normalize provider connection envs so dependents receive the expected contract, then redeploy the api component and re-check logs.

When should I use this troubleshooter instead of a deployment skill?

Use it only for a bounded troubleshooting phase on an existing Rainbond app that already has topology but is stuck building or unhealthy. Generic current-project deployment requests should route to rainbond-app-assistant, and final delivery acceptance belongs to rainbond-delivery-verifier.

Why does my env change not take effect on a Rainbond component?

A mounted config-file volume such as config.yml, application.properties, or nginx.conf overrides runtime environment variables for the same key. Enumerate mounted config volumes from the component summary first and repair the file or remove the stale override instead of only editing env.

What are the limitations of Rainbond runtime troubleshooting?

It cannot modify source code, delete apps or components, reset databases, or restart Rainbond platform system components like rbd-api or rbd-gateway. Each blocker bucket allows at most one repair attempt per run, and capacity or code/build blockers stop the run with an explicit handoff.