godmode

/godmode — orient

Answer one question in 5 lines or fewer: where am I, what's done, and what is the single next command to run? Derive everything below from the live filesystem and the recorded workflow state — never from a memorized list.

---

1. Resolve paths (plugin / manual / repo modes)

The same logic runs whether God-Mode is installed as a plugin, installed manually into ~/.claude/, or run from a repo checkout. Resolve the plugin root, then the manifest:

# Plugin mode sets CLAUDE_PLUGIN_ROOT. Manual install lives under ~/.claude.
# Repo checkout: the command file's own tree. Pick the first that has plugin.json.
ROOT=""
for cand in "${CLAUDE_PLUGIN_ROOT:-}" "$HOME/.claude" "$(pwd)"; do
  [ -n "$cand" ] || continue
  if [ -f "$cand/.claude-plugin/plugin.json" ] || [ -d "$cand/agents" ]; then
    ROOT="$cand"
    break
  fi
done
[ -n "$ROOT" ] && echo "root: $ROOT" || echo "root: (unresolved — using repo-relative fallbacks)"

If ROOT stays empty, fall back to the repo-relative dirs agents/, skills/, commands/ and .claude-plugin/plugin.json from the current working directory.

2. Read the canonical version

.claude-plugin/plugin.json:.version is the single source of truth — read it at runtime, never hardcode:

MANIFEST="$ROOT/.claude-plugin/plugin.json"
[ -f "$MANIFEST" ] || MANIFEST=".claude-plugin/plugin.json"
VERSION=$(jq -r '.version // "unknown"' "$MANIFEST" 2>/dev/null || echo "unknown")
echo "version: $VERSION"

3. Read the workflow state

/mission records the workflow keys via bin/godmode-state — including the active mission (mission_id + human-readable mission_name). Read them to derive the next action. Resolve the helper from the plugin root, then ~/.claude, then the repo:

STATE_BIN=""
for cand in "$ROOT/bin/godmode-state" "$HOME/.claude/bin/godmode-state" "bin/godmode-state"; do
  if [ -x "$cand" ]; then STATE_BIN="$cand"; break; fi
done
if [ -n "$STATE_BIN" ] && [ -f .planning/STATE.md ]; then
  MISSION_ID=$("$STATE_BIN" get mission_id)
  MISSION_NAME=$("$STATE_BIN" get mission_name)
  ACTIVE=$("$STATE_BIN" get active_unit)
  STATUS=$("$STATE_BIN" get status)
  NEXT=$("$STATE_BIN" get next_command)
  echo "mission_id: $MISSION_ID"
  echo "mission_name: $MISSION_NAME"
  echo "active_unit: $ACTIVE"
  echo "status: $STATUS"
  echo "next_command: $NEXT"
else
  echo "cold_start: true"   # no .planning/STATE.md yet
fi