godpowers 1.6.21 → 1.6.23

package/AGENTS.md

@@ -15,10 +15,14 @@ projects from raw idea to hardened production.
 
 - `SKILL.md` is the main entry point, loaded by AI coding tools
 - `skills/` contains individual command skills (one per file)
+- `routing/` contains command routing metadata and intent recipes
+- `workflows/` contains executable workflow YAML
 - `references/` contains per-tier reference material (antipatterns, examples)
 - `bin/` contains the CLI installer and `god` command
+- `lib/` contains executable runtime helpers, sync checks, dogfood, dashboard, and release logic
 - `scripts/` contains validation and testing scripts
 - `templates/` contains artifact templates
+- `fixtures/dogfood/` contains messy-repo release dogfood scenarios
 
 ## Conventions
 
@@ -27,6 +31,8 @@ projects from raw idea to hardened production.
 - Every tier skill documents its have-nots (failure modes)
 - Artifacts are written to `.godpowers/<tier>/` paths
 - State is tracked in `.godpowers/PROGRESS.md`
+- Dashboard state is computed by `lib/dashboard.js`
+- Repo docs, repo surface, route quality, recipe coverage, release surface, host capability, and dogfood checks are executable release gates
 - Disk state is authoritative; conversation memory is not
 
 ## Quality Rules

package/CHANGELOG.md

@@ -7,6 +7,81 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.6.23] - 2026-05-16
+
+Full repository audit, release gate hardening, and documentation repair.
+
+### Added
+- Added `.planning/2026-05-16-surface-sync-status.md` to record the current
+  `.github/workflows`, `.planning`, and `agents` sync status without rewriting
+  historical planning evidence.
+- Expanded `god-reconciler` and `god-updater` contracts so repo docs, repo
+  surface, runtime feature awareness, source-system sync-back, host capability,
+  and dashboard refresh are checked and reported as part of the same loop.
+- Documented the audited source scan across root docs, `.github`, `.godpowers`,
+  `.planning`, agents, docs, examples, extensions, fixtures, hooks, lib,
+  references, routing, schema, scripts, skills, templates, tests, and workflows.
+
+### Changed
+- Release workflows now run `npm run release:check` before publishing the root
+  package or first-party extension packs.
+- `prepublishOnly` now runs the full release gate instead of only `npm test`.
+- `/god-reconcile`, `/god-mode`, the orchestrator, agent specs, and roadmap
+  now describe the expanded local sync surfaces consistently.
+- Version, badge, roadmap, architecture, user-support, and reference surfaces
+  now align to 1.6.23.
+
+### Fixed
+- Repaired stale 1.6.19 and 1.6.22 current-version claims in runtime docs.
+- Removed literal forbidden dash and emoji characters from primary source
+  files while preserving validator coverage through Unicode escape sequences.
+- Repaired release documentation drift around package contents, route quality,
+  recipe coverage, release-surface checks, dogfood, host guarantees, extension
+  authoring, and Mode D suite release dry-runs.
+
+### Guardrails
+- Primary source scan now covers 639 tracked plus untracked source files and
+  verifies zero forbidden dash characters, zero emoji characters, zero invalid
+  JSON files, zero CRLF files, zero missing final newlines, and zero zero-byte
+  files.
+- `npm run release:check` remains the one-command release gate before commit,
+  tag, npm publish, and GitHub release creation.
+
+## [1.6.22] - 2026-05-16
+
+Dogfooding, host guarantees, extension authoring, and suite release dry-runs.
+
+### Added
+- Added `lib/dogfood-runner.js`, `/god-dogfood`, and `npx godpowers dogfood`
+  for deterministic messy-repo dogfood scenarios.
+- Added `fixtures/dogfood/` scenarios for half-migrated GSD import,
+  degraded and full host guarantees, extension scaffolding, and Mode D suite
+  release dry-run planning.
+- Added `lib/host-capabilities.js` and dashboard host guarantee reporting for
+  full, degraded, and unknown runtime capability states.
+- Added compact dashboard rendering with `npx godpowers status --brief`.
+- Added `lib/extension-authoring.js` and
+  `npx godpowers extension-scaffold --name=@scope/pack --output=.`.
+- Added Mode D suite release dry-run planning through
+  `suiteState.planRelease`.
+
+### Changed
+- Release-surface sync now requires dogfood, host capability, and extension
+  authoring test gates.
+- Repo-surface sync now checks dogfood runner presence, test wiring, and
+  required fixture manifests.
+- Package payload checks now include dogfood fixtures and the new runtime
+  helpers.
+- README, architecture, reference, release checklist, and runtime docs now
+  document dogfood, host guarantees, extension authoring, and suite dry-runs.
+
+### Guardrails
+- Dogfood runs copy fixtures into temporary directories before executing.
+- Host capability detection does not require network access.
+- Extension scaffolding does not overwrite existing files unless requested.
+- Suite release dry-runs return planned writes and impacted dependents without
+  mutating sibling repositories.
+
 ## [1.6.21] - 2026-05-16
 
 Dashboard compression, trace guardrails, and suite release readiness.

