okhp3-project-compass

Point at a project folder, git clone, or repository and establish or refresh its purpose, vision, mission, goals, and task tracking from evidence. Starts with a detection phase choosing Mode A, a GitHub-backed repo tracked through milestones, issues, sub-issues, labels, and releases via the gh CLI, or Mode B, a plain folder tracked entirely in files. First run infers intent from README, docs, ADRs, commits, TODO markers, and structure, then scaffolds a charter, an objectives-to-tasks decomposition, and machine-readable tracking with stable IDs. Later runs reassess progress, mark work done, blocked, or abandoned with evidence, surface new or changed goals as scope drift, flag orphaned and stale work, and emit a delta report. Also activate for "what is this repo even for", "is this project still on track", "did anything change since last time", scheduled or unattended check-ins, and projects with no tracking artifacts. Handles monorepos, content-first repos, and folders with no git histo