godpowers 2.3.0 → 2.3.1

package/CHANGELOG.md

@@ -7,6 +7,38 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.3.1] - 2026-06-08
+
+### Added
+- Added `/god-extension-scaffold` as the slash-command entry point for
+  extension pack authoring, with routing metadata, installer profile coverage,
+  package payload checks, and front-door recipe coverage.
+- Added code-intelligence host capability detection for optional `ast-grep`,
+  `sg`, and LSP tooling without downgrading baseline host guarantees when those
+  tools are absent.
+- Added public starter-path regression checks that verify README and Quick
+  Proof goal labels resolve through shipped `/god` recipes and routes.
+
+### Changed
+- Updated public surface counts to 112 slash commands and 42 intent recipes
+  across release notes, reference docs, architecture maps, package metadata,
+  and project Pillars.
+- Tightened public front-door recipe matching for starter phrases including
+  "start a product", "add a feature", "fix production", "maintain health",
+  "audit an existing repo", "ship a release", and extension authoring.
+- Aligned the brownfield onboarding recipe to audit reconstructed artifacts
+  before tech-debt prioritization.
+
+### Fixed
+- Prevented maintainer-repository documentation drift from leaking into normal
+  user project dashboards.
+- Corrected Quick Proof output so fixture-backed checks render
+  `--project=.` for the user project path.
+- Hardened extension install, planning-system detection, and agent-cache cleanup
+  around symlinked directories that point outside the trusted source tree.
+- Removed phantom `god-*` examples from the extension scaffold skill prose so
+  agent-reference validation stays clean.
+
 ## [2.3.0] - 2026-05-30
 
 ### Added

package/README.md