package/INSPIRATION.md

@@ -33,6 +33,12 @@ Beyond what was inherited, godpowers added:
   for the case where Impeccable is not installed
 - **AI-tool context writer** that maintains fenced sections in
   AGENTS.md / CLAUDE.md / GEMINI.md and 11 other tool-specific paths
+- **Feature awareness and host guarantee reporting** so existing projects and
+  AI coding hosts can state what Godpowers capabilities are actually available
+- **Messy-repo dogfood fixtures** for GSD migration, sync-back, extension
+  authoring, host capability, and Mode D suite release dry-run behavior
+- **Autonomous repo documentation and surface sync** for badges, route
+  metadata, recipes, package payloads, release gates, and extension packs
 
 ## Why this is the only mention
 

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-1.6.21-blue)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-1.6.23-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.**
@@ -12,14 +12,15 @@ idea to hardened production. It runs as **slash commands inside your AI coding
 tool** (Claude Code, Codex, Cursor, etc.) that orchestrate **specialist agents**
 in fresh contexts to do the work.
 
-Version 1.6.21 sharpens the daily operating loop. Godpowers now shows a compact
-action brief in dashboard output, enforces trace events for every
-agent-spawning route, and keeps dogfood, extension publish, Mode D suite, and
-installer smoke gates wired into release readiness.
+Version 1.6.23 hardens the release surface after a full file-by-file audit.
+Godpowers now keeps repo documentation, release gates, feature awareness,
+host guarantees, source-system sync-back, and repository surface checks aligned
+from reconciliation through final sync.
 
-The dashboard now starts with an action brief: the next command, why it is
-recommended, whether the project is ready, and the first blockers that need
-attention. Detailed proactive checks remain below the brief for auditability.
+The dashboard now starts with an action brief and a host guarantee line: the
+next command, why it is recommended, whether the project is ready, the first
+blockers that need attention, and whether the current host can provide full,
+degraded, or unknown runtime guarantees.
 
 It fuses four disciplines into one unified workflow:
 
@@ -120,7 +121,10 @@ runtime that can execute Node:
 ```bash
 npx godpowers status --project=.
 npx godpowers next --project=.
+npx godpowers status --project=. --brief
 npx godpowers status --project=. --json
+npx godpowers dogfood
+npx godpowers extension-scaffold --name=@godpowers/my-pack --output=.
 ```
 
 ### Slash Commands
@@ -145,6 +149,7 @@ npx godpowers status --project=. --json
 | `/god-status` | Re-derive state from disk | (built-in) |
 | `/god-automation-status` | Show host automation provider support | (built-in) |
 | `/god-automation-setup` | Prepare opt-in automation setup | (built-in) |
+| `/god-dogfood` | Run messy-repo dogfood scenarios for release and autonomy readiness | (built-in) |
 | `/god-migrate` | Detect GSD, BMAD, and Superpowers context; import and sync back | god-greenfieldifier when needed |
 | `/god-preflight` | Read-only intake audit before project-run readiness and pillars | god-auditor |
 | `/god-audit` | Score artifacts against have-nots | god-auditor |
