Skip to main content

Troubleshooting

SymptomLikely CauseWhat To Do
/intake says an initiative cannot be foundWrong initiative ID or wrong Slack workspace/team.Run /intake status ENG-123 with the exact ID shown in Relay.
Relay asks for more contextQuality check found coverage gaps, conflicts, or weak source material.Add more Slack, email, or file context and rerun /intake generate ENG-123.
No discovery thread appears after approvalRelay does not know a Slack channel or Slack delivery failed.Approve from a Slack channel, configure a team, notification, or discovery channel, or check Slack installation.
/intake tasks is blockedThe latest document is not approved, discovery is not complete or manually closed, technical context is missing, or Linear is not connected.Complete the listed prerequisite and rerun the command.
GitHub repos do not appearGitHub is not installed, credentials cannot refresh, or the app lacks repository access.Reinstall or manage GitHub from Settings > Integrations.
GitHub index shows warningsRepo language, framework, or workspace shape is unsupported, or the index is stale.Review the warning and verify implementation details manually.
Linear shows action requiredOAuth token refresh, webhook setup, or revocation handling needs attention.Reconnect Linear from Settings > Integrations.
Implementation pack is blockedBlueprint approval is required or repository mapping is missing.Approve the blueprint pull request or mark blueprint not required with a reason and repository mapping.
Draft pull request was not createdGitHub write permissions, installation token, repository mapping, or auto pull request setting is missing.Check GitHub write upgrade and delivery handoff settings.
Generation is paused by cost capMonthly LLM spend reached the configured cap.Increase the cost cap or wait for the next billing period.