godpowers 1.6.10 → 1.6.12

package/lib/dashboard.js

@@ -0,0 +1,296 @@
+/**
+ * Godpowers Dashboard
+ *
+ * Shared executable status engine for /god-status, /god-next, /god-sync,
+ * /god-scan, and /god-mode closeouts. Disk state is authoritative.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const cp = require('child_process');
+
+const state = require('./state');
+const router = require('./router');
+
+const GOD_DIR = '.godpowers';
+const PRD_PATH = '.godpowers/prd/PRD.md';
+const ROADMAP_PATH = '.godpowers/roadmap/ROADMAP.md';
+const CHECKPOINT_PATH = '.godpowers/CHECKPOINT.md';
+const SYNC_LOG_PATH = '.godpowers/SYNC-LOG.md';
+const REVIEW_PATH = '.godpowers/REVIEW-REQUIRED.md';
+
+function exists(projectRoot, relPath) {
+  return fs.existsSync(path.join(projectRoot, relPath));
+}
+
+function readText(projectRoot, relPath) {
+  const file = path.join(projectRoot, relPath);
+  if (!fs.existsSync(file)) return '';
+  return fs.readFileSync(file, 'utf8');
+}
+
+function mtimeMs(projectRoot, relPath) {
+  const file = path.join(projectRoot, relPath);
+  if (!fs.existsSync(file)) return null;
+  return fs.statSync(file).mtimeMs;
+}
+
+function artifactStatus(projectRoot, relPath) {
+  return exists(projectRoot, relPath) ? 'done' : 'missing';
+}
+
+function currentPhase(progress) {
+  const current = progress && progress.current;
+  if (!current) {
+    return {
+      phase: 'Complete',
+      tierKey: null,
+      tierNumber: null,
+      tierTotal: 0,
+      tierOrdinal: 0,
+      tierCount: 0,
+      tierLabel: 'Complete',
+      stepLabel: 'Complete',
+      stepNumber: 0,
+      totalSteps: progress ? progress.total : 0
+    };
+  }
+
+  const tierNumbers = (progress.tiers || [])
+    .map(tier => tier.tierNumber)
+    .filter(n => Number.isFinite(n))
+    .sort((a, b) => a - b);
+  const tierTotal = tierNumbers.length > 0 ? Math.max(...tierNumbers) : current.tierNumber;
+  const tierOrdinal = tierNumbers.indexOf(current.tierNumber) + 1;
+  const tierCount = tierNumbers.length || (Number.isFinite(current.tierNumber) ? current.tierNumber + 1 : 0);
+
+  return {
+    phase: current.tierLabel,
+    tierKey: current.tierKey,
+    tierNumber: current.tierNumber,
+    tierTotal,
+    tierOrdinal: tierOrdinal > 0 ? tierOrdinal : 1,
+    tierCount,
+    tierLabel: current.tierLabel,
+    stepLabel: current.subStepLabel,
+    stepNumber: current.ordinal,
+    totalSteps: progress.total
+  };
+}
+
+function worktree(projectRoot) {
+  try {
+    const out = cp.execFileSync('git', ['status', '--porcelain'], {
+      cwd: projectRoot,
+      encoding: 'utf8',
+      stdio: ['ignore', 'pipe', 'ignore']
+    });
+    return parseGitStatus(out);
+  } catch (e) {
+    return { worktree: 'unknown', index: 'unknown', entries: [] };
+  }
+}
+
+function parseGitStatus(out) {
+  if (!out || !out.trim()) {
+    return { worktree: 'clean', index: 'untouched', entries: [] };
+  }
+  const entries = out.split(/\r?\n/).filter(Boolean);
+  const staged = entries.filter(line => line[0] !== ' ' && line[0] !== '?');
+  const unstaged = entries.filter(line => line[1] !== ' ' || line.startsWith('??'));
+  let worktreeState = 'modified files unstaged';
+  if (staged.length > 0 && unstaged.length > 0) worktreeState = 'mixed';
+  else if (staged.length > 0) worktreeState = 'staged changes';
+  return {
+    worktree: worktreeState,
+    index: staged.length > 0 ? staged.map(statusPath).join(', ') : 'untouched',
+    entries
+  };
+}
+
+function statusPath(line) {
+  if (line.startsWith('?? ')) return line.slice(3);
+  return line.length > 3 ? line.slice(3) : line.trim();
+}
+
+function reviewCount(projectRoot) {
+  const text = readText(projectRoot, REVIEW_PATH);
+  if (!text.trim()) return 0;
+  const unchecked = (text.match(/\[\s\]\s*(?:TODO|PENDING|OPEN|REVIEW|BLOCKER|[Pp][0-3])/g) || []).length;
+  if (unchecked > 0) return unchecked;
+  const headings = (text.match(/^###\s+/gm) || []).length;
+  return headings;
+}
+
+function hasRecentPath(projectRoot, relPath, maxAgeMs) {
+  const modified = mtimeMs(projectRoot, relPath);
+  if (!modified) return false;
+  return Date.now() - modified <= maxAgeMs;
+}
+
+function proactiveChecks(projectRoot, changedFiles = []) {
+  const oneDay = 24 * 60 * 60 * 1000;
+  const thirtyDays = 30 * oneDay;
+  const reviews = reviewCount(projectRoot);
+
+  const checkpoint = exists(projectRoot, CHECKPOINT_PATH)
+    ? (hasRecentPath(projectRoot, CHECKPOINT_PATH, oneDay) ? 'fresh' : 'stale')
+    : 'missing';
+
+  const sync = exists(projectRoot, SYNC_LOG_PATH)
+    ? (hasRecentPath(projectRoot, SYNC_LOG_PATH, oneDay) ? 'fresh' : 'stale, suggest /god-sync')
+    : 'missing, suggest /god-sync';
+
+  const hygieneFresh = exists(projectRoot, CHECKPOINT_PATH)
+    && hasRecentPath(projectRoot, CHECKPOINT_PATH, thirtyDays);
+
+  const pkgChanged = changedFiles.some(file => [
+    'package.json',
+    'package-lock.json',
+    'pnpm-lock.yaml',
+    'yarn.lock'
+  ].includes(file));
+  const sensitiveChanged = changedFiles.some(file => matchesAnyPrefix(file, [
+    '.env.example',
+    'SECURITY.md',
+    '.github/workflows',
+    'auth',
+    'security'
+  ]));
+
+  return {
+    checkpoint,
+    reviews: reviews > 0 ? `${reviews} pending, suggest /god-review-changes` : 'none',
+    sync,
+    docs: 'fresh',
+    runtime: 'not-applicable',
+    security: sensitiveChanged ? 'sensitive files changed, suggest /god-harden' : 'clear',
+    dependencies: pkgChanged ? 'dependency files changed, suggest /god-update-deps' : 'clear',
+    hygiene: hygieneFresh ? 'fresh' : 'stale, suggest /god-hygiene'
+  };
+}
+
+function matchesAnyPrefix(file, prefixes) {
+  return prefixes.some(prefix => file === prefix || file.startsWith(`${prefix}/`));
+}
+
+function planningVisibility(projectRoot, progress) {
+  const prd = artifactStatus(projectRoot, PRD_PATH);
+  const roadmap = artifactStatus(projectRoot, ROADMAP_PATH);
+  const phase = currentPhase(progress);
+  return {
+    prd: { status: prd, path: prd === 'done' ? PRD_PATH : null },
+    roadmap: { status: roadmap, path: roadmap === 'done' ? ROADMAP_PATH : null },
+    currentMilestone: phase.stepLabel ? `${phase.phase} / ${phase.stepLabel}` : phase.phase,
+    completion: `${progress.percent}% based on state.json tracked steps`
+  };
+}
+
+function compute(projectRoot, opts = {}) {
+  const s = state.read(projectRoot);
+  const git = opts.git === false ? { worktree: 'not-checked', index: 'not-checked', entries: [] } : worktree(projectRoot);
+
+  if (!s) {
+    const next = { command: '/god-init', reason: 'No Godpowers project initialized' };
+    return {
+      state: 'not initialized',
+      mode: null,
+      lifecycle: 'pre-init',
+      progress: { percent: 0, completed: 0, total: 0, currentStep: 0, current: null, tiers: [] },
+      current: currentPhase(null),
+      worktree: git.worktree,
+      index: git.index,
+      planning: {
+        prd: { status: 'missing', path: null },
+        roadmap: { status: 'missing', path: null },
+        currentMilestone: 'Project initialization',
+        completion: '0% based on missing state.json'
+      },
+      proactive: proactiveChecks(projectRoot, git.entries.map(statusPath)),
+      next,
+      openItems: ['No .godpowers/state.json found']
+    };
+  }
+
+  const progress = state.progressSummary(s);
+  const current = currentPhase(progress);
+  const next = router.suggestNext(projectRoot);
+  const openItems = [];
+  const drift = state.detectDrift(projectRoot);
+
+  if (drift.length > 0) openItems.push(`${drift.length} artifact drift item(s), suggest /god-repair`);
+  if (next && next.blocker) openItems.push(`${next.blocker} blocks next route`);
+  if (reviewCount(projectRoot) > 0) openItems.push('pending review items');
+  if (openItems.length === 0) openItems.push('none');
+
+  return {
+    state: progress.remaining === 0 ? 'complete' : 'in progress',
+    mode: s.mode || s['mode-announced-as'] || null,
+    lifecycle: s['lifecycle-phase'] || 'in-arc',
+    progress,
+    current,
+    worktree: git.worktree,
+    index: git.index,
+    planning: planningVisibility(projectRoot, progress),
+    proactive: proactiveChecks(projectRoot, git.entries.map(statusPath)),
+    next,
+    openItems
+  };
+}
+
+function render(dashboard) {
+  const current = dashboard.current || {};
+  const planning = dashboard.planning || {};
+  const proactive = dashboard.proactive || {};
+  const next = dashboard.next || {};
+  const progress = dashboard.progress || {};
+  const prd = planning.prd || {};
+  const roadmap = planning.roadmap || {};
+  const openItems = dashboard.openItems && dashboard.openItems.length > 0
+    ? dashboard.openItems
+    : ['none'];
+
+  return [
+    'Godpowers Dashboard',
+    '',
+    'Current status:',
+    `  State: ${dashboard.state}`,
+    `  Phase: ${current.phase || 'unknown'}${current.tierNumber !== null && current.tierNumber !== undefined ? ` (tier ${current.tierOrdinal} of ${current.tierCount}, internal ${current.tierKey || `tier-${current.tierNumber}`})` : ''}`,
+    `  Step: ${current.stepLabel || 'unknown'}${current.stepNumber ? ` (step ${current.stepNumber} of ${current.totalSteps})` : ''}`,
+    `  Progress: ${progress.percent || 0}% (${progress.completed || 0} of ${progress.total || 0} steps complete)`,
+    `  Worktree: ${dashboard.worktree}`,
+    `  Index: ${dashboard.index}`,
+    '',
+    'Planning visibility:',
+    `  PRD: ${prd.status || 'missing'}${prd.path ? ` ${prd.path}` : ''}`,
+    `  Roadmap: ${roadmap.status || 'missing'}${roadmap.path ? ` ${roadmap.path}` : ''}`,
+    `  Current milestone: ${planning.currentMilestone || 'unknown'}`,
+    `  Completion: ${planning.completion || 'unknown'}`,
+    '',
+    'Proactive checks:',
+    `  Checkpoint: ${proactive.checkpoint || 'unknown'}`,
+    `  Reviews: ${proactive.reviews || 'unknown'}`,
+    `  Sync: ${proactive.sync || 'unknown'}`,
+    `  Docs: ${proactive.docs || 'unknown'}`,
+    `  Runtime: ${proactive.runtime || 'unknown'}`,
+    `  Security: ${proactive.security || 'unknown'}`,
+    `  Dependencies: ${proactive.dependencies || 'unknown'}`,
+    `  Hygiene: ${proactive.hygiene || 'unknown'}`,
+    '',
+    'Open items:',
+    ...openItems.map((item, index) => `  ${index + 1}. ${item}`),
+    '',
+    'Next:',
+    `  Recommended: ${next.command || 'describe the next intent'}`,
+    `  Why: ${next.reason || 'No route was computed.'}`
+  ].join('\n');
+}
+
+module.exports = {
+  compute,
+  render,
+  worktree,
+  parseGitStatus,
+  proactiveChecks,
+  planningVisibility
+};

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "godpowers",
-  "version": "1.6.10",
+  "version": "1.6.12",
   "description": "AI-powered development system: 106 slash commands and 39 specialist agents that take a project from raw idea to hardened production. Runs inside Claude Code, Codex, Cursor, Windsurf, Gemini, and 10+ other AI coding tools.",
   "bin": {
     "godpowers": "./bin/install.js"
   },
   "scripts": {
-    "test": "node scripts/validate-skills.js && node scripts/test-doc-surface-counts.js && bash scripts/smoke.sh && node scripts/test-runtime.js && node scripts/test-router.js && node scripts/test-recipes.js && node scripts/test-context-writer.js && node scripts/test-pillars.js && node scripts/test-artifact-linter.js && node scripts/test-artifact-diff.js && node scripts/test-design-foundation.js && node scripts/test-linkage.js && node scripts/test-impact.js && node scripts/test-reverse-sync.js && node scripts/test-integration.js && node scripts/test-cross-artifact.js && node scripts/test-awesome-design.js && node scripts/test-skillui-bridge.js && node scripts/test-runtime-verification.js && node scripts/test-agent-browser.js && node scripts/test-mode-d.js && node scripts/test-runtime-heuristics.js && node scripts/test-agent-validator.js && node scripts/test-story-validator.js && node scripts/test-state.js && node scripts/test-intent.js && node scripts/test-events.js && node scripts/test-golden-artifacts.js && node scripts/test-install-smoke.js && node scripts/test-checkpoint.js && node scripts/test-extensions.js && node scripts/test-event-reader.js && node scripts/test-state-lock.js && node scripts/test-cost-saver.js && node scripts/test-budget-onoff.js && node scripts/test-workflow-runner.js && npm run test:e2e && node scripts/test-otel-exporter.js && node scripts/test-extensions-publish.js",
+    "test": "node scripts/validate-skills.js && node scripts/test-doc-surface-counts.js && bash scripts/smoke.sh && node scripts/test-runtime.js && node scripts/test-router.js && node scripts/test-recipes.js && node scripts/test-context-writer.js && node scripts/test-pillars.js && node scripts/test-artifact-linter.js && node scripts/test-artifact-diff.js && node scripts/test-design-foundation.js && node scripts/test-linkage.js && node scripts/test-impact.js && node scripts/test-reverse-sync.js && node scripts/test-integration.js && node scripts/test-cross-artifact.js && node scripts/test-awesome-design.js && node scripts/test-skillui-bridge.js && node scripts/test-runtime-verification.js && node scripts/test-agent-browser.js && node scripts/test-mode-d.js && node scripts/test-runtime-heuristics.js && node scripts/test-agent-validator.js && node scripts/test-story-validator.js && node scripts/test-state.js && node scripts/test-dashboard.js && node scripts/test-intent.js && node scripts/test-events.js && node scripts/test-golden-artifacts.js && node scripts/test-install-smoke.js && node scripts/test-checkpoint.js && node scripts/test-extensions.js && node scripts/test-event-reader.js && node scripts/test-state-lock.js && node scripts/test-cost-saver.js && node scripts/test-budget-onoff.js && node scripts/test-workflow-runner.js && npm run test:e2e && node scripts/test-otel-exporter.js && node scripts/test-extensions-publish.js",
     "prepublishOnly": "npm test",
     "validate-skills": "node scripts/validate-skills.js",
     "test:surface": "node scripts/test-doc-surface-counts.js",

package/skills/god-arch.md

@@ -9,7 +9,7 @@ description: |
 
 # /god-arch
 
-Spawn the **god-architect** agent in a fresh context via Task tool.
+Spawn the **god-architect** agent in a fresh context via the host platform's native agent spawning mechanism.
 
 ## Setup
 

package/skills/god-audit.md

@@ -9,7 +9,7 @@ description: |
 
 # /god-audit
 
-Spawn the **god-auditor** agent in a fresh context via Task tool.
+Spawn the **god-auditor** agent in a fresh context via the host platform's native agent spawning mechanism.
 
 ## Setup
 

package/skills/god-debug.md

@@ -9,7 +9,7 @@ description: |
 
 # /god-debug
 
-Spawn the **god-debugger** agent in a fresh context via Task tool.
+Spawn the **god-debugger** agent in a fresh context via the host platform's native agent spawning mechanism.
 
 ## Setup
 

package/skills/god-deploy.md

@@ -9,7 +9,7 @@ description: |
 
 # /god-deploy
 
-Spawn the **god-deploy-engineer** agent in a fresh context via Task tool.
+Spawn the **god-deploy-engineer** agent in a fresh context via the host platform's native agent spawning mechanism.
 
 ## Setup
 

package/skills/god-docs.md

@@ -48,6 +48,28 @@ Update log: .godpowers/docs/UPDATE-LOG.md
 Suggested next: /god-status or continue with feature work
 ```
 
+## Proactive docs drift
+
+Godpowers may invoke docs work proactively in two ways:
+
+| Trigger | Action | Guardrail |
+|---|---|---|
+| Docs changed after code changed | Spawn `god-docs-writer` in drift-check mode when current workflow owns docs | Do not invent new docs scope |
+| Code changed after docs that claim current behavior | Suggest `/god-docs` or spawn drift-check inside `/god-mode`, `/god-feature`, `/god-refactor`, or `/god-sync` closeout | Verify claims against code before editing |
+| `REVIEW-REQUIRED.md` contains docs drift items | Suggest `/god-review-changes` first | Do not auto-clear review items |
+
+When auto-invoked, show:
+
+```text
+Auto-invoked:
+  Trigger: docs and code changed in the same workflow
+  Agent: god-docs-writer
+  Local syncs:
+    + docs-drift-check: <N claims checked, N drift items>
+  Artifacts: .godpowers/docs/UPDATE-LOG.md or no-op
+  Log: .godpowers/docs/UPDATE-LOG.md
+```
+
 ## Have-Nots
 
 Docs FAIL if:

package/skills/god-harden.md

@@ -9,7 +9,7 @@ description: |
 
 # /god-harden
 
-Spawn the **god-harden-auditor** agent in a fresh context via Task tool.
+Spawn the **god-harden-auditor** agent in a fresh context via the host platform's native agent spawning mechanism.
 
 ## Setup
 

package/skills/god-launch.md

@@ -9,7 +9,7 @@ description: |
 
 # /god-launch
 
-Spawn the **god-launch-strategist** agent in a fresh context via Task tool.
+Spawn the **god-launch-strategist** agent in a fresh context via the host platform's native agent spawning mechanism.
 
 ## Setup
 

package/skills/god-mode.md

@@ -125,7 +125,7 @@ workflow.
        unresolved Critical harden findings. These are release-truth gates, not
        preference pauses.
 
-6. Spawn the **god-orchestrator** agent via Task tool with only a
+6. Spawn the **god-orchestrator** agent via the host platform's native agent spawning mechanism with only a
    display-safe payload:
    - Name the project root.
    - Name the invocation flags.
@@ -137,7 +137,7 @@ workflow.
    hidden routing rules, or detailed instructions in the spawn message.
    Assume the host UI may display the raw spawn message to the user.
 
-7. Keep the spawn payload display-safe. Do not echo or summarize raw Task input,
+7. Keep the spawn payload display-safe. Do not echo or summarize raw spawn input,
    "Hard instructions", hidden orchestration rules, agent prompts, file
    loadout lists, or internal routing payloads into the user-visible transcript.
    The visible transcript may say only what phase is running, what durable state
@@ -169,6 +169,8 @@ Show:
 - detected resume or project mode in plain language
 - a compact "Next step" card before each visible phase or tier sub-step
 - a compact "Step result" card after each visible phase or tier sub-step
+- every auto-invoked command, agent, and local runtime helper using an
+  `Auto-invoked:` or `Sync status:` card
 - plain-language workflow names. Say "project run" or "workflow" instead of
   unexplained "arc" in visible output
 - PRD and roadmap visibility in status and closeout blocks when artifacts
@@ -176,11 +178,12 @@ Show:
 - short progress updates for phases, commands, validations, and file edits
 - concise validation summaries instead of full command noise when possible
 - final changed paths, validation results, and completion or pause status
-- final current status, open items, worktree/index state, and recommended next
-  action
+- final Godpowers Dashboard from disk, including phase, tier, step, progress,
+  planning visibility, proactive checks, open items, worktree/index state, and
+  recommended next action
 
 Hide:
-- raw Task input
+- raw spawn input
 - "Hard instructions" sections
 - spawned-agent prompt text
 - detailed handoff file contents
@@ -200,11 +203,11 @@ missing them, synthesize them from disk state before continuing.
 
 Before work starts:
 
-```
+```text
 Next step
-Progress: <pct>% (<done> of <total> steps complete; current step <n> of <total>)
-Tier: <tier-number> <tier-label>
+Phase: <plain-language phase> (tier <human ordinal> of <human total>)
 Step: <sub-step-label>
+Progress: <pct>% (<done> of <total> steps complete; step <n> of <total>)
 Why this now: <one sentence>
 What will happen:
   1. <observable action>
@@ -214,11 +217,11 @@ Expected output: <artifact path or verification result>
 
 After work completes or pauses:
 
-```
+```text
 Step result
-Progress: <pct>% (<done> of <total> steps complete; current step <n> of <total>)
-Tier: <tier-number> <tier-label>
+Phase: <plain-language phase> (tier <human ordinal> of <human total>)
 Step: <sub-step-label>
+Progress: <pct>% (<done> of <total> steps complete; step <n> of <total>)
 Result: <done | blocked | failed | skipped | imported>
 What happened:
   1. <observable action completed>
@@ -294,6 +297,21 @@ Under `--yolo`, the sync step auto-applies (no pause). Under
 `--conservative`, it pauses for confirmation. Under `--with-hygiene`,
 it runs alongside the hygiene pass.
 
+Display this before the final completion block:
+
+```
+Sync status:
+  Trigger: /god-mode final sync
+  Agent: god-updater spawned
+  Local syncs:
+    + reverse-sync: <counts and result>
+    + pillars-sync: <counts and result>
+    + checkpoint-sync: <created, updated, no-op, or skipped>
+    + context-refresh: <spawned, no-op, or skipped>
+  Artifacts: <changed files or no-op>
+  Log: .godpowers/SYNC-LOG.md
+```
+
 The sync step also reconciles native Pillars context. When `.godpowers`
 artifacts create or change durable project truth, Godpowers maps those changes
 to relevant pillar files through `lib/pillars.planArtifactSync`. Default mode
@@ -315,6 +333,17 @@ When orchestrator returns "complete", display:
 ```
 Godpowers project run complete.
 
+Sync status:
+  Trigger: /god-mode final sync
+  Agent: god-updater spawned
+  Local syncs:
+    + reverse-sync: <counts and result>
+    + pillars-sync: <counts and result>
+    + checkpoint-sync: <created, updated, no-op, or skipped>
+    + context-refresh: <spawned, no-op, or skipped>
+  Artifacts: <changed files or no-op>
+  Log: .godpowers/SYNC-LOG.md
+
 Current status:
   State: complete
   Progress: <pct>% (<done> of <total> steps complete; current step <n> of <total>)

package/skills/god-next.md

@@ -22,6 +22,9 @@ Before reading routing data or calling runtime modules, resolve the Godpowers ru
 1. If `<projectRoot>/lib/router.js` exists, use the repository checkout runtime at `<projectRoot>`.
 2. Otherwise use the installed bundle at `<tool-config-dir>/godpowers-runtime`, where `<tool-config-dir>` is the directory that contains this installed skill, such as `~/.claude`, `~/.codex`, `~/.cursor`, `~/.windsurf`, or `~/.gemini`.
 3. Read routing definitions from `<runtimeRoot>/routing/*.yaml` and recipes from `<runtimeRoot>/routing/recipes/*.yaml`.
+4. For status output, load `<runtimeRoot>/lib/dashboard.js` and call
+   `dashboard.compute(projectRoot)`. Use `dashboard.render(result)` for the
+   shared dashboard section before adding route-specific detail.
 
 ## Three modes of invocation
 
@@ -168,6 +171,42 @@ Planning visibility:
   Completion: <pct>% <basis from state.json or PROGRESS.md>
 ```
 
+## Proactive Sweep
+
+Before returning a suggestion, run the proactive auto-invoke policy from the
+master skill against disk state. This is read-only unless a Level 2 local helper
+has a direct trigger.
+
+Check these signals:
+- `.godpowers/CHECKPOINT.md` missing, stale, or conflicting with `state.json`
+- `.godpowers/REVIEW-REQUIRED.md` contains pending entries
+- `.godpowers/SYNC-LOG.md` missing after code or artifact edits
+- docs changed after code changed, or code changed after docs that claim
+  current behavior
+- frontend-visible files changed and a known local, preview, staging, or
+  production URL is evidenced
+- security-sensitive files changed
+- dependency files changed
+- full project run completed and hygiene has not run recently
+
+Display the result:
+
+```text
+Proactive checks:
+  Checkpoint: <fresh | refreshed | stale, suggest /god-locate>
+  Reviews: <none | N pending, suggest /god-review-changes>
+  Sync: <fresh | suggest /god-sync | local linkage scan ran>
+  Docs: <fresh | suggest /god-docs | drift-check spawned>
+  Runtime: <not-applicable | suggest /god-test-runtime | browser test spawned>
+  Security: <clear | suggest /god-harden>
+  Dependencies: <clear | suggest /god-update-deps>
+  Hygiene: <fresh | suggest /god-hygiene>
+```
+
+Do not auto-run Level 3 agents from standalone `/god-next` unless the user
+explicitly asked it to continue work. In standalone mode, Level 3 items become
+the recommended command or a proposition option.
+
 ## Process for Mode 4 (intent-based)
 
 ```
@@ -297,11 +336,31 @@ recommending archaeology, reconstruction, project-run readiness, pillars, or ref
 
 ## Output Format
 
-```
+`/god-next` must emit the same Godpowers Dashboard shape used by
+`/god-status`, then add routing detail and the proposition block.
+Prefer the executable `lib/dashboard.js` output over manually recomputing the
+same fields. If the module is unavailable, say
+`Dashboard engine: unavailable, manual scan used`.
+
+```text
 Godpowers Next
 
-Current state: [where we are]
-Progress: [pct]% ([done] of [total] steps complete; current step [n] of [total])
+Godpowers Dashboard
+
+Current status:
+  State: proposal
+  Phase: [plain-language phase] (tier [human ordinal] of [human total])
+  Step: [current step label] (step [n] of [total steps])
+  Progress: [pct]% ([done] of [total] steps complete)
+  Worktree: [clean | modified files unstaged | staged changes | mixed]
+  Index: [untouched | staged files listed]
+
+Planning visibility:
+  PRD: [done | pending | missing | deferred] [path when present]
+  Roadmap: [done | pending | missing | deferred] [path when present]
+  Current milestone: [roadmap milestone, phase, tier, or next planning gate]
+  Completion: [pct]% [basis from state.json, PROGRESS.md, or artifacts]
+
 Suggested next: [/god-X]
 
 Why: [one-line reason]
@@ -321,6 +380,23 @@ Previous tier had standards failures. Address before proceeding:
   - [failure 1]
   - [failure 2]
 Suggested: /god-redo [tier] OR /god-skip [tier] --reason="..."
+
+Proactive checks:
+  Checkpoint: [fresh | refreshed | missing | stale]
+  Reviews: [none | N pending, suggest /god-review-changes]
+  Sync: [fresh | missing | stale | local helper ran | suggest /god-sync]
+  Docs: [fresh | possible drift, suggest /god-docs]
+  Runtime: [not-applicable | known URL, suggest /god-test-runtime | no known URL, defer deployed verification]
+  Security: [clear | sensitive files changed, suggest /god-harden]
+  Dependencies: [clear | dependency files changed, suggest /god-update-deps]
+  Hygiene: [fresh | stale, suggest /god-hygiene]
+
+Open items:
+  1. [missing prerequisite, blocker, pending review, or none]
+
+Next:
+  Recommended: [/god-X or exact user decision]
+  Why: [one sentence tied to disk state]
 ```
 
 ## Proposition Closeout

package/skills/god-observe.md

@@ -9,7 +9,7 @@ description: |
 
 # /god-observe
 
-Spawn the **god-observability-engineer** agent in a fresh context via Task tool.
+Spawn the **god-observability-engineer** agent in a fresh context via the host platform's native agent spawning mechanism.
 
 ## Setup
 

package/skills/god-party.md

@@ -30,7 +30,7 @@ Get multiple specialist perspectives on a single question.
    - Harden auditor (god-harden-auditor) - security implications
    - Launch strategist (god-launch-strategist) - go-to-market implications
 
-3. Spawn each selected persona IN PARALLEL via Task tool:
+3. Spawn each selected persona IN PARALLEL via the host platform's native agent spawning mechanism:
    - Each gets fresh context
    - Each receives ONLY the question and the relevant artifact subset
    - Each is instructed: respond as your specialist, do not soften or hedge

package/skills/god-prd.md

@@ -9,7 +9,7 @@ description: |
 
 # /god-prd
 
-Spawn the **god-pm** agent in a fresh context via Task tool.
+Spawn the **god-pm** agent in a fresh context via the host platform's native agent spawning mechanism.
 
 ## Setup
 

package/skills/god-repo.md

@@ -9,7 +9,7 @@ description: |
 
 # /god-repo
 
-Spawn the **god-repo-scaffolder** agent in a fresh context via Task tool.
+Spawn the **god-repo-scaffolder** agent in a fresh context via the host platform's native agent spawning mechanism.
 
 ## Setup