@@ -212,6 +217,17 @@ npx godpowers automation-status --project=.
 npx godpowers automation-setup --project=.
 ```
 
+Godpowers can dogfood itself against shipped messy-repo fixtures:
+
+```bash
+npx godpowers dogfood
+```
+
+The dogfood suite covers a half-migrated GSD project, full and degraded host
+guarantee detection, extension scaffold validation, and a Mode D suite release
+dry-run. `/god-dogfood` reports failures with scoped specialist ownership
+rather than treating fixture checks as silent background work.
+
 Automation setup is opt-in. The installer does not create schedules, routines,
 background agents, API triggers, or CI workflows. Safe starting templates are
 read-only status, checkpoint, review queue, hygiene, and release readiness
@@ -362,7 +378,7 @@ Pi. T3 Code inherits from the underlying agent (Codex / Claude / OpenCode).
 
 - [Getting Started](docs/getting-started.md)
 - [Concepts](docs/concepts.md)
-- [Command reference (all 109 skills + 40 agents)](docs/reference.md)
+- [Command reference (all 110 skills + 40 agents)](docs/reference.md)
 - [Feature awareness](docs/feature-awareness.md)
 - [Repository documentation sync](docs/repo-doc-sync.md)
 - [Repository surface sync](docs/repo-surface-sync.md)

package/RELEASE.md

@@ -1,15 +1,15 @@
-# Godpowers 1.6.21 Release
+# Godpowers 1.6.23 Release
 
 Date: 2026-05-16
 
-Godpowers 1.6.21 sharpens the daily operating loop after the automation
-surface closeout. It adds dashboard action briefs, requires agent-spawning
-routes to declare trace events, and expands release readiness checks across
-dogfood, extension publish, Mode D suite, and installer smoke gates.
+Godpowers 1.6.23 hardens the repository after a full file-by-file audit. It
+aligns release gates, documentation sync, repository surface sync, feature
+awareness, source-system sync-back, host guarantees, dashboard closeouts, and
+package publishing into one verified release surface.
 
 ## What is stable
 
-- 109 slash commands
+- 110 slash commands
 - 40 specialist agents
 - 13 executable workflows
 - 40 intent recipes
@@ -28,74 +28,66 @@ dogfood, extension publish, Mode D suite, and installer smoke gates.
 - Repository surface sync checks
 - Route quality, recipe coverage, and release surface sync checks
 - Dashboard action briefs for next-step compression
+- Dashboard host guarantees for full, degraded, and unknown runtime capability
 - Agent-spawn trace event guardrails
 - Mode D suite readiness checks
+- Messy-repo dogfood scenarios
+- Extension authoring scaffold helper
+- Mode D suite release dry-run planner
+- Release gate enforcement through `npm run release:check`
 
 ## What is new
 
-- Added `Action brief` output to `lib/dashboard.js` and CLI status rendering.
-- Added route-quality enforcement for `agent.start` and `agent.end` trace
-  event declarations on agent-spawning routes.
-- Added repo-surface Mode D suite readiness checks for suite helper presence,
-  suite command skill and routing coverage, roadmap documentation, and release
-  test wiring.
-- Added release-surface checks for dogfood, extension publish, Mode D suite,
-  and installer smoke tests.
-- Updated `/god-init`, `/god-roadmap-update`, and `/god-sync` route metadata
-  to declare `agent.start`.
-
-## Automation surface behavior
-
-For a Godpowers repository, the helper checks:
-
-- every routed specialist spawn resolves to a real agent or built-in runtime
-  owner
-- every agent-spawning route declares `agent.start` and `agent.end`
-- every durable-writing route declares standards coverage or an approved
-  exemption
-- high-frequency work has discoverable intent recipes
-- release-facing version surfaces agree with `package.json`
-- package content checks require load-bearing runtime helper files
-- release checklist policy names the current sync guards
-- release gates include dogfood, extension publish, Mode D suite, and installer
-  smoke checks
-
-Detection is read-only by default. Applying sync writes logs and leaves
-judgment-heavy rewrites to scoped specialists.
-
-## Auto-invoke and auto-spawn policy
-
-Safe repo surface sync is local runtime work and must be reported as:
-
-```text
-Agent: none, local runtime only
-```
-
-Godpowers recommends scoped specialists only when judgment is needed:
-
-- `god-auditor` for agent contract or handoff drift
-- `god-roadmap-reconciler` for workflow or recipe lifecycle drift
-- `god-coordinator` for extension pack drift
-- `god-docs-writer` for release prose drift
+- Added `.planning/2026-05-16-surface-sync-status.md` to record the current
+  `.github/workflows`, `.planning`, and `agents` sync status without rewriting
+  historical planning evidence.
+- Expanded `god-reconciler` so feature reconciliation includes repository
+  documentation, repository surface, runtime feature awareness, source-system
+  sync-back, and host capability checks.
+- Expanded `god-updater` so closeout reports repo-doc sync, repo-surface sync,
+  feature awareness, source-system sync-back, host capability, dashboard
+  refresh, checkpoint sync, Pillars sync, and context refresh.
+- Updated workflow release jobs so root and first-party pack publishing run
+  the complete release gate first.
+- Updated `prepublishOnly` so local npm publish attempts also run the complete
+  release gate.
+
+## Repairs
+
+- Repaired stale current-version claims in README, architecture, roadmap,
+  reference docs, `/god-version`, and agent context.
+- Repaired stale `/god-reconcile` docs so the command and specialist agent
+  describe the same expanded sync surfaces.
+- Repaired final sync docs so `/god-mode`, `god-orchestrator`, and agent specs
+  all describe core artifacts plus local runtime and repository sync surfaces.
+- Removed literal forbidden dash and emoji characters from primary source files
+  while keeping validator tests intact through Unicode escape sequences.
+- Repaired release documentation drift around package contents, route quality,
+  recipe coverage, release-surface checks, dogfood, host guarantees, extension
+  authoring, and Mode D suite release dry-runs.
 
 ## Validation
 
 Release validation includes:
 
+- source audit over 639 tracked plus untracked source files
+- `node scripts/validate-skills.js`
+- `bash scripts/smoke.sh`
+- `node scripts/test-agent-validator.js`
+- `node scripts/test-artifact-linter.js`
+- `node scripts/test-repo-doc-sync.js`
 - `node scripts/test-repo-surface-sync.js`
 - `node scripts/test-automation-surface-sync.js`
-- `node scripts/test-repo-doc-sync.js`
 - `node scripts/test-feature-awareness.js`
-- `node scripts/test-dashboard.js`
+- `node scripts/test-host-capabilities.js`
+- `node scripts/test-dogfood-runner.js`
+- `node scripts/test-extension-authoring.js`
 - `node scripts/test-mode-d.js`
 - `node scripts/test-extensions-publish.js`
 - `node scripts/test-install-smoke.js`
-- `node scripts/test-context-writer.js`
-- `node scripts/test-planning-systems.js`
-- `node scripts/test-doc-surface-counts.js`
-- `node scripts/validate-skills.js`
+- `npm audit --omit=dev`
 - `git diff --check`
 - `npm run release:check`
 
-The `v1.6.21` tag should point to the release commit that matches the npm
-`godpowers@1.6.21` package.
+The `v1.6.23` tag should point to the release commit that matches the npm
+`godpowers@1.6.23` package.

package/SKILL.md

@@ -120,9 +120,9 @@ When the runtime bundle is available, compute this with
 `lib/dashboard.compute(projectRoot)` and render it with
 `lib/dashboard.render(result)`. The executable dashboard engine is the shared
 source for phase, tier, step, progress, PRD and roadmap visibility, proactive
-checks, open items, and the next route. If the runtime module is unavailable,
-fall back to a manual disk scan and say `Dashboard engine: unavailable, manual
-scan used`.
+checks, host guarantees, open items, and the next route. If the runtime module
+is unavailable, fall back to a manual disk scan and say `Dashboard engine:
+unavailable, manual scan used`.
 
 Use this shape:
 
@@ -137,6 +137,13 @@ Current status:
   Worktree: <clean | modified files unstaged | staged changes | mixed>
   Index: <untouched | staged files listed>
 
+Action brief:
+  Next: <recommended command or user decision>
+  Why: <route reason tied to disk state>
+  Readiness: <ready | needs attention>
+  Attention: <top blockers or none>
+  Host guarantees: <full | degraded | unknown with host and first gap>
+
 Planning visibility:
   PRD: <done | pending | missing | deferred> <artifact path when present>
   Roadmap: <done | pending | missing | deferred> <artifact path when present>
@@ -156,6 +163,7 @@ Proactive checks:
   Sync: <fresh | missing | stale | local helper ran | suggest /god-sync>
   Docs: <fresh | N stale, suggest /god-docs | repo-doc-sync ran>
   Repo surface: <fresh | N stale, suggest /god-doctor | repo-surface-sync ran>
+  Host: <full | degraded | unknown with host and first gap>
   Runtime: <not-applicable | known URL, suggest /god-test-runtime | no known URL, defer deployed verification>
   Automation: <not configured | N active | available via provider, suggest /god-automation-setup>
   Security: <clear | sensitive files changed, suggest /god-harden>
@@ -215,7 +223,7 @@ Auto-invoked:
   Trigger: <what caused this automatic step>
   Agent: <god-updater | god-context-writer | none, local runtime only>
   Local syncs:
-    + <feature-awareness | planning-system-import | reverse-sync | source-sync | repo-doc-sync | repo-surface-sync | route-quality-sync | recipe-coverage-sync | release-surface-sync | pillars-sync | checkpoint-sync | context-refresh>: <result or skipped reason>
+    + <feature-awareness | planning-system-import | reverse-sync | source-sync | repo-doc-sync | repo-surface-sync | route-quality-sync | recipe-coverage-sync | release-surface-sync | host-capabilities | dogfood-runner | pillars-sync | checkpoint-sync | context-refresh>: <result or skipped reason>
   Artifacts: <changed files, no-op, or deferred>
   Log: <SYNC-LOG.md, CHECKPOINT.md, REVIEW-REQUIRED.md, or none>
 ```
