godpowers 3.13.1 → 3.14.0

package/lib/evidence.js

@@ -195,6 +195,10 @@ function appendJsonlAtomic(file, record) {
   return file;
 }
 
+// Reads the whole ledger into memory. This is bounded and acceptable for a CLI:
+// each record caps its stdout/stderr tails (TAIL_CHARS) so growth is slow, and
+// every consumer reads it once per command, never in a loop. If a long-lived
+// project's ledger ever grows large, add an opt-in prune/size cap here (PERF-002).
 function readJsonl(file) {
   let raw;
   try {
@@ -542,11 +546,16 @@ function history(opts = {}) {
 }
 
 /**
- * The strict close gate, rebound from Mythify's completion rule (cmd_step):
- * a substep may close to done only when evidence bound to it since it went
- * in-flight supports the close. This is a read-only predicate. It does NOT
- * mutate state and is NOT yet wired into gate.js or the close path; that wiring
- * is the deliberate behavior change tracked as the rest of Phase 1.
+ * The advisory close-freshness check, rebound from Mythify's completion rule
+ * (cmd_step): a substep may close to done only when evidence bound to it since
+ * it went in-flight supports the close. This is a read-only predicate. It does
+ * NOT mutate state and is NOT wired into gate.js or the close path; that wiring
+ * is a deliberate behavior change tracked as the rest of Phase 1. Until then it
+ * is advisory discipline the orchestrator runs (via `can-close`), NOT the
+ * mechanically enforced gate. The enforced gate is `gate.js`
+ * (`npx godpowers gate`), which checks recorded pass/fail evidence but not the
+ * since-in-flight freshness this predicate adds. Treat the two as distinct:
+ * `gate` is the mechanical boundary, `can-close` is the stricter advisory one.
  *
  * Tier-appropriate (docs/FUSION-ARCHITECTURE.md section 4.2):
  *   - Executable-gated substeps (build, deploy, harden) require the latest

package/lib/have-nots-validator.js

@@ -53,9 +53,13 @@ const LABEL_TAGS = ['DECISION', 'HYPOTHESIS', 'OPEN QUESTION', 'OPEN-QUESTION'];
 function findPositions(content, regex) {
   const positions = [];
   const lines = content.split('\n');
+  // Compile once and reuse across lines (PERF-001); reset lastIndex per line so
+  // matching is identical to a fresh per-line regex.
+  const flags = regex.flags.includes('g') ? regex.flags : regex.flags + 'g';
+  const localRegex = new RegExp(regex.source, flags);
   for (let i = 0; i < lines.length; i++) {
+    localRegex.lastIndex = 0;
     let match;
-    const localRegex = new RegExp(regex.source, regex.flags.includes('g') ? regex.flags : regex.flags + 'g');
     while ((match = localRegex.exec(lines[i])) !== null) {
       positions.push({ line: i + 1, column: match.index + 1, matched: match[0] });
     }

package/lib/intent.js

@@ -332,15 +332,20 @@ function splitInlineArray(text) {
   return parts;
 }
 
-function cleanArrays(obj) {
-  if (Array.isArray(obj)) return obj.map(cleanArrays);
+// Far beyond any legitimate config nesting; caps recursion so a hostile,
+// thousands-deep YAML file cannot overflow the stack (SEC-002).
+const MAX_CLEAN_DEPTH = 200;
+
+function cleanArrays(obj, depth = 0) {
+  if (depth > MAX_CLEAN_DEPTH) return obj;
+  if (Array.isArray(obj)) return obj.map((v) => cleanArrays(v, depth + 1));
   if (obj && typeof obj === 'object') {
     // Detect array container (legacy or new)
-    if (obj.__items__) return obj.__items__.map(cleanArrays);
+    if (obj.__items__) return obj.__items__.map((v) => cleanArrays(v, depth + 1));
     if (obj.__pending_array__) return obj.__pending_array__;
     const cleaned = {};
     for (const [k, v] of Object.entries(obj)) {
-      cleaned[k] = cleanArrays(v);
+      cleaned[k] = cleanArrays(v, depth + 1);
     }
     return cleaned;
   }

package/lib/pillars.js

@@ -114,6 +114,13 @@ const GODPOWERS_ARTIFACTS = [
   '.godpowers/design/PRODUCT.md'
 ];
 
+// ===========================================================================
+// Pillar model: parse pillar files, detect installed pillars, compute the
+// per-task load set, and construct/initialize pillar files. Shared with the
+// artifact-sync workflow below (init/ensurePillar/pillarStub/detect are also
+// part of the public API).
+// ===========================================================================
+
 function stripQuotes(value) {
   return String(value).trim().replace(/^['"]|['"]$/g, '');
 }
@@ -401,6 +408,12 @@ function writeFenced(filePath, begin, end, content) {
   fs.writeFileSync(filePath, next);
 }
 
+// ===========================================================================
+// Artifact-sync workflow: turn Godpowers artifacts (PRD/ARCH/...) into durable
+// pillar signals and write them into the routed pillar files. Builds on the
+// model above (init/ensurePillar/pillarStub/detect/buildProtocolContent).
+// ===========================================================================
+
 function artifactToPillars(artifactPath) {
   const normalized = artifactPath.replace(/\\/g, '/');
   const pillars = [];

package/lib/planning-systems.js

@@ -100,10 +100,6 @@ function ensureDir(filePath) {
   fs.mkdirSync(path.dirname(filePath), { recursive: true });
 }
 
-function sha(input) {
-  return crypto.createHash('sha256').update(input).digest('hex');
-}
-
 function hashFiles(projectRoot, files) {
   const h = crypto.createHash('sha256');
   for (const file of files.map((f) => f.path).sort()) {
@@ -473,7 +469,6 @@ module.exports = {
   _private: {
     classifyFile,
     extractSignals,
-    filesForKinds,
-    sha
+    filesForKinds
   }
 };

package/lib/recipe-coverage-sync.js

@@ -10,6 +10,9 @@ const path = require('path');
 
 const recipes = require('./recipes');
 const { read, write } = require('./sync-fs');
+const { makeAddCheck } = require('./sync-check');
+
+const addCheck = makeAddCheck('recipe-coverage');
 
 const LOG_PATH = '.godpowers/surface/RECIPE-COVERAGE-SYNC.md';
 
@@ -42,18 +45,6 @@ const REQUIRED_COVERAGE = [
 ];
 
 
-function addCheck(checks, id, status, relPath, message, opts = {}) {
-  checks.push({
-    area: 'recipe-coverage',
-    id,
-    status,
-    path: relPath,
-    message,
-    severity: opts.severity || (status === 'fresh' ? 'info' : 'warning'),
-    spawn: opts.spawn || null
-  });
-}
-
 function recipePath(projectRoot, name) {
   const rel = `routing/recipes/${name}.yaml`;
   return fs.existsSync(path.join(projectRoot, rel)) ? rel : 'routing/recipes/';

package/lib/release-surface-sync.js

@@ -10,6 +10,9 @@ const fs = require('fs');
 const path = require('path');
 
 const { read, write, readJson } = require('./sync-fs');
+const { makeAddCheck } = require('./sync-check');
+
+const addCheck = makeAddCheck('release-surface');
 
 const LOG_PATH = '.godpowers/surface/RELEASE-SURFACE-SYNC.md';
 
@@ -46,18 +49,6 @@ function releaseGateText(projectRoot, pkg) {
   ].join('\n');
 }
 
-function addCheck(checks, id, status, relPath, message, opts = {}) {
-  checks.push({
-    area: 'release-surface',
-    id,
-    status,
-    path: relPath,
-    message,
-    severity: opts.severity || (status === 'fresh' ? 'info' : 'warning'),
-    spawn: opts.spawn || null
-  });
-}
-
 function detect(projectRoot) {
   const checks = [];
   const pkg = readJson(projectRoot, 'package.json') || {};

package/lib/repo-surface-sync.js

@@ -12,6 +12,7 @@ const path = require('path');
 
 const { parseSimpleYaml } = require('./intent');
 const { read, write, exists, readJson } = require('./sync-fs');
+const { addCheck, listFiles } = require('./sync-check');
 const extensions = require('./extensions');
 const repoDocSync = require('./repo-doc-sync');
 const routeQualitySync = require('./route-quality-sync');
@@ -52,19 +53,6 @@ const REQUIRED_PACKAGE_CHECKS = [
   'routing/god-export-otel.yaml'
 ];
 
-function rel(projectRoot, absPath) {
-  return path.relative(projectRoot, absPath).split(path.sep).join('/');
-}
-
-function listFiles(projectRoot, relDir, pattern) {
-  const dir = path.join(projectRoot, relDir);
-  if (!fs.existsSync(dir)) return [];
-  return fs.readdirSync(dir)
-    .filter((name) => pattern.test(name))
-    .sort()
-    .map((name) => `${relDir}/${name}`.replace(/\\/g, '/'));
-}
-
 function releaseGateText(projectRoot, pkg) {
   return [
     JSON.stringify((pkg && pkg.scripts) || {}),
@@ -81,19 +69,6 @@ function commandForSkill(skillPath) {
   return `/${path.basename(skillPath, '.md')}`;
 }
 
-function addCheck(checks, area, id, status, relPath, message, opts = {}) {
-  checks.push({
-    area,
-    id,
-    status,
-    path: relPath,
-    message,
-    severity: opts.severity || (status === 'fresh' ? 'info' : 'warning'),
-    safeFix: opts.safeFix === true,
-    spawn: opts.spawn || null
-  });
-}
-
 function routingChecks(projectRoot) {
   const checks = [];
   const skills = listFiles(projectRoot, 'skills', /^god.*\.md$/);
@@ -485,15 +460,12 @@ function releasePolicyChecks(projectRoot) {
     checks,
     'release',
     'release-checklist-surface-sync',
-    read(projectRoot, 'docs/RELEASE-CHECKLIST.md').includes('repo-surface-sync'),
+    read(projectRoot, 'docs/RELEASE-CHECKLIST.md').includes('repo-surface-sync') ? 'fresh' : 'stale',
     'docs/RELEASE-CHECKLIST.md',
     'Release checklist references repo-surface-sync readiness.',
     { spawn: 'god-docs-writer' }
   );
-  return checks.map((check) => ({
-    ...check,
-    status: check.status === true ? 'fresh' : (check.status === false ? 'stale' : check.status)
-  }));
+  return checks;
 }
 
 function detect(projectRoot) {

package/lib/requirements.js

@@ -33,9 +33,11 @@ const linkage = require('./linkage');
 const state = require('./state');
 const atomic = require('./atomic-write');
 const textUtil = require('./text-util');
+const artifactMap = require('./artifact-map');
+const { readTextOrNull: readText } = require('./sync-fs');
 
-const PRD_PATH = '.godpowers/prd/PRD.md';
-const ROADMAP_PATH = '.godpowers/roadmap/ROADMAP.md';
+const PRD_PATH = artifactMap.requiredArtifactsForTier('prd')[0].path;
+const ROADMAP_PATH = artifactMap.requiredArtifactsForTier('roadmap')[0].path;
 const LEDGER_PATH = '.godpowers/REQUIREMENTS.md';
 
 const PRIORITIES = ['MUST', 'SHOULD', 'COULD'];
@@ -44,16 +46,6 @@ const REQ_ID_RE_G = /\bP-(MUST|SHOULD|COULD)-\d+\b/g;
 const MILESTONE_ID_RE = /\bM-[\w-]+\b/;
 const LABEL_RE = /\[(?:DECISION|HYPOTHESIS|OPEN QUESTION)\]/g;
 
-function readText(projectRoot, relPath) {
-  const file = path.join(projectRoot, relPath);
-  if (!fs.existsSync(file)) return null;
-  try {
-    return fs.readFileSync(file, 'utf8');
-  } catch (e) {
-    return null;
-  }
-}
-
 function pad2(n) {
   return String(n).padStart(2, '0');
 }

package/lib/reverse-sync.js

@@ -318,23 +318,29 @@ function run(projectRoot, opts = {}) {
   // write the file when the PRD actually declares requirements, to avoid
   // littering pre-PRD projects with an empty ledger.
   let requirementsSummary = null;
+  let requirementsError = null;
   if (opts.runRequirements !== false) {
     try {
       const derived = requirements.derive(projectRoot);
       if (derived.hasRequirements) {
-        requirements.writeLedger(projectRoot, derived);
         const currentState = state.read(projectRoot);
         requirementsSummary = requirements.summarizeForState(
           derived,
           currentState && currentState.deliverables
         );
+        // Write state.json first, then the ledger, so a state-write failure
+        // cannot leave a REQUIREMENTS.md ledger that state.json never references.
         if (currentState) {
           currentState.deliverables = requirementsSummary;
           state.write(projectRoot, currentState);
         }
+        requirements.writeLedger(projectRoot, derived);
       }
     } catch (e) {
+      // ERR-001: surface the failure instead of swallowing it, so the caller can
+      // tell a genuine requirements-step error apart from "no requirements".
       requirementsSummary = null;
+      requirementsError = e.message;
     }
   }
 
@@ -346,7 +352,8 @@ function run(projectRoot, opts = {}) {
     footers,
     sourceSyncResult,
     reviewItems,
-    requirements: requirementsSummary
+    requirements: requirementsSummary,
+    requirementsError
   };
 }
 

package/lib/route-quality-sync.js

@@ -11,6 +11,9 @@ const path = require('path');
 
 const { parseSimpleYaml } = require('./intent');
 const { read, write } = require('./sync-fs');
+const { makeAddCheck, listFiles } = require('./sync-check');
+
+const addCheck = makeAddCheck('route-quality');
 
 const LOG_PATH = '.godpowers/surface/ROUTE-QUALITY-SYNC.md';
 const CONTEXTUAL_NEXT_VALUES = new Set([
@@ -101,15 +104,6 @@ const TIER_GATE_COMMANDS = new Set([
   '/god-harden'
 ]);
 
-function listFiles(projectRoot, relDir, pattern) {
-  const dir = path.join(projectRoot, relDir);
-  if (!fs.existsSync(dir)) return [];
-  return fs.readdirSync(dir)
-    .filter((name) => pattern.test(name))
-    .sort()
-    .map((name) => `${relDir}/${name}`.replace(/\\/g, '/'));
-}
-
 function arr(value) {
   return Array.isArray(value) ? value : [];
 }
@@ -122,18 +116,6 @@ function parseRoute(projectRoot, routePath) {
   }
 }
 
-function addCheck(checks, id, status, relPath, message, opts = {}) {
-  checks.push({
-    area: 'route-quality',
-    id,
-    status,
-    path: relPath,
-    message,
-    severity: opts.severity || (status === 'fresh' ? 'info' : 'warning'),
-    spawn: opts.spawn || null
-  });
-}
-
 function spawnTokens(route) {
   const execution = route.execution || {};
   return normalizeSpawnList([

package/lib/source-sync.js

@@ -30,10 +30,6 @@ const SYSTEM_TARGETS = {
   }
 };
 
-function rel(projectRoot, absPath) {
-  return path.relative(projectRoot, absPath).split(path.sep).join('/');
-}
-
 function sha(input) {
   return `sha256:${crypto.createHash('sha256').update(input).digest('hex')}`;
 }

package/lib/state.js

@@ -365,6 +365,11 @@ function progressSummary(state) {
   const steps = orderedSubSteps(state);
   const total = steps.length;
   const completed = steps.filter(step => isCompleteStatus(step.status)).length;
+  // JRN-002: skipped/not-required steps count toward `completed` (and therefore
+  // the percent), so a run that skipped tiers can show a high percent that
+  // overstates how much was actually built. Expose the skipped count so the
+  // dashboard can annotate the percent honestly instead of silently inflating.
+  const skipped = steps.filter(step => step.status === 'skipped' || step.status === 'not-required').length;
 
   let currentIndex = steps.findIndex(step => isActiveStatus(step.status));
   if (currentIndex < 0) {
@@ -377,6 +382,7 @@ function progressSummary(state) {
     percent: total === 0 ? 0 : Math.round((completed / total) * 100),
     completed,
     total,
+    skipped,
     remaining: Math.max(total - completed, 0),
     currentStep: current ? current.ordinal : 0,
     current,

package/lib/sync-check.js

@@ -0,0 +1,56 @@
+/**
+ * Shared check-builder and file-lister for the lib/*-sync.js family (ARC-001).
+ *
+ * The aggregator (repo-surface-sync) passes a per-call `area` and may mark a
+ * check `safeFix`, so it uses the full `addCheck`. The single-area sync modules
+ * (recipe-coverage, release-surface, route-quality) bind their area once via
+ * `makeAddCheck(area)`; their records intentionally omit `safeFix` (none of
+ * their checks are auto-fixable), matching the original per-module builders.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+function severityFor(status, opts) {
+  return opts.severity || (status === 'fresh' ? 'info' : 'warning');
+}
+
+// Full form: caller supplies `area`; records include the `safeFix` flag.
+function addCheck(checks, area, id, status, relPath, message, opts = {}) {
+  checks.push({
+    area,
+    id,
+    status,
+    path: relPath,
+    message,
+    severity: severityFor(status, opts),
+    safeFix: opts.safeFix === true,
+    spawn: opts.spawn || null
+  });
+}
+
+// Area-bound form for single-area modules; records omit `safeFix`.
+function makeAddCheck(area) {
+  return function (checks, id, status, relPath, message, opts = {}) {
+    checks.push({
+      area,
+      id,
+      status,
+      path: relPath,
+      message,
+      severity: severityFor(status, opts),
+      spawn: opts.spawn || null
+    });
+  };
+}
+
+function listFiles(projectRoot, relDir, pattern) {
+  const dir = path.join(projectRoot, relDir);
+  if (!fs.existsSync(dir)) return [];
+  return fs.readdirSync(dir)
+    .filter((name) => pattern.test(name))
+    .sort()
+    .map((name) => `${relDir}/${name}`.replace(/\\/g, '/'));
+}
+
+module.exports = { addCheck, makeAddCheck, listFiles };

package/lib/sync-fs.js

@@ -34,4 +34,16 @@ function readJson(projectRoot, relPath) {
   }
 }
 
-module.exports = { read, write, exists, readJson };
+// Like read(), but returns null (not '') when the file is missing or unreadable,
+// for callers that distinguish "absent" from "empty".
+function readTextOrNull(projectRoot, relPath) {
+  const file = path.join(projectRoot, relPath);
+  if (!fs.existsSync(file)) return null;
+  try {
+    return fs.readFileSync(file, 'utf8');
+  } catch (err) {
+    return null;
+  }
+}
+
+module.exports = { read, write, exists, readJson, readTextOrNull };

package/lib/work-report.js

@@ -108,6 +108,8 @@ function render(result) {
     lines.push(result.since === 'all'
       ? 'No verification records yet.'
       : 'Nothing new since the last report.');
+    // CNT-006: do not dead-end; name what populates the ledger.
+    lines.push('Run "npx godpowers verify <command>" or "reflect --action ..." to add records.');
     return lines.join('\n');
   }
   lines.push(`Since: ${result.since}${result.peek ? ' (peek, cursor not advanced)' : ''}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "godpowers",
-  "version": "3.13.1",
+  "version": "3.14.0",
   "description": "AI-powered development system: 120 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"
@@ -24,11 +24,11 @@
     "test:e2e": "node tests/integration/full-arc.test.js",
     "test:mcp": "npm --workspace @godpowers/mcp test",
     "coverage": "c8 --reporter=text --reporter=lcov node scripts/run-tests.js",
-    "coverage:lib": "c8 --include=lib/**/*.js --check-coverage --lines 90 --branches 75 --reporter=text node scripts/run-tests.js",
+    "coverage:lib": "c8 --include=lib/**/*.js --check-coverage --lines 90 --branches 75 --reporter=text --reporter=json-summary node scripts/run-tests.js",
     "test:audit": "npm audit --omit=dev && git diff --check && npm run test:surface",
     "pack:check": "node scripts/check-package-contents.js",
     "pack:mcp:check": "npm --workspace @godpowers/mcp run pack:check",
-    "release:check": "npm run coverage:lib && npm run test:audit && npm run pack:check && npm run pack:mcp:check",
+    "release:check": "npm run coverage:lib && node scripts/check-per-file-coverage.js && npm run test:audit && npm run pack:check && npm run pack:mcp:check",
     "lint": "node scripts/static-check.js"
   },
   "workspaces": [

package/references/orchestration/GOD-ORCHESTRATOR-RUNBOOK.md

@@ -406,6 +406,9 @@ maker that fixes is never the checker that grades.
      command and records the iteration. Repeat until the outcome succeeds or the
      budget is exhausted.
    - Never mark a finding resolved while `can-close` for its substep is red.
+     (`can-close` is the advisory since-in-flight freshness check you run as
+     discipline; the mechanically enforced gate is `npx godpowers gate`. Both
+     must agree before you close.)
 4. **Re-audit.** Re-run `god-debt-assessor` and confirm findings are resolved,
    not relocated, and that no Strength regressed. The loop is done when no
    Confirmed Critical or High remains (or the agreed bucket is empty).
@@ -535,9 +538,13 @@ requested or final sign-off begins.
 6. Verify their output exists on disk
 7. Run have-nots check on the artifact and run `standards.gate-command` when configured
 8. For an executable-gated sub-step (build, deploy, harden), record executed
-   evidence with `npx godpowers verify "<cmd>" --substep <tier.substep>` and then
-   confirm `npx godpowers can-close --substep <tier.substep> --project=.` exits
-   zero before closing. Never advance the sub-step to done while can-close is red.
+   evidence with `npx godpowers verify "<cmd>" --substep <tier.substep>`, confirm
+   the enforced gate passes with `npx godpowers gate --tier=<tier> --project=.`,
+   and then run the advisory freshness check
+   `npx godpowers can-close --substep <tier.substep> --project=.` (it must exit
+   zero). The gate is the mechanical boundary; can-close is the stricter
+   since-in-flight discipline. Never advance the sub-step to done while either
+   is red.
 9. If pass and can-close is green: advance the sub-step to done via
    `npx godpowers state advance`, sync CHECKPOINT.md, run the proactive
    auto-invoke sweep, print the "Step result" card, then move to next sub-step

package/routing/recipes/bug-no-urgency.yaml

@@ -10,6 +10,10 @@ triggers:
     - "bug found"
     - "broken in dev"
     - "investigate bug"
+    - "fix a bug"
+    - "fix bug"
+    - "fix the bug"
+    - "bug"
 
 sequences:
   default:

package/routing/recipes/release-maintenance.yaml

@@ -15,6 +15,12 @@ triggers:
     - "ship a release"
     - "release the project"
     - "prepare release"
+    - "ship it"
+    - "ship"
+    - "release"
+    - "deploy"
+    - "deploy this"
+    - "deploy it"
 
 sequences:
   default:

package/routing/recipes/whats-done.yaml

@@ -17,6 +17,9 @@ triggers:
     - "deliverable progress"
     - "show the checklist"
     - "how much is built"
+    - "check progress"
+    - "progress"
+    - "check status"
 
 sequences:
   default:

package/skills/god-org-context.md

@@ -1,7 +1,7 @@
 ---
 name: god-org-context
 description: |
-  Bluefield support. Set up or read organization-level context: shared
+  Set up or read organization-level context (bluefield support): shared
   standards, conventions, infrastructure, libraries. Constrains downstream
   agents to respect org-wide decisions when building new code in an
   established context.

package/skills/god-reconcile.md

@@ -1,8 +1,10 @@
 ---
 name: god-reconcile
 description: |
-  Comprehensive reconciliation across all impacted artifacts before doing
-  feature work. Checks PRD, ARCH, ROADMAP, STACK, REPO, DEPLOY, OBSERVE,
+  Check before feature work (read-only): reconcile all impacted artifacts to
+  find conflicts before you build. This is the BEFORE half of the pair; its
+  write-back counterpart is /god-sync, which updates artifacts AFTER the work.
+  Checks PRD, ARCH, ROADMAP, STACK, REPO, DEPLOY, OBSERVE,
   HARDEN, LAUNCH, BACKLOG, SEEDS, TODOS, THREADS, repository documentation,
   repository surface, runtime feature awareness, source-system sync-back, and
   host capabilities in parallel. Replaces /god-roadmap-check (kept for

package/skills/god-smite.md

@@ -1,7 +1,7 @@
 ---
 name: god-smite
 description: |
-  Hard reset of the project's node-style dependency cache: delete
+  Clear the dependency cache (hard reset of the node-style layer): delete
   node_modules / .venv / vendor / target / .next / dist / .nuxt /
   .turbo / .nx as applicable, then reinstall. For when "have you tried
   turning it off and on again" applies to the dependency layer.

package/skills/god-sync.md

@@ -1,7 +1,10 @@
 ---
 name: god-sync
 description: |
-  Sync all affected artifacts after feature work. Updates PRD, ARCH, ROADMAP,
+  Update after feature work (write-back): sync all affected artifacts to match
+  what the work actually touched. This is the AFTER half of the pair; its
+  read-only counterpart is /god-reconcile, which checks for conflicts BEFORE
+  the work. Updates PRD, ARCH, ROADMAP,
   STACK, DEPLOY, OBSERVE, HARDEN, LAUNCH, BACKLOG, SEEDS, TODOS, THREADS
   based on what the work actually touched. Closes the loop after
   /god-reconcile + feature execution.