insforge-debug

InsForge Debug

Diagnose problems in InsForge projects by combining the backend's observability primitives - logs, metrics, db-health, advisor, policies, metadata, error objects, deploy state, and AI assist. This skill provides:

- A reference per debug primitive (one observability surface each - under references/)

- Symptom Recipes (below) that name the primitive sequence for known reactive symptoms and proactive audits

Always use npx @insforge/cli - never install the CLI globally.

Fastest Path: AI-Assisted Triage

When the user gives a concrete description (error message, failing URL, HTTP status), hand it to the InsForge debug agent. Unlike the other primitives, this one returns suggestions, not just observations - verify the diagnosis against the primitives it cites before acting on it.

npx @insforge/cli diagnose --ai "<issue description>"

See references/ai-assisted.md for when to use this first vs when to skip, and how to verify the output.