@@ -250,6 +258,10 @@ Automatic steps that especially need visible reporting:
 - route-quality sync, recipe-coverage sync, and release-surface sync through
   repo-surface sync during `/god-sync`, `/god-docs`, `/god-doctor`,
   `/god-status`, or `/god-mode`
+- host capability detection during `/god-status`, `/god-next`, and closeout
+  dashboards
+- dogfood runner execution during `/god-dogfood`, release checks, or explicit
+  dogfood requests
 
 ### 13. Proactive Auto-Invoke Policy
 Godpowers should be proactive from disk evidence, not from guesswork. Before
@@ -297,6 +309,10 @@ Run these local runtime helpers automatically when their trigger is present:
 - `lib/route-quality-sync.detect`, `lib/recipe-coverage-sync.detect`, and
   `lib/release-surface-sync.detect` through repo-surface sync when route
   spawns, high-frequency recipes, or release-facing surfaces may have drifted.
+- `lib/host-capabilities.detect` during dashboard computation so runtime
+  guarantees are visible before Godpowers claims autonomy.
+- `lib/dogfood-runner.runAll` during explicit `/god-dogfood`, release checks,
+  or user-requested dogfood verification.
 - Context refresh dry-run after `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`,
   `.cursor/rules/`, `.windsurfrules`, `.github/copilot-instructions.md`,
   `.clinerules`, `.roo/`, or `.continue/` changes.
