What problem does it solve? When startup fails to reach backends, engineers need a single authoritative source for scenario classification, probe retry, adaptive timeouts, cloud fallback, and env-local override detection. This stub prevents stale or divergent copies by enforcing a fail-closed sync to the canonical skill hosted in the Perpetua-Tools GitHub repository. ## Core Features & Use Cases - Cross-Repo Redirect: Points agents to the canonical startup-intelligence SKILL.md on GitHub main, never assuming a sibling checkout layout. - Fail-Closed Local Sync: Resolves a local Perpetua-Tools checkout via environment variables ($PERPETUATOOLSROOT, $PERPETUA_TOOLS_ROOT, $PERPETUA_TOOLS_PATH, $PT_HOME) and validates branch, cleanliness, and fast-forward pull before use. - Dirty-Worktree Guardrails: Requires explicit operator approval before any commit or push when the worktree is dirty, and forbids git reset --hard or force-push on main. - Use Case: An agent troubleshooting a Perpetua-Tools startup failure loads this stub, syncs or falls back to the canonical GitHub skill, then applies its classification and retry guidance. ## Quick Start Ask the agent to load the canonical startup-intelligence skill from Perpetua-Tools and diagnose why startup cannot reach the backends.
