Troubleshooting

Common issues and their solutions. If you don't find your answer here, contact support@synthcore.dev.

Provisioning

Project stuck on "Provisioning"

If your project has been in the Provisioning state for more than 10 minutes:

1. Check the Logs tab for error messages.
2. Try deleting the project and creating a new one.
3. If the issue persists, the Azure region may be experiencing capacity issues. Try a different region.

"Insufficient permissions" error

This means Synthcore doesn't have write access to your repository:

1. Go to GitHub Settings > Applications > Synthcore.
2. Ensure the repository is in the authorized list.
3. Verify Synthcore has "Read and write" access to repository contents.

Agent Issues

Agents not committing

If agents are running but not producing commits:

1. Check the Activity tab for research or analysis entries — agents may be in the investigation phase.
2. Review the Logs tab for warnings or errors.
3. Verify your SOUL.md has clear priorities and a project description.
4. Check that AGENTS.md boundaries aren't overly restrictive.

Merge conflicts

Agents are designed to handle merge conflicts automatically. If conflicts persist:

1. Ensure COORDINATION.md defines clear file ownership boundaries.
2. Reduce concurrent agent activity by pausing some agents.
3. Manually resolve the conflict in your repo — agents will pick up the clean state.

Agent modifying wrong files

If an agent is working outside its intended area:

1. Update AGENTS.md with stricter boundary rules.
2. Update COORDINATION.md with explicit file ownership.
3. Changes take effect on the next agent cycle.

Build Failures

Build fails after agent commit

Echo (QA agent) monitors builds automatically. If a build fails:

1. Echo will log a warning in the activity feed.
2. The offending commit is identified in the logs.
3. Alex or Pixel will attempt a fix in their next cycle.
4. If the issue persists, manually revert the commit and update agent priorities.

TypeScript errors

If agents produce TypeScript errors:

1. Ensure your SOUL.md specifies "TypeScript strict mode" in the tech stack.
2. Add type-checking instructions to agent boundaries.
3. Check that tsconfig.json is in the repo root.

Billing

Payment failed

1. Go to Dashboard > Billing > Manage Subscription.
2. Update your payment method in the Stripe portal.
3. Stripe will retry the charge automatically.

Wrong plan

1. Go to Dashboard > Billing > Manage Subscription.
2. Change your plan in the Stripe Customer Portal.
3. Changes are pro-rated — you'll only pay the difference.

Getting Help

If your issue isn't covered here:

• Email: support@synthcore.dev
• Docs: Search these docs with Cmd+K
• Business/Enterprise: Use your dedicated Slack channel