@@ -332,6 +348,10 @@ Spawn these agents only when the trigger is direct and scope is bounded:
   artifacts after local import.
 - `god-greenfieldifier` when feature-awareness detects unimported or imported
   source-system context that is low confidence or conflicting.
+- `god-greenfieldifier` when dogfood migration scenarios fail.
+- `god-context-writer` when host capability dogfood scenarios fail.
+- `god-coordinator` when extension authoring or suite release dogfood
+  scenarios fail.
 
 #### Level 4: Explicit approval required
 Never auto-run these from inference alone:

package/agents/god-orchestrator.md

@@ -643,10 +643,13 @@ ecosystem.
 Before declaring the project run complete, ALWAYS run /god-sync:
 
 1. Spawn god-updater in fresh context
-2. Verify final consistency across all 14 artifact categories:
+2. Verify final consistency across all 14 core artifact categories and local
+   sync surfaces:
    - All Tier 1-3 artifacts written and pass have-nots
    - Capture artifacts (BACKLOG, SEEDS, TODOS, THREADS) noted as
      "not-yet-created" if absent (graceful, not a failure)
+   - Repo docs, repo surface, feature awareness, source sync-back, host
+     capability, checkpoint, Pillars, and context refresh statuses reported
 3. Update SYNC-LOG.md with the project-run completion entry
 4. Update state.json with all final tier statuses
 
