Symptom to answer. Start here when something is not behaving the way you expect.
Find the symptom, follow the link.
Work is not starting#
Work is failing#
Output is not what you wanted#
| 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 |
Repository and access#
| 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 |
Billing#
| 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 |
Still stuck#
Collect the task id, the status it is in, and the stage that failed before
contacting support. Those three facts resolve most questions immediately.