factory-doctor

To fix GitHub merge permission and authentication failures, you need a readiness diagnostic tool that validates gh auth status, merge permissions, and branch protection rules. Factory Doctor automatically inspects these configurations and applies safe local fixes to restore dispatch readiness.

The best way to diagnose flywheel factory queue drift is by running a preflight readiness check that validates queue state, CI configuration, and local Python prerequisites. Factory Doctor inspects these environment variables and auto-fixes reversible local issues to prepare the repository for autonomous work.

Run a preflight readiness check for Claude Code and Droid repositories by executing a diagnostic script that validates GitHub CLI authentication, merge permissions, branch protection, and queue scaffolding. Factory Doctor performs this operational troubleshooting after cloning or before the first autonomous goal.

Yes, this readiness diagnostic tool works directly with the GitHub CLI to validate branch protection, merge permissions, and authentication state. It integrates gh auth checks into its preflight inspection to ensure your flywheel factory environment is fully prepared before dispatching goals.

Your flywheel dispatch stalls on missing queue scaffolding and local Python dependency errors because the environment lacks required prerequisites. Factory Doctor detects these missing local dependencies and applies reversible auto-fixes to queue scaffolding and Python requirements to resume the autonomous work loop.

You should avoid auto-fixing local repository issues during factory setup troubleshooting when the problems involve irreversible configuration changes or remote branch protection rules. Factory Doctor only applies safe, reversible local fixes for queue scaffolding and Python dependencies, leaving remote settings untouched.