@@ -685,19 +688,28 @@ Godpowers project run complete.
 
 Godpowers Dashboard
 
+Source: runtime dashboard (lib/dashboard.js)
+
 Current status:
   State: complete
   Phase: <plain-language phase> (tier <human ordinal> of <human total>)
   Step: <sub-step label> (step <n> of <total steps>)
-  Progress: <pct>% (<done> of <total> steps complete)
+  Progress: <pct>% workflow progress (<done> of <total> tracked steps complete)
   Worktree: <clean | modified files unstaged | staged changes | mixed>
   Index: <untouched | staged files listed>
 
+Action brief:
+  Next: <one command or user decision>
+  Why: <one sentence tied to disk state>
+  Readiness: <ready | needs attention>
+  Attention: <none or top blockers>
+  Host guarantees: <full | degraded | unknown>
+
 Planning visibility:
   PRD: <done | pending | missing | deferred> <artifact path when present>
   Roadmap: <done | pending | missing | deferred> <artifact path when present>
   Current milestone: <roadmap milestone, tier, or next planning gate when known>
-  Completion: <pct>% <brief basis, for example done steps over total tracked steps>
+  Completion basis: <state.json, PROGRESS.md, artifacts, or audit score source>
 
 What changed:
   1. <highest-signal user-visible change>
@@ -711,6 +723,9 @@ Proactive checks:
   Reviews: <none | N pending, suggest /god-review-changes>
   Sync: <fresh | suggested | local helper ran>
   Docs: <fresh | suggested | drift-check spawned>
+  Repo surface: <fresh | stale, suggest /god-doctor>
+  Host: <full | degraded | unknown>
+  Dogfood: <not-run | pass | fail | suggest /god-dogfood>
   Runtime: <not-applicable | suggested | browser test spawned>
   Security: <clear | suggested | harden spawned>
   Dependencies: <clear | suggested | deps audit spawned>

package/agents/god-reconciler.md

@@ -3,9 +3,10 @@ name: god-reconciler
 description: |
   Comprehensive reconciliation across ALL impacted artifacts before feature
   work. Checks PRD, ARCH, ROADMAP, STACK, REPO, DEPLOY, OBSERVE, HARDEN,
-  LAUNCH, BACKLOG, SEEDS, TODOS, THREADS in parallel. Returns multi-
-  dimensional verdict so user knows every place the work intersects with
-  existing artifacts.
+  LAUNCH, BACKLOG, SEEDS, TODOS, THREADS, repository documentation,
+  repository surface, feature awareness, host capability, and source-system
+  sync-back in parallel. Returns multi-dimensional verdict so user knows every
+  place the work intersects with existing artifacts.
 
   Spawned by: /god-reconcile, recipe execution (feature-addition category)
 tools: Read, Bash, Grep, Glob, Task
@@ -25,6 +26,8 @@ A feature addition often impacts multiple artifacts:
 - STACK may need a new dependency
 - BACKLOG may already capture the intent
 - SEEDS may trigger a planted seed
+- README, release notes, schemas, workflows, recipes, and installed-project
+  feature awareness may need mechanical sync
 
 If we don't check all of these, we get drift. Roadmap says one thing, PRD
 says another, code does a third.
@@ -120,6 +123,38 @@ For each artifact below, check (in parallel where possible):
 - Is there an active thread about this topic?
 - Verdict: no-thread / active-thread (with thread name)
 
