forge
Clone forge-starter
plane: controlresource: Analysisrendered from forge v1.56.0 platform-model.json

explain-failure

Turn a failed Build, TestRun or CheckRun log into an Analysis with a next step.

ExplainFailurePOST /capabilities/explain-failure
Analysisthe Resource it produces
1 eventAnalysisCreated

Ask your agent forge → explain-failure

you
Why did that build fail?
claude
forge → explain-failure Done — Analysis created; I recorded AnalysisCreated.

From the terminal

$ forge explain --resource res_01J…

HTTP :3717

POST /capabilities/explain-failure
Content-Type: application/json
x-forge-actor-type: builder
x-forge-actor-id: cli

{
  "resource": "res_01J…"
}

Input fields 2

resource
log_path

Events ForgeEvent

AnalysisCreated   resource_type: Analysis

Resource GET /resources/Analysis/:id

{
  "type": "Analysis",
  "id": "res_01J…",
  "app_id": "app_hello",
  "status": "succeeded",
  "created_at": "2026-09-03T14:00:00Z"
}

Errors: see Reference → Errors. Find it in the playground