# Troubleshooting

When a workflow fails, start with the narrowest document that matches the failure mode and then move into the investigation history only if needed.

## Primary References

- [System Logs](../SYSTEM_LOGS.md).
- [Investigations](../INVESTIGATIONS.md).
- [Sync Job Production Fixes](../SYNC_JOB_PRODUCTION_FIXES.md).
- [OneDrive OAuth Tenant Consolidation](../ONEDRIVE_OAUTH_TENANT_CONSOLIDATION_2026-03-31.md).

## Fast Triage Order

1. Check the visible error and activity log entry.
2. Confirm the provider account is still connected.
3. Check path, quota, and name-collision constraints.
4. Use the investigation and production-fix docs for recurring failures.

## Related Guides

- [File Operations](./FILE_OPERATIONS.md).
- [Backup and Sync](./BACKUP_SYNC.md).
- [Operations Hub](../operations/INDEX.md).