+### Runtime and repository surface artifacts
+
+#### REPO DOCS (`README.md`, `CHANGELOG.md`, `RELEASE.md`, docs, support files)
+- Does this work change public counts, badges, release status, install
+  guidance, contributor guidance, or support policy?
+- Verdict: fresh / needs-mechanical-sync / needs-docs-writer
+- If narrative release or support docs need judgment: recommend
+  `god-docs-writer`.
+
+#### REPO SURFACE (`skills/`, `agents/`, `routing/`, `workflows/`, `schema/`, `package.json`)
+- Did the work add, rename, remove, or change a command, agent, workflow,
+  recipe, schema, package file entry, extension, or release helper?
+- Verdict: fresh / needs-surface-sync / needs-safe-fix / needs-human-review
+- If stale checks are mechanical: recommend `lib/repo-surface-sync.run`.
+
+#### FEATURE AWARENESS (`.godpowers/state.json`, context fences)
+- Does an existing Godpowers project need to learn about new runtime features?
+- Verdict: fresh / needs-awareness-refresh / needs-migration-judgment
+- If imported planning systems have low confidence or conflicts: recommend
+  `god-greenfieldifier`.
+
+#### SOURCE SYSTEM SYNC-BACK (GSD, BMAD, Superpowers)
+- Did migrated source-system summaries need managed sync-back?
+- Verdict: not-applicable / fresh / needs-sync-back / blocked-by-conflict
+- If conflicts exist: recommend greenfieldifier review before writes.
+
+#### HOST CAPABILITY (`lib/host-capabilities.js`)
+- Does the work depend on a host feature such as fresh-context spawning,
+  local shell, GitHub CLI, npm, or extension authoring?
+- Verdict: full / degraded / unknown
+- If degraded: include the missing guarantee in the recommendation.
+
 ## Output
 
 Return structured JSON to the orchestrating skill:
@@ -141,6 +176,11 @@ Return structured JSON to the orchestrating skill:
   "seeds": { "status": "no-seeds" },
   "todos": { "status": "supersedes-todo", "match": "P1: refactor auth middleware" },
   "threads": { "status": "active-thread", "match": "auth migration" },
+  "repo_docs": { "status": "needs-mechanical-sync", "action": "run repo-doc-sync" },
+  "repo_surface": { "status": "needs-surface-sync", "action": "run repo-surface-sync" },
+  "feature_awareness": { "status": "needs-awareness-refresh", "action": "run feature-awareness" },
+  "source_sync_back": { "status": "not-applicable" },
+  "host_capability": { "status": "degraded", "gap": "fresh-context agent spawn not detected" },
   "recommendation": {
     "primary-action": "/god-feature scoped to Milestone 2",
     "preflight": [
@@ -148,7 +188,7 @@ Return structured JSON to the orchestrating skill:
       "/god-arch with mode=delta-only (add component + ADR)"
     ],
     "post-work": [
-      "/god-sync (update all affected artifacts)"
+      "/god-sync (update all affected artifacts and local sync surfaces)"
     ]
   }
 }
@@ -175,12 +215,17 @@ Where this intersects existing artifacts:
   SEEDS:      no triggers
   TODOS:      supersedes "refactor auth middleware"
   THREADS:    relates to active thread "auth migration"
+  REPO DOCS:  needs mechanical sync
+  SURFACE:    needs repo-surface sync
+  FEATURES:   awareness refresh needed
+  SOURCE:     no sync-back needed
+  HOST:       degraded - fresh-context agent spawn not detected
 
 Recommended sequence:
   1. /god-redo prd            (add requirement)
   2. /god-arch delta-only     (architecture delta)
   3. /god-feature             (build it, scoped to Milestone 2)
-  4. /god-sync                (update all touched artifacts)
+  4. /god-sync                (update all touched artifacts and local sync surfaces)
 
 Run this sequence? (yes / show alternatives / cancel)
 ```
@@ -224,6 +269,8 @@ For feature-addition category recipes: ALWAYS reconcile.
 Reconciliation FAILS if:
 - Returns "all covered" without checking each artifact
 - Skips an artifact silently (must report status for each)
+- Skips repo docs, repo surface, feature awareness, source sync-back, or host
+  capability when the work affects them
 - Recommends bypass without justification
 - Missing prerequisite check
 - Doesn't surface ambiguous cases