Troubleshooting index

Symptom to answer. Start here when something is not behaving the way you expect.

Find the symptom, follow the link.

Work is not starting

Symptom	Likely cause	Where to look
Task stuck in `PENDING`	All agent slots busy	Capacity and agent slots
Nothing starts at all	Agent-hour allowance exhausted	Limits and quotas
Lower-priority work never runs	Queue saturated by `P0` tasks	Task statuses

Symptom	Likely cause	Where to look
`FAILED` early in the run	Build or test command wrong for a clean workspace	Build and test configuration
Tests pass locally, fail in Coroid	Suite depends on a service or setup step	Build and test configuration
Task hits the run-time ceiling	Task too large	Tasks, plans, sprints and lanes
Repeated `NEEDS_HUMAN_REVIEW`	Under-specified work	Specifications
Stuck mid-run	Several causes	When a task gets stuck or fails

Symptom	Likely cause	Where to look
Solves the wrong problem	Acceptance criteria too loose	Specifications
Change is much larger than asked	No out-of-scope line	Specifications
Ignores your conventions	Missing project context	Project context
Plans are consistently weak	Work running under too small a profile	AI profiles
Passes every gate but is still wrong	Gates check properties, not intent	Quality gates

Symptom	Likely cause	Where to look
Repository missing from the list	App not granted that repo, or token scope too narrow	Connect your code
Connection worked, now does not	Token owner lost access, or token expired	Connect your code
Pull requests open against the wrong branch	Base branch misconfigured	Repository and branch settings

Symptom	Likely cause	Where to look
Model calls stopped	Credits exhausted	Model credits
Unexpected spend	Expensive profile on a high-volume agent	AI profiles
Cannot attribute cost	Use per-project reporting	Usage and reports

Collect the task id, the status it is in, and the stage that failed before contacting support. Those three facts resolve most questions immediately.