@@ -2,7 +2,7 @@
 
 [![CI](https://github.com/aihxp/godpowers/actions/workflows/ci.yml/badge.svg)](https://github.com/aihxp/godpowers/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-[![Version](https://img.shields.io/badge/version-2.3.0-blue)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-2.3.1-blue)](CHANGELOG.md)
 [![npm](https://img.shields.io/npm/v/godpowers.svg)](https://www.npmjs.com/package/godpowers)
 
 **Ship fast. Ship right. Ship everything. Ship accountably.**
@@ -21,15 +21,15 @@ Godpowers makes AI coding accountable: every serious run should leave disk
 state, artifacts, validation gates, host guarantees, and a next action. Code is
 only one output. The project memory and proof trail matter too.
 
-Version 2.3.0 keeps the proof loop executable and adds accountability
-hardening. Build plans can now be checked against real repository files and
-symbols before execution, package-backed stack choices can be screened for
-legitimacy, core ledger writes use atomic persistence, installer profiles let
-teams choose a smaller command surface, and failed executor attempts leave a
-clear repair classification.
+Version 2.3.1 keeps the proof loop executable and adds release-surface
+hardening. Extension authors get `/god-extension-scaffold`, public starter
+paths are regression-tested against the actual router, host capability reports
+include optional code-intelligence tooling, clean user dashboards avoid
+maintainer-repo drift, and symlink handling is hardened across extension,
+planning-system, and cache paths.
 
-Maintainer hardening continues on the 2.x line without expanding the public
-command surface. The 2.1.0 patch closes a command-injection vector in the
+Maintainer hardening continues on the 2.x line with small, audited public
+surface updates when they close real workflow gaps. The 2.1.0 patch closes a command-injection vector in the
 agent-browser driver, guards runtime file parsing against corrupt state,
 makes data-directory installs a clean replace, and reconciles documentation
 drift. The 2.0.3 patch range-checks workflow agent references,
@@ -187,13 +187,13 @@ learn the next command when Godpowers recommends it.
 
 | Goal | Starter path |
 |---|---|
-| Start a product | `/god-init`, `/god-prd`, `/god-design`, `/god-arch`, `/god-roadmap`, `/god-stack`, `/god-build` |
-| Add a feature | `/god-feature`, `/god-reconcile`, `/god-build`, `/god-review`, `/god-sync` |
-| Fix production | `/god-hotfix`, `/god-debug`, `/god-harden`, `/god-postmortem` |
-| Audit an existing repo | `/god-preflight`, `/god-audit`, `/god-archaeology`, `/god-tech-debt` |
-| Ship a release | `/god-status`, `/god-harden`, `/god-launch`, `npm run release:check` |
+| Start a product | `/god-init`, `/god-prd`, `/god-design`, `/god-arch`, `/god-roadmap`, `/god-stack`, `/god-repo`, `/god-build` |
+| Add a feature | `/god-reconcile`, `/god-feature`, `/god-sync`, `/god-review` |
+| Fix production | `/god-hotfix`, `/god-postmortem`, `/god-status` |
+| Audit an existing repo | `/god-preflight`, `/god-archaeology`, `/god-reconstruct`, `/god-audit`, `/god-tech-debt` |
+| Ship a release | `/god-sync`, `/god-docs`, `/god-version`, `/god-automation-setup`, `npm run release:check` |
 | Maintain project health | `/god-hygiene`, `/god-update-deps`, `/god-docs`, `/god-check-todos` |
-| Extend Godpowers | `/god-extension-add`, `/god-extension-list`, `npx godpowers extension-scaffold --name=@godpowers/my-pack --output=.` |
+| Extend Godpowers | `/god-extension-scaffold --name=@godpowers/my-pack --output=.`, `/god-test-extension`, `/god-extension-add`, `/god-extension-list` |
 
 The same status engine is available from the installer CLI for humans, CI,
 Codex, Claude, Cursor, Gemini, OpenCode, Windsurf, Antigravity, and any host
@@ -498,7 +498,7 @@ Pi. T3 Code inherits from the underlying agent (Codex / Claude / OpenCode).
 - [Getting Started](docs/getting-started.md)
 - [Quick Proof](docs/quick-proof.md)
 - [Concepts](docs/concepts.md)
-- [Command reference (all 111 skills + 40 agents)](docs/reference.md)
+- [Command reference (all 112 skills + 40 agents)](docs/reference.md)
 - [Feature awareness](docs/feature-awareness.md)
 - [Adoption Canary](docs/adoption-canary.md)
 - [Repository documentation sync](docs/repo-doc-sync.md)

package/RELEASE.md

@@ -1,22 +1,35 @@
-# Godpowers 2.3.0 Release
+# Godpowers 2.3.1 Release
 
-> Status: Ready for release
-> Date: 2026-05-30
+> Status: Ready for package verification
+> Date: 2026-06-08
 
-Godpowers 2.3.0 is an accountability-hardening release for the 2.x line. It
-keeps the public slash-command surface stable while strengthening planning
-grounding, package legitimacy, install profiles, atomic persistence, and
-executor recovery.
+Godpowers 2.3.1 is an accountability and release-surface hardening release for
+the 2.x line. It strengthens planning grounding, package legitimacy, install
+profiles, atomic persistence, executor recovery, extension authoring,
+front-door route coverage, host capability reporting, and dashboard behavior.
 
 ## What's in this release
 
-- 111 slash commands
+- 112 slash commands
 - 40 specialist agents
 - 13 executable workflows
-- 41 intent recipes
+- 42 intent recipes
 
 ## Highlights
 
+- `/god-extension-scaffold` gives extension authors a first-class
+  slash-command path before `/god-test-extension` and `/god-extension-add`.
+- Public `/god` intent matching now covers the starter phrases users are most
+  likely to type: start a product, add a feature, fix production, audit an
+  existing repo, ship a release, maintain health, and extend Godpowers.
+- Quick Proof and README starter paths are now regression-tested against the
+  actual router and recipe engine.
+- User project dashboards no longer show maintainer-repository documentation
+  drift when a clean non-Godpowers project is inspected.
+- Host capability reporting now includes optional code-intelligence tooling
+  without treating missing optional tools as a host degradation.
+- Extension install, planning-system detection, and agent-cache cleanup are
+  hardened around symlinked paths that point outside trusted source trees.
 - Source-grounded planning records existing files, existing symbols, planned new
   artifacts, and unchecked references before build execution.
 - Package legitimacy checks give stack and dependency decisions a concrete npm
@@ -29,23 +42,27 @@ executor recovery.
   decompose, prune, or escalate.
 - Public migration language now uses neutral legacy-planning terminology so
   Godpowers is not confused with external workflow products.
+- Architecture docs now include an executable audit map for disconnected
+  commands, actions, workflows, recipes, and package surfaces.
 
 ## Validation
 
 - `npm test` green across the full suite
 - `npm run lint` clean
 - `npm run release:check` green (tests, audit, package contents)
+- `npm pack` creates a local `godpowers-2.3.1.tgz` tarball for package
+  inspection
 
 ## Upgrade
 
-- `npm install -g godpowers@2.3.0` or `npx godpowers@2.3.0`
+- `npm install -g godpowers@2.3.1` or `npx godpowers@2.3.1`
 - Re-run `/god-context` in each project to refresh installed runtime metadata
 - No breaking changes; existing `.godpowers/` state is compatible. Users who
   want a compact install can run `npx godpowers --profile=core`.
 
 ## Notes
 
-- GitHub release creation for `v2.3.0`
+- GitHub release creation for `v2.3.1`
 - The tag should match the npm package version
-- The `v2.3.0` tag should point to the release commit that matches the npm
-  `godpowers@2.3.0` package.
+- The `v2.3.1` tag should point to the release commit that matches the npm
+  `godpowers@2.3.1` package.

package/agents/god-debugger.md

@@ -1,8 +1,9 @@
 ---
 name: god-debugger
 description: |
-  Systematic 4-phase debugger: Observe, Hypothesize, Test, Conclude. No
-  guess-and-check. Evidence-driven root cause analysis with regression tests.
+  Systematic debugger: Observe, Minimize, Instrument, Hypothesize, Test,
+  Conclude. No guess-and-check. Evidence-driven root cause analysis with
+  regression tests.
 
   Spawned by: /god-debug, when build encounters failures
 tools: Read, Edit, Bash, Grep, Glob, WebSearch
@@ -22,10 +23,44 @@ Gather evidence before forming any hypothesis:
 - Can you reproduce it RELIABLY? (if not, find a reliable repro first)
 - All error messages, stack traces, logs (full text, not paraphrased)
 - What is NOT happening that should be? (sometimes the silence is the clue)
+- When available, use `ast-grep`, `sg`, or LSP diagnostics/references to
+  narrow impacted symbols before forming a hypothesis.
 
 Output an observation document. Don't proceed until observations are complete.
 
-## Phase 2: Hypothesize
+## Phase 2: Minimize
+
+Reduce the failure to the smallest reliable reproduction before proposing a
+root cause:
+
+- Remove unrelated inputs, branches, services, files, data, and timing from the
+  reproduction while keeping the failure present.
+- Identify the smallest command, test, request, or user flow that still fails.
+- Record the exact boundary where removing one more thing makes the failure
+  disappear.
+- If minimization is impossible, record why and name the remaining broad
+  dependency that keeps the repro large.
+
+Do not proceed until the minimized reproduction is clear enough that another
+agent could rerun it without guessing.
+
+## Phase 3: Instrument
+
+Add or use focused evidence probes before forming a hypothesis:
+
+- Prefer existing logs, traces, diagnostics, failing assertions, and debugger
+  output when they already expose the state transition.
+- Add temporary probes only when they answer a specific question, then remove
+  them before the final fix unless they become a useful permanent test or log.
+- Instrument the boundary between expected and actual behavior, not every
+  nearby function.
+- Capture the observed values and the point where reality diverges from the
+  expected path.
+
+Do not proceed until the instrumentation either narrows the failure boundary or
+proves that more observation is needed.
+
+## Phase 4: Hypothesize
 
 Based on observations, list 2-3 most likely root causes:
 
@@ -35,7 +70,7 @@ For each hypothesis:
 - What evidence would REFUTE this hypothesis?
 - Rank by probability (1-10) with rationale
 
-## Phase 3: Test
+## Phase 5: Test
 
 Take the highest-probability hypothesis. Design a SPECIFIC test:
 - The test should produce different evidence depending on which hypothesis is true
@@ -43,11 +78,12 @@ Take the highest-probability hypothesis. Design a SPECIFIC test:
 - Record the evidence
 - Compare to predicted outcomes
 
-If hypothesis confirmed: proceed to Phase 4.
+If hypothesis confirmed: proceed to Phase 6.
 If hypothesis refuted: cross it off, move to next hypothesis.
-If all hypotheses refuted: return to Phase 1, expand observation scope.
+If all hypotheses refuted: return to Phase 1, then revisit minimization and
+instrumentation with the new evidence.
 
-## Phase 4: Conclude (Fix and Verify)
+## Phase 6: Conclude (Fix and Verify)
 
 1. **Write the regression test FIRST**
    - The test should reproduce the bug
@@ -74,4 +110,4 @@ If all hypotheses refuted: return to Phase 1, expand observation scope.
 - **Never apply multiple fixes at once** (can't tell which one worked)
 - **Always write the regression test first** (locks in the contract)
 - **If the bug is in a dependency**: document the workaround, file upstream, link in commit
-- **Time-boxing**: if Phase 1-3 takes >2 hours with no progress, ask for help (the observations are likely incomplete)
+- **Time-boxing**: if Phase 1-5 takes >2 hours with no progress, ask for help (the observations are likely incomplete)

package/agents/god-executor.md

@@ -96,6 +96,34 @@ Every changed line must trace back to that contract, the failing test, or a
 cleanup created by your own change. If you cannot explain the trace, revert
 that line before returning control to the orchestrator.
 
+## Optional Style Profile
+
+If `CODEDNA.md` exists at the project root or appears in the provided context
+loadout, read it before editing:
+- Match the repo's naming, file organization, comment density, extraction
+  threshold, error handling style, and test idioms when they do not conflict
+  with the slice plan.
+- Treat formatter, linter, tests, and explicit project conventions as
+  higher-priority evidence when they conflict with the profile.
+- Do not invent or generate a `CODEDNA.md` profile in executor scope.
+- If no profile exists, continue by matching the surrounding code directly.
+- Preserve required `// Implements: P-...` annotations even when the profile
+  prefers fewer comments.
+
+## Optional Code Intelligence
+
+When host capabilities or local probing report `ast-grep`, `sg`, or LSP tools:
+- Use `ast-grep` or `sg` for structural search before broad text rewrites.
+- Use LSP diagnostics, definitions, references, or rename support when the
+  host exposes them for the touched language.
+- Treat these tools as evidence helpers, not authority. Tests, source
+  grounding, and request trace still decide whether the slice is complete.
+- Record the tool only when it shaped file selection, rewrite scope, or a
+  repair decision.
+
+If optional code intelligence is unavailable, continue with Grep, Glob, and
+Bash evidence. Absence of these tools is not a blocker.
+
 ## After All Behaviors Complete
 
 1. Run the full test suite. All tests must pass.

package/agents/god-quality-reviewer.md

@@ -63,6 +63,26 @@ Your job: would you ship this code in production?
 - Flag missing or inaccurate annotations: the deliverable ledger derives
   requirement status from them, so a gap here understates delivered work
 
+### 8. Comment Quality and Style Fidelity
+- Required traceability comments such as `// Implements: P-...` remain present
+  and accurate.
+- Comments explain non-obvious why, constraints, hazards, or tradeoffs. Flag
+  comments that narrate obvious code, duplicate names, go stale, or use generic
+  AI-assistant prose.
+- Avoid decorative section banners or chatty explanation unless the surrounding
+  codebase already uses that convention.
+- If `CODEDNA.md` exists, compare naming, comment voice, extraction threshold,
+  error style, test style, and common idioms against the profile.
+- Absence of `CODEDNA.md` is not a failure. When no profile exists, judge style
+  against nearby code and repository conventions.
+
+### 9. Optional Code Intelligence
+- When `ast-grep`, `sg`, or LSP tools are available, use them to support
+  maintainability review for structural matches, impacted references, or
+  diagnostics that plain grep can miss.
+- Absence of these tools is not a failure. Treat them as extra evidence when
+  present.
+
 ## Output
 
 Return verdict to orchestrator:
@@ -78,6 +98,8 @@ Return verdict to orchestrator:
 - [PASS/FAIL] Maintainability: [evidence]
 - [PASS/FAIL] Simplicity and surgicality: [evidence]
 - [PASS/FAIL] Requirement traceability: [evidence]
+- [PASS/FAIL] Comment quality and style fidelity: [evidence]
+- [PASS/FAIL] Optional code intelligence: [evidence or not applicable]
 
 ### Verdict: PASS / FAIL
 
@@ -86,7 +108,7 @@ Return verdict to orchestrator:
 
 ## Pass Criteria
 
-ALL seven dimensions must PASS. Any FAIL blocks the commit.
+ALL nine dimensions must PASS. Any FAIL blocks the commit.
 
 If FAIL: orchestrator returns the slice to god-executor.
 If PASS: orchestrator commits the slice atomically.

package/agents/god-spec-reviewer.md

@@ -65,6 +65,12 @@ Answer each with EVIDENCE from the code:
    - If the slice added a dependency, is there package legitimacy evidence or
      an explicit accepted-risk note?
 
+8. **Did available code intelligence support the review?**
+   - If `ast-grep`, `sg`, or LSP tools are available, use them to verify
+     impacted references, structural matches, or diagnostics for the touched
+     language when relevant.
+   - If unavailable or irrelevant, do not fail the slice for absence alone.
+
 ## Output
 
 Return verdict to orchestrator:

package/lib/README.md

@@ -13,7 +13,8 @@ package-level integrations.
 | `intent.js` | Read and validate `intent.yaml` from project roots or `.godpowers/`. |
 | `checkpoint.js` | Create and inspect resumable checkpoint artifacts. |
 | `feature-awareness.js` | Detect and refresh existing-project awareness after runtime upgrades. |
-| `host-capabilities.js` | Detect host guarantees for shell, git, npm, agent spawning, extension authoring, and suite dry-runs. |
+| `code-intelligence.js` | Detect optional `ast-grep`, `sg`, and LSP tooling for structural search, rewrite, and diagnostics guidance. |
+| `host-capabilities.js` | Detect host guarantees for shell, git, npm, agent spawning, optional code intelligence, extension authoring, and suite dry-runs. |
 | `repo-doc-sync.js` | Detect and refresh mechanical repository documentation surfaces. |
 | `repo-surface-sync.js` | Detect structural drift across commands, routes, packages, agents, workflows, recipes, extensions, and release policy. |
 | `route-quality-sync.js` | Detect symbolic route spawns, unresolved agent targets, and unapproved contextual route exits. |

package/lib/agent-cache.js

@@ -134,9 +134,29 @@ function clear(projectRoot, opts = {}) {
   const now = Date.now();
   for (const shard of fs.readdirSync(dir)) {
     const shardPath = path.join(dir, shard);
-    if (!fs.statSync(shardPath).isDirectory()) continue;
+    const shardStat = fs.lstatSync(shardPath);
+    if (shardStat.isSymbolicLink()) {
+      if (opts.all) {
+        fs.unlinkSync(shardPath);
+        removed++;
+      } else {
+        kept++;
+      }
+      continue;
+    }
+    if (!shardStat.isDirectory()) continue;
     for (const fname of fs.readdirSync(shardPath)) {
       const fpath = path.join(shardPath, fname);
+      const fileStat = fs.lstatSync(fpath);
+      if (fileStat.isSymbolicLink()) {
+        if (opts.all) { fs.unlinkSync(fpath); removed++; }
+        else { kept++; }
+        continue;
+      }
+      if (!fileStat.isFile()) {
+        kept++;
+        continue;
+      }
       let entry;
       try { entry = JSON.parse(fs.readFileSync(fpath, 'utf8')); }
       catch (e) {
@@ -173,10 +193,12 @@ function stats(projectRoot) {
   let oldestTs = null;
   for (const shard of fs.readdirSync(dir)) {
     const shardPath = path.join(dir, shard);
-    if (!fs.statSync(shardPath).isDirectory()) continue;
+    const shardStat = fs.lstatSync(shardPath);
+    if (shardStat.isSymbolicLink() || !shardStat.isDirectory()) continue;
     for (const fname of fs.readdirSync(shardPath)) {
       const fpath = path.join(shardPath, fname);
-      const stat = fs.statSync(fpath);
+      const stat = fs.lstatSync(fpath);
+      if (stat.isSymbolicLink() || !stat.isFile()) continue;
       totalBytes += stat.size;
       count += 1;
       try {

package/lib/code-intelligence.js

@@ -0,0 +1,161 @@
+/**
+ * Optional code intelligence capability detection.
+ *
+ * These tools sharpen refactors and reviews when present, but Godpowers must
+ * keep working through grep-backed workflows when they are absent.
+ */
+
+const cp = require('child_process');
+
+const AST_GREP_CANDIDATES = [
+  { id: 'ast-grep', command: 'ast-grep', args: ['--version'], match: /ast-grep/i },
+  { id: 'sg', command: 'sg', args: ['--version'], match: /\b(ast-grep|sg\s+\d)/i }
+];
+
+const LSP_CANDIDATES = [
+  { id: 'omo-lsp', command: 'omo-lsp', args: ['--version'], languages: ['multi'] },
+  { id: 'typescript-language-server', command: 'typescript-language-server', args: ['--version'], languages: ['javascript', 'typescript'] },
+  { id: 'vscode-json-language-server', command: 'vscode-json-language-server', args: ['--version'], languages: ['json'] },
+  { id: 'yaml-language-server', command: 'yaml-language-server', args: ['--version'], languages: ['yaml'] },
+  { id: 'pyright-langserver', command: 'pyright-langserver', args: ['--version'], languages: ['python'] },
+  { id: 'pylsp', command: 'pylsp', args: ['--version'], languages: ['python'] },
+  { id: 'gopls', command: 'gopls', args: ['version'], languages: ['go'] },
+  { id: 'rust-analyzer', command: 'rust-analyzer', args: ['--version'], languages: ['rust'] },
+  { id: 'clangd', command: 'clangd', args: ['--version'], languages: ['c', 'cpp'] },
+  { id: 'jdtls', command: 'jdtls', args: ['--version'], languages: ['java'] },
+  { id: 'ruby-lsp', command: 'ruby-lsp', args: ['--version'], languages: ['ruby'] },
+  { id: 'solargraph', command: 'solargraph', args: ['--version'], languages: ['ruby'] },
+  { id: 'terraform-ls', command: 'terraform-ls', args: ['version'], languages: ['terraform'] }
+];
+
+function firstLine(value) {
+  if (!value) return null;
+  const text = String(value).trim();
+  if (!text) return null;
+  return text.split(/\r?\n/)[0] || 'installed';
+}
+
+function commandVersion(command, args, opts = {}) {
+  try {
+    const out = cp.execFileSync(command, args, {
+      cwd: opts.cwd || process.cwd(),
+      encoding: 'utf8',
+      stdio: ['ignore', 'pipe', 'ignore'],
+      timeout: opts.timeout || 800
+    });
+    return firstLine(out) || 'installed';
+  } catch (err) {
+    return null;
+  }
+}
+
+function checkCandidate(candidate, opts) {
+  const version = firstLine(opts.commandVersion(candidate.command, candidate.args, {
+    cwd: opts.cwd,
+    timeout: opts.timeout
+  }));
+  if (!version) return null;
+  if (candidate.match && !candidate.match.test(version)) return null;
+  return {
+    id: candidate.id,
+    command: candidate.command,
+    version,
+    languages: candidate.languages || []
+  };
+}
+
+function detectFirst(candidates, opts) {
+  for (const candidate of candidates) {
+    const found = checkCandidate(candidate, opts);
+    if (found) return found;
+  }
+  return null;
+}
+
+function detectAll(candidates, opts) {
+  const found = [];
+  const limit = opts.maxTools || 5;
+  for (const candidate of candidates) {
+    const result = checkCandidate(candidate, opts);
+    if (result) found.push(result);
+    if (found.length >= limit) break;
+  }
+  return found;
+}
+
+function detect(projectRoot, opts = {}) {
+  const root = projectRoot || process.cwd();
+  const probe = opts.commandVersion || commandVersion;
+  const probeOpts = {
+    cwd: root,
+    commandVersion: probe,
+    timeout: opts.timeout || 800,
+    maxTools: opts.maxTools || 5
+  };
+
+  const astGrep = detectFirst(opts.astGrepCandidates || AST_GREP_CANDIDATES, probeOpts);
+  const lspTools = detectAll(opts.lspCandidates || LSP_CANDIDATES, probeOpts);
+  const gaps = [];
+  if (!astGrep) gaps.push('ast-grep not detected');
+  if (lspTools.length === 0) gaps.push('LSP tools not detected');
+
+  return {
+    level: astGrep || lspTools.length > 0 ? 'available' : 'not-detected',
+    astGrep: astGrep
+      ? { available: true, command: astGrep.command, version: astGrep.version }
+      : { available: false, command: null, version: null },
+    lsp: {
+      available: lspTools.length > 0,
+      primary: lspTools[0] || null,
+      tools: lspTools
+    },
+    gaps
+  };
+}
+
+function lspSummary(lsp) {
+  if (!lsp || !lsp.available) return 'not detected';
+  return lsp.tools.map(tool => tool.command).join(', ');
+}
+
+function summary(report) {
+  if (!report) return 'not detected';
+  const parts = [];
+  if (report.astGrep && report.astGrep.available) {
+    parts.push(`ast-grep via ${report.astGrep.command}`);
+  }
+  if (report.lsp && report.lsp.available) {
+    parts.push(`LSP via ${lspSummary(report.lsp)}`);
+  }
+  return parts.length > 0 ? parts.join('; ') : 'not detected';
+}
+
+function render(report) {
+  const ast = report && report.astGrep && report.astGrep.available
+    ? `${report.astGrep.command} (${report.astGrep.version})`
+    : 'not detected';
+  const lsp = report && report.lsp && report.lsp.available
+    ? lspSummary(report.lsp)
+    : 'not detected';
+  const gaps = report && report.gaps && report.gaps.length > 0
+    ? report.gaps.join('; ')
+    : 'none';
+  return [
+    'Code intelligence:',
+    `  Structural search: ${ast}`,
+    `  LSP tools: ${lsp}`,
+    `  Gaps: ${gaps}`
+  ].join('\n');
+}
+
+module.exports = {
+  detect,
+  summary,
+  render,
+  _private: {
+    AST_GREP_CANDIDATES,
+    LSP_CANDIDATES,
+    commandVersion,
+    firstLine
+  }
+};

package/lib/dashboard.js

@@ -133,20 +133,43 @@ function hasRecentPath(projectRoot, relPath, maxAgeMs) {
   return Date.now() - modified <= maxAgeMs;
 }
 
-function proactiveChecks(projectRoot, changedFiles = []) {
+function isGodpowersRuntimeRepo(projectRoot) {
+  try {
+    const pkgPath = path.join(projectRoot, 'package.json');
+    if (!fs.existsSync(pkgPath)) return false;
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+    return pkg.name === 'godpowers'
+      && exists(projectRoot, 'skills')
+      && exists(projectRoot, 'routing')
+      && exists(projectRoot, 'agents');
+  } catch (e) {
+    return false;
+  }
+}
+
+function proactiveChecks(projectRoot, changedFiles = [], opts = {}) {
   const oneDay = 24 * 60 * 60 * 1000;
   const thirtyDays = 30 * oneDay;
+  const initialized = opts.initialized !== false;
+  const runtimeRepo = opts.runtimeRepo !== undefined
+    ? opts.runtimeRepo
+    : isGodpowersRuntimeRepo(projectRoot);
   const reviews = reviewCount(projectRoot);
 
-  const checkpoint = exists(projectRoot, CHECKPOINT_PATH)
-    ? (hasRecentPath(projectRoot, CHECKPOINT_PATH, oneDay) ? 'fresh' : 'stale')
-    : 'missing';
+  const checkpoint = initialized
+    ? (exists(projectRoot, CHECKPOINT_PATH)
+        ? (hasRecentPath(projectRoot, CHECKPOINT_PATH, oneDay) ? 'fresh' : 'stale')
+        : 'missing')
+    : 'not-applicable';
 
-  const sync = exists(projectRoot, SYNC_LOG_PATH)
-    ? (hasRecentPath(projectRoot, SYNC_LOG_PATH, oneDay) ? 'fresh' : 'stale, suggest /god-sync')
-    : 'missing, suggest /god-sync';
+  const sync = initialized
+    ? (exists(projectRoot, SYNC_LOG_PATH)
+        ? (hasRecentPath(projectRoot, SYNC_LOG_PATH, oneDay) ? 'fresh' : 'stale, suggest /god-sync')
+        : 'missing, suggest /god-sync')
+    : 'not-applicable';
 
-  const hygieneFresh = exists(projectRoot, CHECKPOINT_PATH)
+  const hygieneFresh = initialized
+    && exists(projectRoot, CHECKPOINT_PATH)
     && hasRecentPath(projectRoot, CHECKPOINT_PATH, thirtyDays);
 
   const pkgChanged = changedFiles.some(file => [
@@ -162,14 +185,22 @@ function proactiveChecks(projectRoot, changedFiles = []) {
     'auth',
     'security'
   ]));
-  const repoDocs = repoDocSync.detect(projectRoot, { changedFiles });
-  const repoDocsStatus = repoDocs.status === 'fresh'
-    ? 'fresh'
-    : `${repoDocs.stale.length} stale, suggest /god-docs`;
-  const repoSurface = repoSurfaceSync.detect(projectRoot);
-  const repoSurfaceStatus = repoSurface.status === 'fresh'
-    ? 'fresh'
-    : `${repoSurface.stale.length} stale, suggest /god-doctor`;
+  const repoDocsStatus = runtimeRepo
+    ? (() => {
+        const repoDocs = repoDocSync.detect(projectRoot, { changedFiles });
+        return repoDocs.status === 'fresh'
+          ? 'fresh'
+          : `${repoDocs.stale.length} stale, suggest /god-docs`;
+      })()
+    : 'not-applicable';
+  const repoSurfaceStatus = runtimeRepo
+    ? (() => {
+        const repoSurface = repoSurfaceSync.detect(projectRoot);
+        return repoSurface.status === 'fresh'
+          ? 'fresh'
+          : `${repoSurface.stale.length} stale, suggest /god-doctor`;
+      })()
+    : 'not-applicable';
   const host = hostCapabilities.detect(projectRoot);
 
   return {
@@ -183,7 +214,7 @@ function proactiveChecks(projectRoot, changedFiles = []) {
     automation: automationSummary(projectRoot),
     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'
+    hygiene: initialized ? (hygieneFresh ? 'fresh' : 'stale, suggest /god-hygiene') : 'not-applicable'
   };
 }
 
@@ -237,7 +268,7 @@ function compute(projectRoot, opts = {}) {
         completion: '0% workflow progress because .godpowers/state.json is missing',
         completionBasis: 'missing .godpowers/state.json'
       },
-      proactive: proactiveChecks(projectRoot, git.entries.map(statusPath)),
+      proactive: proactiveChecks(projectRoot, git.entries.map(statusPath), { initialized: false }),
       host: hostCapabilities.detect(projectRoot, opts.host || {}),
       next,
       deliverables: { hasRequirements: false },
@@ -276,7 +307,7 @@ function compute(projectRoot, opts = {}) {
     worktree: git.worktree,
     index: git.index,
     planning: planningVisibility(projectRoot, progress),
-    proactive: proactiveChecks(projectRoot, git.entries.map(statusPath)),
+    proactive: proactiveChecks(projectRoot, git.entries.map(statusPath), { initialized: true }),
     host: hostCapabilities.detect(projectRoot, opts.host || {}),
     next,
     deliverables,
@@ -289,6 +320,7 @@ function compute(projectRoot, opts = {}) {
 function actionBrief(dashboard) {
   const proactive = dashboard.proactive || {};
   const next = dashboard.next || {};
+  const recommended = next.command || 'describe the next intent';
   const blockers = [];
   for (const [label, value] of [
     ['Repo surface', proactive.repoSurface],
@@ -304,10 +336,11 @@ function actionBrief(dashboard) {
     if (value === 'fresh' || value === 'none' || value === 'clear' || value === 'not-applicable') continue;
     if (/^full on /.test(value)) continue;
     if (/^available via /.test(value)) continue;
+    if (label === 'Sync' && recommended !== '/god-sync') continue;
+    if (label === 'Hygiene' && recommended !== '/god-hygiene') continue;
     blockers.push(`${label}: ${value}`);
   }
 
-  const recommended = next.command || 'describe the next intent';
   return {
     recommended,
     reason: next.reason || 'No route was computed.',
@@ -414,6 +447,7 @@ module.exports = {
   parseGitStatus,
   proactiveChecks,
   automationSummary,
+  isGodpowersRuntimeRepo,
   actionBrief,
   planningVisibility
 };

package/lib/extensions.js

@@ -27,6 +27,7 @@ const fs = require('fs');
 const path = require('path');
 
 const intentLib = require('./intent'); // reuses parseSimpleYaml
+const { copyRecursive } = require('./installer-files');
 
 function extensionsDir(runtimeConfigDir) {
   return path.join(runtimeConfigDir, 'godpowers-extensions');
@@ -159,11 +160,13 @@ function list(runtimeConfigDir) {
   const results = [];
   for (const scope of fs.readdirSync(dir)) {
     const scopePath = path.join(dir, scope);
-    if (!fs.statSync(scopePath).isDirectory()) continue;
+    const scopeStat = fs.lstatSync(scopePath);
+    if (scopeStat.isSymbolicLink() || !scopeStat.isDirectory()) continue;
     if (!scope.startsWith('@')) continue;
     for (const name of fs.readdirSync(scopePath)) {
       const packDir = path.join(scopePath, name);
-      if (!fs.statSync(packDir).isDirectory()) continue;
+      const packStat = fs.lstatSync(packDir);
+      if (packStat.isSymbolicLink() || !packStat.isDirectory()) continue;
       const manifestFile = path.join(packDir, 'manifest.yaml');
       if (!fs.existsSync(manifestFile)) continue;
       const { manifest } = parseManifest(fs.readFileSync(manifestFile, 'utf8'));
@@ -220,22 +223,12 @@ function install(runtimeConfigDir, sourceDir, godpowersVersion) {
   for (const sub of ['agents', 'skills', 'workflows', 'references']) {
     const src = path.join(sourceDir, sub);
     if (fs.existsSync(src)) {
-      copyDirRecursive(src, path.join(destDir, sub));
+      copyRecursive(src, path.join(destDir, sub));
     }
   }
   return { installed: true, path: destDir, manifest };
 }
 
-function copyDirRecursive(src, dest) {
-  fs.mkdirSync(dest, { recursive: true });
-  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
-    const s = path.join(src, entry.name);
-    const d = path.join(dest, entry.name);
-    if (entry.isDirectory()) copyDirRecursive(s, d);
-    else fs.copyFileSync(s, d);
-  }
-}
-
 /**
  * Remove an installed extension by name.
  */

package/lib/feature-awareness.js

@@ -110,7 +110,7 @@ const FEATURES = [
   {
     id: 'extension-authoring',
     since: '1.6.22',
-    commands: ['/god-extension-add', '/god-test-extension'],
+    commands: ['/god-extension-scaffold', '/god-test-extension', '/god-extension-add'],
     description: 'Scaffold and validate publishable Godpowers extension packs.'
   },
   {

package/lib/host-capabilities.js

@@ -10,6 +10,7 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 const cp = require('child_process');
+const codeIntelligence = require('./code-intelligence');
 
 function exists(filePath) {
   return fs.existsSync(filePath);
@@ -55,6 +56,7 @@ function detect(projectRoot, opts = {}) {
   const git = commandVersion('git', ['--version'], { cwd: root });
   const npm = commandVersion('npm', ['--version'], { cwd: root });
   const gh = commandVersion('gh', ['--version'], { cwd: root });
+  const codeIntel = opts.codeIntelligence || codeIntelligence.detect(root, opts.codeIntelligenceOpts || {});
   const shell = Boolean(env.SHELL || env.ComSpec);
   const agentSpawn = Boolean(installedAgents.codex || installedAgents.claude || opts.agentSpawn);
   const extensionAuthoring = exists(path.join(root, 'lib', 'extension-authoring.js'))
@@ -84,6 +86,7 @@ function detect(projectRoot, opts = {}) {
       npm,
       gh,
       agentSpawn,
+      codeIntelligence: codeIntel,
       extensionAuthoring,
       suiteReleaseDryRun
     },
@@ -109,6 +112,7 @@ function render(report) {
   lines.push(`  Git: ${report.guarantees.git || 'not detected'}`);
   lines.push(`  npm: ${report.guarantees.npm || 'not detected'}`);
   lines.push(`  GitHub CLI: ${report.guarantees.gh || 'not detected'}`);
+  lines.push(`  Code intelligence: ${codeIntelligence.summary(report.guarantees.codeIntelligence)}`);
   lines.push(`  Gaps: ${report.gaps.length > 0 ? report.gaps.join('; ') : 'none'}`);
   return lines.join('\n');
 }

package/lib/install-profiles.js

@@ -70,6 +70,7 @@ const PROFILE_SKILLS = {
     'god-migrate',
     'god-automation-status',
     'god-automation-setup',
+    'god-extension-scaffold',
     'god-extension-add',
     'god-extension-list',
     'god-extension-info',

package/lib/planning-systems.js

@@ -112,7 +112,7 @@ function hashFiles(projectRoot, files) {
   for (const file of files.map((f) => f.path).sort()) {
     const full = path.join(projectRoot, file);
     h.update(file);
-    if (fs.existsSync(full) && fs.statSync(full).isFile()) {
+    if (fs.existsSync(full) && fs.lstatSync(full).isFile()) {
       h.update(fs.readFileSync(full));
     }
   }
@@ -125,8 +125,10 @@ function isTextFile(filePath) {
 
 function readText(projectRoot, relPath) {
   const full = path.join(projectRoot, relPath);
-  if (!fs.existsSync(full) || !fs.statSync(full).isFile()) return '';
-  const size = fs.statSync(full).size;
+  if (!fs.existsSync(full)) return '';
+  const stat = fs.lstatSync(full);
+  if (!stat.isFile()) return '';
+  const size = stat.size;
   const buffer = fs.readFileSync(full);
   const raw = buffer.slice(0, Math.min(size, MAX_FILE_BYTES)).toString('utf8');
   return raw.replace(/\r\n/g, '\n');
@@ -134,7 +136,8 @@ function readText(projectRoot, relPath) {
 
 function walkFiles(rootDir, projectRoot, out = []) {
   if (!fs.existsSync(rootDir) || out.length >= MAX_SYSTEM_FILES) return out;
-  const stat = fs.statSync(rootDir);
+  const stat = fs.lstatSync(rootDir);
+  if (stat.isSymbolicLink()) return out;
   if (stat.isFile()) {
     if (isTextFile(rootDir)) out.push(rel(projectRoot, rootDir));
     return out;

package/lib/quick-proof.js

@@ -93,6 +93,9 @@ function render(proof, opts = {}) {
   const next = proof.dashboard.next || {};
   const progress = proof.dashboard.progress || {};
   const planning = proof.dashboard.planning || {};
+  const projectCommandRoot = path.resolve(proof.projectRoot) === path.resolve(proof.fixtureRoot)
+    ? '.'
+    : proof.projectRoot;
 
   if (opts.brief) {
     return [
@@ -140,8 +143,8 @@ function render(proof, opts = {}) {
     `  npx godpowers next --project=${proof.fixtureRoot} --brief`,
     '',
     'Try it on your project:',
-    `  npx godpowers status --project=${proof.projectRoot} --brief`,
-    `  npx godpowers next --project=${proof.projectRoot} --brief`
+    `  npx godpowers status --project=${projectCommandRoot} --brief`,
+    `  npx godpowers next --project=${projectCommandRoot} --brief`
   ].join('\n');
 }
 

package/lib/route-quality-sync.js

@@ -27,6 +27,7 @@ const CONTEXTUAL_NEXT_ALLOWED = new Set([
   '/god-extension-info',
   '/god-extension-list',
   '/god-extension-remove',
+  '/god-extension-scaffold',
   '/god-graph',
   '/god-help',
   '/god-lifecycle',
@@ -61,6 +62,7 @@ const STANDARDS_EXEMPT_COMMANDS = new Set([
   '/god-progress',
   '/god-reconstruct',
   '/god-roadmap-check',
+  '/god-extension-scaffold',
   '/god-smite',
   '/god-tech-debt'
 ]);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "godpowers",
-  "version": "2.3.0",
-  "description": "AI-powered development system: 111 slash commands and 40 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.",
+  "version": "2.3.1",
+  "description": "AI-powered development system: 112 slash commands and 40 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"
   },

package/routing/god-extension-scaffold.yaml

@@ -0,0 +1,25 @@
+apiVersion: godpowers/v1
+kind: CommandRouting
+metadata:
+  command: /god-extension-scaffold
+  description: Create a publishable extension pack skeleton
+  tier: 0
+
+prerequisites:
+  required: []
+
+execution:
+  spawns: [built-in]
+  context: fresh
+  writes:
+    - extension pack skeleton
+
+success-path:
+  next-recommended: /god-test-extension
+
+failure-path:
+  on-error: /god-doctor
+
+endoff:
+  state-update: tier-0 updated for /god-extension-scaffold
+  events: [agent.start, artifact.created, agent.end]

package/routing/god-stack.yaml

@@ -30,7 +30,7 @@ standards:
   gate-on-failure: pause-for-user
 
 success-path:
-  next-recommended: /god-design
+  next-recommended: /god-repo
   conditional-next:
     - condition: ui-detected
       next: /god-design

package/routing/recipes/add-feature-mid-arc-pause.yaml

@@ -11,6 +11,12 @@ triggers:
     - "mid development"
     - "pause arc"
     - "feature during build"
+    - "add a feature"
+    - "feature addition"
+    - "add a feature during the current project run"
+    - "add a feature without breaking the current project run"
+    - "without breaking current project run"
+    - "do not disturb current work"
   state-conditions:
     - "lifecycle-phase == in-arc"
 

package/routing/recipes/brownfield-onboarding.yaml

@@ -11,6 +11,9 @@ triggers:
     - "inherit codebase"
     - "legacy code"
     - "understand existing"
+    - "audit an existing repo"
+    - "audit existing repo"
+    - "audit existing codebase"
   state-conditions:
     - "has-package-json"
 
@@ -24,10 +27,10 @@ sequences:
         why: "Deep history, decisions, conventions, risks"
       - command: "/god-reconstruct"
         why: "Reverse-engineer PRD/ARCH/ROADMAP/STACK from code"
-      - command: "/god-tech-debt"
-        why: "Categorize and prioritize debt"
       - command: "/god-audit"
         why: "Score reconstructed artifacts"
+      - command: "/god-tech-debt"
+        why: "Categorize and prioritize debt"
       - command: "/god-feature"
         why: "Now safe to add new work with reconciliation"
 

package/routing/recipes/extension-authoring.yaml

@@ -0,0 +1,32 @@
+apiVersion: godpowers/v1
+kind: Recipe
+metadata:
+  name: extension-authoring
+  category: extension
+  description: "Create, test, install, and verify a Godpowers extension pack"
+
+triggers:
+  intent-keywords:
+    - "create extension pack"
+    - "create an extension pack"
+    - "author extension pack"
+    - "new extension pack"
+    - "scaffold extension"
+    - "build extension pack"
+    - "extend godpowers"
+    - "make a pack"
+
+sequences:
+  default:
+    description: "Create, test, install, and verify a Godpowers extension pack"
+    steps:
+      - command: "/god-extension-scaffold --name=@godpowers/my-pack --output=."
+        why: "Create the manifest, package, README, skill, and optional agent or workflow skeleton"
+      - command: "/god-test-extension <pack-dir>"
+        why: "Run contract tests before install or publish"
+      - command: "/god-extension-add <pack-dir>"
+        why: "Install the passing pack into the active runtime"
+      - command: "/god-extension-list"
+        why: "Verify the installed pack appears with its provided commands"
+
+default-sequence: default

package/routing/recipes/greenfield-fast.yaml

@@ -12,6 +12,9 @@ triggers:
     - "greenfield"
     - "new project"
     - "idea to production"
+    - "start a product"
+    - "start product"
+    - "build a product"
   state-conditions:
     - "no-godpowers-dir"
 

package/routing/recipes/production-broken.yaml

@@ -8,6 +8,10 @@ metadata:
 triggers:
   intent-keywords:
     - "production down"
+    - "production is broken"
+    - "production broken"
+    - "fix production"
+    - "prod is broken"
     - "urgent"
     - "p0"
     - "p1"

package/routing/recipes/release-maintenance.yaml

@@ -12,6 +12,9 @@ triggers:
     - "update readme badge"
     - "release notes"
     - "package release"
+    - "ship a release"
+    - "release the project"
+    - "prepare release"
 
 sequences:
   default:

package/routing/recipes/returning-after-break.yaml

@@ -11,6 +11,9 @@ triggers:
     - "after break"
     - "pick up where left"
     - "resume project"
+    - "coming back after a week"
+    - "back after a week"
+    - "coming back"
   state-conditions:
     - "file:.godpowers/PROGRESS.md"
 

package/routing/recipes/weekly-health-check.yaml

@@ -11,6 +11,8 @@ triggers:
     - "health check"
     - "hygiene"
     - "project health"
+    - "maintain project health"
+    - "maintain health"
   state-conditions:
     - "lifecycle-phase == steady-state-active"
 

package/skills/god-discuss.md

@@ -11,7 +11,7 @@ description: |
 
 # /god-discuss
 
-Pre-planning Socratic discussion with domain grilling.
+Pre-planning Socratic discussion with domain and plan grilling.
 
 ## When to use
 
@@ -31,10 +31,15 @@ The agent:
 4. Explores the codebase instead of asking when repo evidence can answer
 5. Challenges vague, overloaded, or conflicting terms against the glossary
 6. Stress-tests domain relationships with concrete scenarios and edge cases
-7. Surfaces 2-3 hidden assumptions
-8. Identifies what's [DECISION] vs [HYPOTHESIS] vs [OPEN QUESTION]
-9. Drafts a brief in `.godpowers/discussions/<topic>.md`
-10. Updates `.godpowers/domain/GLOSSARY.md` when a term or ambiguity is resolved
+7. Attempts to falsify the proposed plan before accepting it:
+   - What breaks if the smallest happy path is wrong?
+   - Which dependency, user behavior, or edge case could invalidate the plan?
+   - What would make this scope too broad for one safe slice?
+   - What evidence would change the recommended next command?
+8. Surfaces 2-3 hidden assumptions
+9. Identifies what's [DECISION] vs [HYPOTHESIS] vs [OPEN QUESTION]
+10. Drafts a brief in `.godpowers/discussions/<topic>.md`
+11. Updates `.godpowers/domain/GLOSSARY.md` when a term or ambiguity is resolved
 
 The brief and glossary get passed to the next planning command. The glossary is
 preparation context, not a replacement for PRD, ARCH, ROADMAP, STACK, or Pillars

package/skills/god-doctor.md

@@ -48,9 +48,9 @@ Plain-text report grouped by severity:
 GODPOWERS DOCTOR
 
 Install: claude (~/.claude/)
-  [OK] 111 skills installed
+  [OK] 112 skills installed
   [OK] 40 agents installed
-  [OK] VERSION matches (2.3.0)
+  [OK] VERSION matches (2.3.1)
   [WARN] routing/god-doctor.yaml exists but skill file did not until now
 
 Project: /Users/.../my-project/.godpowers/
@@ -114,6 +114,12 @@ as a read-only diagnostic. It reports:
 `/god-doctor --fix` may call `lib/feature-awareness.run(projectRoot)` because
 that helper writes only safe state metadata and managed context fences.
 
+## Host Capability Reporting
+
+`/god-doctor` reports optional code intelligence when `ast-grep`, `sg`, or LSP
+tools are available. Missing code intelligence is diagnostic context only; it
+does not make the host degraded.
+
 ## Repo Documentation Sync
 
 For initialized projects, `/god-doctor` calls `lib/repo-doc-sync.detect` as a

package/skills/god-extension-scaffold.md

@@ -0,0 +1,66 @@
+---
+name: god-extension-scaffold
+description: |
+  Create a publishable Godpowers extension pack skeleton from inside the
+  slash-command UX. Wraps the same extension authoring helper exposed by
+  `npx godpowers extension-scaffold`, then routes to contract testing.
+
+  Triggers on: "god extension scaffold", "/god-extension-scaffold",
+  "create extension pack", "author extension pack", "new extension pack",
+  "extend godpowers"
+---
+
+# /god-extension-scaffold
+
+Create a Godpowers extension pack skeleton.
+
+## Usage
+
+### `/god-extension-scaffold --name=@godpowers/my-pack --output=.`
+
+Optional arguments:
+
+- `--skill=custom-pack-command` sets the generated skill name.
+- `--agent=custom-pack-agent` creates a generated agent contract.
+- `--workflow=my-pack-workflow` creates a generated workflow YAML.
+- `--overwrite` allows replacing existing scaffold files.
+
+## Process
+
+1. Parse the requested package name, output root, optional skill, optional
+   agent, and optional workflow.
+2. Call `lib/extension-authoring.js scaffold(...)`.
+3. Validate the generated `manifest.yaml` against the extension manifest
+   contract.
+4. Report the created pack path and written files.
+5. Suggest `/god-test-extension <pack-dir>` before install or publish.
+
+## Output
+
+```
+Extension scaffold created: ./godpowers-my-pack
+
+Written:
+  manifest.yaml
+  package.json
+  README.md
+  skills/custom-pack-command.md
+
+Suggested next: /god-test-extension ./godpowers-my-pack
+```
+
+## Implementation
+
+Built-in. Calls `lib/extension-authoring.js scaffold(...)`.
+
+The terminal equivalent remains:
+
+```bash
+npx godpowers extension-scaffold --name=@godpowers/my-pack --output=.
+```
+
+## Related
+
+- `/god-test-extension <path>` - contract test the pack before install or publish
+- `/god-extension-add <path>` - install a passing pack
+- `/god-extension-list` - verify the pack is visible in the runtime

package/skills/god-version.md

@@ -14,9 +14,9 @@ Print version and a short capability summary.
 ## Output
 
 ```
-Godpowers v2.3.0
+Godpowers v2.3.1
 Install: /Users/.../.claude/  (matches package.json)
-Surface: 111 skills, 40 agents, 13 workflows, 41 recipes
+Surface: 112 skills, 40 agents, 13 workflows, 42 recipes
 Schema: intent.v1, state.v1, events.v1, workflow.v1, routing.v1, recipe.v1
 External integrations available: impeccable, agent-browser (others lazy)
 Feature awareness: planning-system migration, source-system sync-back, context refresh, dashboard status labels, repo documentation sync, repo surface sync, quick proof, request trace, release hardening, maintenance hardening

package/skills/god.md

@@ -160,13 +160,11 @@ any destructive sequence executes.
 ```
 User: /god production is broken
 
-Match: production-broken (score: 30)
-What this does: P0 incident response with rollback-first triage
+Match: production-broken (score: 20)
+What this does: Production is broken now
 
 Sequence:
-  1. /god-hotfix     Spawn god-debugger for fast triage
-  2. /god-deploy     Push the fix once green
-  3. /god-postmortem Schedule the incident review
+  1. /god-hotfix     Skip planning, debug, fix with TDD, expedited deploy, schedule postmortem
 
 Run this sequence? (yes / show others / cancel)
 ```
@@ -174,15 +172,14 @@ Run this sequence? (yes / show others / cancel)
 ### Example 2: ambiguous intent (multiple matches)
 
 ```
-User: /god add a new feature
+User: /god parallel feature during build
 
-Top matches for "add a new feature":
+Top matches for "parallel feature during build":
 
-  1. add-feature-mid-arc-pause       (15)   Pause /god-mode, run feature, resume
-  2. add-feature-small               (10)   Lightweight feature, no project-run context
-  3. add-feature-next-milestone      (10)   Defer to next milestone
+  1. add-feature-mid-arc-pause       (10)   Bigger feature during the current project run; reconcile with roadmap, pause, do feature, update roadmap, resume
+  2. add-feature-parallel            (10)   Parallel feature, do not disrupt main work
 
-Pick one (1/2/3) or describe more specifically.
+Pick one (1/2) or describe more specifically.
 ```
 
 ### Example 3: state-driven (no text)