@warpgogol/forge 2.9.2 → 2.9.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warpgogol/forge",
-  "version": "2.9.2",
+  "version": "2.9.5",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",
@@ -19,127 +19,127 @@
     "type": "git",
     "url": "git+https://github.com/syrokomskyi/forge.git"
   },
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
   "bin": {
     "forge": "./bin/cli.js"
   },
   "exports": {
     ".": {
-      "types": "./src/index.ts",
-      "default": "./src/index.ts"
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
     },
     "./types": {
-      "types": "./src/types.ts",
-      "default": "./src/types.ts"
+      "types": "./dist/src/types.d.ts",
+      "default": "./dist/src/types.js"
     },
     "./utils": {
-      "types": "./src/utils/index.ts",
-      "default": "./src/utils/index.ts"
+      "types": "./dist/src/utils/index.d.ts",
+      "default": "./dist/src/utils/index.js"
     },
     "./config": {
-      "types": "./src/config/forge-config.ts",
-      "default": "./src/config/forge-config.ts"
+      "types": "./dist/src/config/forge-config.d.ts",
+      "default": "./dist/src/config/forge-config.js"
     },
     "./os/core": {
-      "types": "./os/core/core.module.ts",
-      "default": "./os/core/core.module.ts"
+      "types": "./dist/os/core/core.module.d.ts",
+      "default": "./dist/os/core/core.module.js"
     },
     "./os/compass": {
-      "types": "./os/compass/index.ts",
-      "default": "./os/compass/index.ts"
+      "types": "./dist/os/compass/index.d.ts",
+      "default": "./dist/os/compass/index.js"
     },
     "./os/naming": {
-      "types": "./os/naming/index.ts",
-      "default": "./os/naming/index.ts"
+      "types": "./dist/os/naming/index.d.ts",
+      "default": "./dist/os/naming/index.js"
     },
     "./os/naming-module": {
-      "types": "./os/naming/naming.module.ts",
-      "default": "./os/naming/naming.module.ts"
+      "types": "./dist/os/naming/naming.module.d.ts",
+      "default": "./dist/os/naming/naming.module.js"
     },
     "./os/rfc": {
-      "types": "./os/rfc/index.ts",
-      "default": "./os/rfc/index.ts"
+      "types": "./dist/os/rfc/index.d.ts",
+      "default": "./dist/os/rfc/index.js"
     },
     "./os/rfc-module": {
-      "types": "./os/rfc/rfc.module.ts",
-      "default": "./os/rfc/rfc.module.ts"
+      "types": "./dist/os/rfc/rfc.module.d.ts",
+      "default": "./dist/os/rfc/rfc.module.js"
     },
     "./os/werkstatt": {
-      "types": "./os/werkstatt/index.ts",
-      "default": "./os/werkstatt/index.ts"
+      "types": "./dist/os/werkstatt/index.d.ts",
+      "default": "./dist/os/werkstatt/index.js"
     },
     "./os/workflow": {
-      "types": "./os/workflow/index.ts",
-      "default": "./os/workflow/index.ts"
+      "types": "./dist/os/workflow/index.d.ts",
+      "default": "./dist/os/workflow/index.js"
     },
     "./os/workflow-module": {
-      "types": "./os/workflow/workflow.module.ts",
-      "default": "./os/workflow/workflow.module.ts"
+      "types": "./dist/os/workflow/workflow.module.d.ts",
+      "default": "./dist/os/workflow/workflow.module.js"
     },
     "./os/spec-module": {
-      "types": "./os/spec/spec.module.ts",
-      "default": "./os/spec/spec.module.ts"
+      "types": "./dist/os/spec/spec.module.d.ts",
+      "default": "./dist/os/spec/spec.module.js"
     },
     "./os/adr": {
-      "types": "./os/adr/index.ts",
-      "default": "./os/adr/index.ts"
+      "types": "./dist/os/adr/index.d.ts",
+      "default": "./dist/os/adr/index.js"
     },
     "./os/adr-module": {
-      "types": "./os/adr/adr.module.ts",
-      "default": "./os/adr/adr.module.ts"
+      "types": "./dist/os/adr/adr.module.d.ts",
+      "default": "./dist/os/adr/adr.module.js"
     },
     "./os/plan": {
-      "types": "./os/plan/index.ts",
-      "default": "./os/plan/index.ts"
+      "types": "./dist/os/plan/index.d.ts",
+      "default": "./dist/os/plan/index.js"
     },
     "./os/plan-module": {
-      "types": "./os/plan/plan.module.ts",
-      "default": "./os/plan/plan.module.ts"
+      "types": "./dist/os/plan/plan.module.d.ts",
+      "default": "./dist/os/plan/plan.module.js"
     },
     "./os/audit": {
-      "types": "./os/audit/index.ts",
-      "default": "./os/audit/index.ts"
+      "types": "./dist/os/audit/index.d.ts",
+      "default": "./dist/os/audit/index.js"
     },
     "./os/audit-module": {
-      "types": "./os/audit/audit.module.ts",
-      "default": "./os/audit/audit.module.ts"
+      "types": "./dist/os/audit/audit.module.d.ts",
+      "default": "./dist/os/audit/audit.module.js"
     },
     "./os/session": {
-      "types": "./os/session/index.ts",
-      "default": "./os/session/index.ts"
+      "types": "./dist/os/session/index.d.ts",
+      "default": "./dist/os/session/index.js"
     },
     "./os/session-module": {
-      "types": "./os/session/session.module.ts",
-      "default": "./os/session/session.module.ts"
+      "types": "./dist/os/session/session.module.d.ts",
+      "default": "./dist/os/session/session.module.js"
     },
     "./os/mission": {
-      "types": "./os/mission/index.ts",
-      "default": "./os/mission/index.ts"
+      "types": "./dist/os/mission/index.d.ts",
+      "default": "./dist/os/mission/index.js"
     },
     "./os/mission-module": {
-      "types": "./os/mission/mission.module.ts",
-      "default": "./os/mission/mission.module.ts"
+      "types": "./dist/os/mission/mission.module.d.ts",
+      "default": "./dist/os/mission/mission.module.js"
     },
     "./os/exploration": {
-      "types": "./os/exploration/index.ts",
-      "default": "./os/exploration/index.ts"
+      "types": "./dist/os/exploration/index.d.ts",
+      "default": "./dist/os/exploration/index.js"
     },
     "./os/exploration-module": {
-      "types": "./os/exploration/exploration.module.ts",
-      "default": "./os/exploration/exploration.module.ts"
+      "types": "./dist/os/exploration/exploration.module.d.ts",
+      "default": "./dist/os/exploration/exploration.module.js"
     },
     "./os/notes": {
-      "types": "./os/notes/index.ts",
-      "default": "./os/notes/index.ts"
+      "types": "./dist/os/notes/index.d.ts",
+      "default": "./dist/os/notes/index.js"
     },
     "./os/notes-module": {
-      "types": "./os/notes/notes.module.ts",
-      "default": "./os/notes/notes.module.ts"
+      "types": "./dist/os/notes/notes.module.d.ts",
+      "default": "./dist/os/notes/notes.module.js"
     },
     "./os/program": {
-      "types": "./os/program/program.module.ts",
-      "default": "./os/program/program.module.ts"
+      "types": "./dist/os/program/program.module.d.ts",
+      "default": "./dist/os/program/program.module.js"
     }
   },
   "files": [
@@ -154,16 +154,6 @@
     "README.md",
     "LICENSE"
   ],
-  "scripts": {
-    "build": "pnpm exec tsc -p tsconfig.json",
-    "build:check": "pnpm exec tsc -p tsconfig.json --noEmit",
-    "lint": "pnpm exec eslint \"src/**/*.ts\" \"os/**/*.ts\"",
-    "typecheck": "pnpm exec tsc -p tsconfig.json --noEmit",
-    "test": "vitest run --passWithNoTests",
-    "test:watch": "vitest",
-    "test:tarball:node24": "node test-fixtures/node24-consumer/smoke.mjs",
-    "prepublishOnly": "pnpm exec tsc -p tsconfig.json"
-  },
   "dependencies": {
     "@aws-sdk/client-s3": "^3.700.0",
     "trash": "^10.1.1",
@@ -173,7 +163,7 @@
   "devDependencies": {
     "@types/node": "^24.0.0",
     "@warpgogol/werkstatt-shared": "*",
-    "@warpgogol/werkstatt": "1.4.0",
+    "@warpgogol/werkstatt": "*",
     "eslint": "^10.8.0",
     "fast-check": "^4.9.0",
     "typescript": "^6.0.3",
@@ -184,127 +174,15 @@
     "node": ">=24 <25"
   },
   "publishConfig": {
-    "access": "public",
-    "main": "./dist/src/index.js",
-    "types": "./dist/src/index.d.ts",
-    "exports": {
-      ".": {
-        "types": "./dist/src/index.d.ts",
-        "default": "./dist/src/index.js"
-      },
-      "./types": {
-        "types": "./dist/src/types.d.ts",
-        "default": "./dist/src/types.js"
-      },
-      "./utils": {
-        "types": "./dist/src/utils/index.d.ts",
-        "default": "./dist/src/utils/index.js"
-      },
-      "./config": {
-        "types": "./dist/src/config/forge-config.d.ts",
-        "default": "./dist/src/config/forge-config.js"
-      },
-      "./os/core": {
-        "types": "./dist/os/core/core.module.d.ts",
-        "default": "./dist/os/core/core.module.js"
-      },
-      "./os/compass": {
-        "types": "./dist/os/compass/index.d.ts",
-        "default": "./dist/os/compass/index.js"
-      },
-      "./os/naming": {
-        "types": "./dist/os/naming/index.d.ts",
-        "default": "./dist/os/naming/index.js"
-      },
-      "./os/naming-module": {
-        "types": "./dist/os/naming/naming.module.d.ts",
-        "default": "./dist/os/naming/naming.module.js"
-      },
-      "./os/rfc": {
-        "types": "./dist/os/rfc/index.d.ts",
-        "default": "./dist/os/rfc/index.js"
-      },
-      "./os/rfc-module": {
-        "types": "./dist/os/rfc/rfc.module.d.ts",
-        "default": "./dist/os/rfc/rfc.module.js"
-      },
-      "./os/werkstatt": {
-        "types": "./dist/os/werkstatt/index.d.ts",
-        "default": "./dist/os/werkstatt/index.js"
-      },
-      "./os/workflow": {
-        "types": "./dist/os/workflow/index.d.ts",
-        "default": "./dist/os/workflow/index.js"
-      },
-      "./os/workflow-module": {
-        "types": "./dist/os/workflow/workflow.module.d.ts",
-        "default": "./dist/os/workflow/workflow.module.js"
-      },
-      "./os/spec-module": {
-        "types": "./dist/os/spec/spec.module.d.ts",
-        "default": "./dist/os/spec/spec.module.js"
-      },
-      "./os/adr": {
-        "types": "./dist/os/adr/index.d.ts",
-        "default": "./dist/os/adr/index.js"
-      },
-      "./os/adr-module": {
-        "types": "./dist/os/adr/adr.module.d.ts",
-        "default": "./dist/os/adr/adr.module.js"
-      },
-      "./os/plan": {
-        "types": "./dist/os/plan/index.d.ts",
-        "default": "./dist/os/plan/index.js"
-      },
-      "./os/plan-module": {
-        "types": "./dist/os/plan/plan.module.d.ts",
-        "default": "./dist/os/plan/plan.module.js"
-      },
-      "./os/audit": {
-        "types": "./dist/os/audit/index.d.ts",
-        "default": "./dist/os/audit/index.js"
-      },
-      "./os/audit-module": {
-        "types": "./dist/os/audit/audit.module.d.ts",
-        "default": "./dist/os/audit/audit.module.js"
-      },
-      "./os/session": {
-        "types": "./dist/os/session/index.d.ts",
-        "default": "./dist/os/session/index.js"
-      },
-      "./os/session-module": {
-        "types": "./dist/os/session/session.module.d.ts",
-        "default": "./dist/os/session/session.module.js"
-      },
-      "./os/mission": {
-        "types": "./dist/os/mission/index.d.ts",
-        "default": "./dist/os/mission/index.js"
-      },
-      "./os/mission-module": {
-        "types": "./dist/os/mission/mission.module.d.ts",
-        "default": "./dist/os/mission/mission.module.js"
-      },
-      "./os/exploration": {
-        "types": "./dist/os/exploration/index.d.ts",
-        "default": "./dist/os/exploration/index.js"
-      },
-      "./os/exploration-module": {
-        "types": "./dist/os/exploration/exploration.module.d.ts",
-        "default": "./dist/os/exploration/exploration.module.js"
-      },
-      "./os/notes": {
-        "types": "./dist/os/notes/index.d.ts",
-        "default": "./dist/os/notes/index.js"
-      },
-      "./os/notes-module": {
-        "types": "./dist/os/notes/notes.module.d.ts",
-        "default": "./dist/os/notes/notes.module.js"
-      },
-      "./os/program": {
-        "types": "./dist/os/program/program.module.d.ts",
-        "default": "./dist/os/program/program.module.js"
-      }
-    }
+    "access": "public"
   },
-  "packageManager": "pnpm@11.10.0"
-}
+  "scripts": {
+    "build": "pnpm exec tsc -p tsconfig.json",
+    "build:check": "pnpm exec tsc -p tsconfig.json --noEmit",
+    "lint": "pnpm exec eslint \"src/**/*.ts\" \"os/**/*.ts\"",
+    "typecheck": "pnpm exec tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest",
+    "test:tarball:node24": "node test-fixtures/node24-consumer/smoke.mjs"
+  }
+}

package/skills/_shared/fo-pipeline-conventions.md

@@ -92,15 +92,15 @@ Every `run_command` call MUST use a 6-minute (360 000 ms) execution budget. This
 3. **If completed**: Read the output and proceed normally.
 4. **If still running after 6 min**: Abandon the command — do not wait further. Try an alternative approach (different command, different scope, or skip the step). If no alternative exists, retry the same command once with the same 6-min budget.
 5. **Max retries**: 2 attempts per command. After 2 failed attempts, report to the operator and ask how to proceed.
-6. **No infinite waits**: NEVER call `command_status` with `WaitDurationSeconds` > 60. NEVER use `Blocking: true` for commands that may hang (builds, checks, `site-kernel run`, `astro check`, `tsc`, `pnpm install`).
+6. **No infinite waits**: NEVER call `command_status` with `WaitDurationSeconds` > 60. NEVER use `Blocking: true` for commands that may hang (builds, checks, long-running CLI commands, `astro check`, `tsc`, `pnpm install`).
 7. **Exceptions**: `Blocking: true` is allowed only for trivially fast commands (e.g., `node --version`, `git log -n 1`, `git status --short`) that are guaranteed to complete in seconds.
 
 ### Rationale
 
 - The `run_command` tool has no built-in timeout parameter. `WaitMsBeforeAsync` is the only mechanism to regain control after a fixed duration.
 - Abandoning a still-running process is acceptable — the process may complete in the background, but the agent is unblocked and can retry or try an alternative.
-- This covers all command classes: `pnpm exec werkstatt run ...`, `pnpm --filter <pkg> run build:check`, `astro check`, `git`, `pnpm install`, etc.
-- Site-kernel commands already have internal `timeoutMs`, but the agent-side 6-min budget is a safety net for ALL commands, not just site-kernel.
+- This covers all command classes: `pnpm exec forge ...`, `pnpm --filter <pkg> run build:check`, `astro check`, `git`, `pnpm install`, etc.
+- Project CLI commands may have internal `timeoutMs`, but the agent-side 6-min budget is a safety net for ALL commands, not just project CLI.
 
 ## Binding resolution and degradation
 
@@ -140,8 +140,8 @@ Skills reference bindings by key, never by value. To resolve a binding:
 
 A skill needs to run `rfc.validate` for `RFC-XXXX`:
 
-1. Read `forge.yaml` → `bindings.commands.validateRfc` = `"pnpm exec werkstatt run rfc.validate {id} --json"`
-2. Substitute `{id}` → `"pnpm exec werkstatt run rfc.validate RFC-XXXX --json"`
+1. Read `forge.yaml` → `bindings.commands.validateRfc` = `"forge rfc.validate {id} --json"`
+2. Substitute `{id}` → `"forge rfc.validate RFC-XXXX --json"`
 3. Run the resolved command.
 
 If `bindings.commands.validateRfc` were `null`, the skill would skip the step and report: `Degraded: commands.validateRfc — not configured in forge.yaml`.
@@ -276,6 +276,45 @@ When a pipeline step fails and cannot be auto-fixed within 2 attempts (per §Com
 
 The error checkpoint doubles as a resume marker: when resuming an interrupted session, scan for the last error checkpoint. If found, resume from the failed step using the partialState and resumePoint fields.
 
+## Pipeline continuation
+
+When a pipeline step completes (audit, enhance, plan), the agent MUST proactively suggest the next step and offer to proceed. This is NOT automatic chaining — the agent asks the operator first. This applies when the operator is manually driving the pipeline step by step.
+
+### After audit completes
+
+The audit report is persisted and committed. The agent MUST:
+
+1. Present the audit summary.
+2. State: "The next pipeline step is `fo-idea-enhance` — it applies the audit findings to the RFC."
+3. Ask: "Proceed to enhance?" using `ask_user_question` with "Yes, enhance" as the recommended option.
+4. If the operator says yes, invoke `fo-idea-enhance` via the `skill` tool.
+
+### After enhance completes
+
+The enhanced RFC is committed. The agent MUST:
+
+1. Present the enhancement summary.
+2. State: "The next pipeline step is `fo-idea-plan` — it transitions the RFC to accepted and creates the implementation plan."
+3. Ask: "Proceed to plan?" using `ask_user_question` with "Yes, plan" as the recommended option.
+4. If the operator says yes, invoke `fo-idea-plan` via the `skill` tool.
+
+### After plan completes
+
+The plan is committed. The agent MUST:
+
+1. Present the plan summary.
+2. State: "The next pipeline step is `fo-idea-implement` — it executes the plan and stamps the RFC as implemented."
+3. Ask: "Proceed to implement?" using `ask_user_question` with "Yes, implement" as the recommended option.
+4. If the operator says yes, invoke `fo-idea-implement` via the `skill` tool.
+
+### Exception: orchestrator skills
+
+When the pipeline is driven by `fo-idea-i-just-want-to-see-the-result` or `fo-idea-i-just-want-to-see-the-plan`, the orchestrator handles chaining automatically. The continuation suggestion is NOT emitted — the orchestrator's "no pauses between pipeline steps" rule applies.
+
+### Exception: operator declines
+
+If the operator declines the continuation suggestion, the agent stops. The operator can invoke the next step manually later. Do not re-ask.
+
 ## Batch plan preview
 
 When the orchestrator skill processes multiple documents (>=2), emit a batch plan preview before starting the first document. The preview is a table showing: processing order, document id, type, complexity estimate, dependencies, and notes.

package/skills/_shared/fo-prerequisites.md

@@ -0,0 +1,81 @@
+# WG Pipeline Prerequisites & Batch Processing
+
+Reference for `fo-idea-audit`, `fo-idea-enhance`, `fo-idea-plan`, `fo-idea-implement`. These skills share identical input parsing, prerequisite checks, and batch loop behavior.
+
+## Input parsing
+
+The operator may provide:
+
+- **A single id**: `RFC-0362`, `ADR-0003`, a filename, or a path.
+- **A comma-separated list**: `RFC-0355, RFC-0356, RFC-0357` — process each in order.
+- **A range**: `RFC-0355..RFC-0360` or `от RFC-0355 до RFC-0360` — discover all files in `docs/rfcs/` whose numeric id falls within the inclusive range, sort ascending, and process each in order. Ranges are only valid within a single document type (RFC or ADR).
+- **Nothing**: if a document file is open in the IDE, use it. Otherwise, ask.
+
+## Common prerequisite checks
+
+Run these **in order** for each document. If any check fails, record the document as **skipped** in the batch summary with the reason, and immediately proceed to the next document. Do not stop the entire batch — skip and report.
+
+1. **Prefix check** — if the id starts with `ADR-` and this skill handles RFCs only, skip with: `ADR-XXXX is an ADR, not an RFC. ADRs do not have <this step>. The ADR pipeline is: create → implement (includes review → fix). Run /fo-idea-implement ADR-XXXX to implement.`
+
+   If the id starts with `RFC-` and this skill handles ADRs only, skip with: `RFC-XXXX is an RFC, not an ADR. Use the RFC pipeline: create → audit → enhance → plan → implement (includes review → fix).`
+
+2. **File exists** — look for `docs/rfcs/rfc-XXXX-*.md` (or `docs/adrs/adr-XXXX-*.md` for ADRs). If no file is found, skip with: `RFC-XXXX not found in docs/rfcs/. Run /fo-idea-create-rfc first.`
+
+3. **Terminal status check** — read the document's `status` frontmatter. If the status is `implemented`, skip with: `RFC-XXXX is already implemented. Nothing to do.` If the status is `rejected` or `superseded`, skip with: `RFC-XXXX is <status> (terminal). Terminal RFCs cannot be <this action>. To change this decision, create a new RFC with supersedes: [RFC-XXXX] via /fo-idea-create-rfc.`
+
+## Skill-specific prerequisite checks
+
+After the common checks, each skill adds its own:
+
+### fo-idea-audit
+
+No additional checks.
+
+### fo-idea-enhance
+
+4. **Accepted status check** — if the status is `accepted`, skip with: `RFC-XXXX is accepted. Accepted RFCs cannot be edited in place. Run /fo-idea-create-rfc with amends: [RFC-XXXX] to create an amending RFC, or supersedes: [RFC-XXXX] to create a superseding RFC.`
+
+### fo-idea-plan
+
+4. **Audit check** — look for `docs/audits/audit-rfc-XXXX-*.md`. If no audit file exists, skip with: `No audit report found for RFC-XXXX in docs/audits/. Run /fo-idea-audit RFC-XXXX first. The pipeline is: create → audit → enhance → plan → implement (includes review → fix).`
+
+5. **Enhance check** — read the RFC's frontmatter and look for the `enhancedAt` field. If `enhancedAt` is absent, skip with: `RFC-XXXX has not been enhanced (no enhancedAt in frontmatter). Run /fo-idea-enhance RFC-XXXX first. The pipeline is: create → audit → enhance → plan → implement (includes review → fix).`
+
+6. **Accepted status check** — if the status is `accepted` and both audit and enhance are done, prerequisites are met. If the status is `draft` or `reviewing` and has `enhancedAt`, the user's instruction to plan IS the architecture acceptance — proceed to the draft→accepted transition.
+
+### fo-idea-implement
+
+4. **Audit check** — look for `docs/audits/audit-rfc-XXXX-*.md`. If no audit file exists, skip with: `No audit report found for RFC-XXXX in docs/audits/. Run /fo-idea-audit RFC-XXXX first. The pipeline is: create → audit → enhance → plan → implement (includes review → fix).`
+
+5. **Enhance check** — read the RFC's frontmatter and look for the `enhancedAt` field. If `enhancedAt` is absent, skip with: `RFC-XXXX has not been enhanced (no enhancedAt in frontmatter). Run /fo-idea-enhance RFC-XXXX first. The pipeline is: create → audit → enhance → plan → implement (includes review → fix).`
+
+6. **Accepted status check** — if the status is not `accepted` (e.g. `draft` or `reviewing`), skip with: `RFC-XXXX is <status>, not accepted. Run /fo-idea-plan RFC-XXXX first — it will transition the RFC to accepted and create the plan. The pipeline is: create → audit → enhance → plan → implement (includes review → fix).`
+
+7. **Plan check** — look for `docs/plans/plan-rfc-XXXX-*.md`. If no plan file exists, skip with: `No plan file found for RFC-XXXX in docs/plans/. Run /fo-idea-plan RFC-XXXX first. The pipeline is: create → audit → enhance → plan → implement (includes review → fix).`
+
+## Batch processing
+
+When multiple documents are identified, **loop through each one** and run the full skill process for each sequentially **without pauses between documents**. Do not stop, present a summary, or ask the user between documents — once the work for one document is committed (or it is skipped), immediately proceed to the next document. **Do not emit transition messages such as "Moving to RFC-XXXX next" or per-document status reports during the loop.** Internal status is fine, but nothing is shown to the user until the very end. Only after all documents are processed, print a single final batch summary.
+
+**Exception:** Interactive steps within a skill (grilling, resolving open questions) are inherently interactive — they may require user responses. This is not a "pause between documents" but a required step within one document's processing. Resolve all interactions for the current document before proceeding to the next.
+
+## Batch summary format
+
+After all documents are processed, present a single batch summary:
+
+```
+## Batch <Action> Summary
+
+### Documents requested: <N>
+### Documents processed: <N>
+### Documents skipped: <list with reason>
+
+| ID | Type | Status | <action-specific columns> |
+|---|---|---|---|
+| RFC-0355 | RFC | <result> | ... |
+| ADR-0003 | ADR | <result> | ... |
+
+### Total commits: <count>
+```
+
+Do not output per-document summaries or "Moving to XXXX next" messages during the loop; they belong here, at the very end.

package/skills/fo/fo-extract-dna/SKILL.md

@@ -52,7 +52,7 @@ Before proposing any candidate, read `ref(forge.yaml bindings.paths.invariantsFi
 - Which invariants are marked "Foundational invariant (pre-RFC)" vs "Established by RFC-XXXX".
 - Which invariants have been "Reclassified to feature".
 
-Also read the RFC template (`os/rfc/rfc-0000-template.md` inside `@warpgogol/forge`) to understand the `satisfies` field and the "DNA-N established by this RFC" marker pattern.
+Also read the RFC template (`docs/rfcs/rfc-0000-template.md`) to understand the `satisfies` field and the "DNA-N established by this RFC" marker pattern.
 
 ### 3. Discover DNA candidates
 

package/skills/fo/fo-idea-audit/AUDIT-AXES.md

@@ -0,0 +1,66 @@
+# Audit Axes
+
+Load this file when running step 4 of `fo-idea-audit`. For each axis, check every item. An item either **passes**, **fails** (specific finding with evidence), or is **not applicable** (state why). Skip N/A items silently — do not pad the report.
+
+## Axis A — Structural completeness
+
+Beyond V-13 (required sections exist) and V-14 (≥3 acceptance items), check that each section contains real content, not template placeholders or empty HTML comments:
+
+- **Decision** is a single decision in present tense ("The kernel gains…"), not a wishlist or "we should".
+- **CLI surface** shows exact project CLI invocations with flags and scope.
+- **TypeScript contracts** are minimal type signatures, not full implementations.
+- **File system responsibilities** table names concrete paths the RFC touches.
+- **Output format** documents the `--json` shape.
+- **Failure modes** specifies exit codes and warn-vs-fail behavior.
+- **Rollout** describes default behavior, adoption path for existing apps, and new-app compliance.
+- **Alternatives considered** is honest — at least one real alternative with a rejection reason.
+- **Risks** includes agent misinterpretation risk and false-positive rate for validators.
+- **Acceptance criteria** items are checkable (can an agent or human verify each one?) and sufficient (do they cover the decision's full scope?).
+- **Implementation notes for agents** are explicit behavioral rules, not vague guidance.
+
+## Axis B — DNA alignment
+
+- Each entry in `satisfies[]` is a real DNA invariant in `docs/architecture-dna.md`, and the RFC body explains **how** it enforces, protects, or extends that invariant — not just that it's "related".
+- If the RFC establishes a new DNA invariant (body says "DNA-N established by this RFC"), the audit confirms `docs/architecture-dna.md` will need a new `## DNA-N` entry and the RFC's `satisfies[]` includes it.
+- The RFC does not silently conflict with any existing DNA invariant. If it changes a DNA invariant, it must `supersede` the establishing RFC — not amend it.
+- `related[]` DNA references are relevant and not decorative.
+
+## Axis C — Ecosystem fit
+
+- **Package boundaries**: imports flow `apps/* → packages/*` and `services/* → packages/*`, never `apps/* → apps/*` or `apps/* → services/*` (DNA-1). If the RFC proposes a new package, it belongs in `packages/*`.
+- **Pipeline placement**: the RFC names the correct pipeline for each new check — `build.prepare`, `build.check`, `sites-check`, `sites-check-postbuild` — and the choice is justified (blocking vs. advisory).
+- **Compass sync**: if the RFC changes repository-wide requirements, shared package contracts, or app-package relationships, it identifies which `docs/*.xml` files need synchronization (root AGENTS.md Compass document duties).
+- **AGENTS.md updates**: the RFC identifies which `AGENTS.md` files need rule updates (root, `apps/`, `packages/`, `services/`, or site-specific).
+- **Cosmic naming**: if the RFC touches manifests or component/section/page contracts, it addresses the three-way alignment (manifest `cosmicName` ↔ `PLANET_IMPORT_PATHS`/`MOON_IMPORT_PATHS` ↔ `system.md` pins).
+- **Command lifecycle**: `commands.proposed/added/changed/removed` buckets are internally consistent — proposed commands that the RFC introduces will land in `added` upon implementation; changed commands are existing registered commands; removed commands are explicitly deprecated.
+
+## Axis D — Forward-only compliance
+
+This ecosystem is forward-only — no backward compatibility layers, no expand-then-contract migrations. Check:
+
+- The RFC does not propose a compatibility shim, bridge, or dual-path that keeps legacy behavior alive alongside the new one.
+- Deprecation means removal in the same RFC wave, not an indefinite grace period.
+- If the RFC amends another RFC, it changes the amended RFC's contract directly — it does not add a parallel interpretation.
+- Legacy code paths are deleted, not maintained behind a flag.
+
+## Axis E — Agent-facing policy
+
+- **Status gate**: the RFC does not contain self-authorizing language ("may proceed while draft", "implementation can start before acceptance"). Draft RFCs cannot grant implementation permission.
+- **Implementation notes** reference the correct governance rules: RFC-0224 (accepted→implemented transition), RFC-0230 (if touching agent surface), RFC-0334 (supersede escalation on invariant conflict), RFC-0330 (verification evidence for probe-bearing RFCs).
+- **Anti-fabrication**: if the RFC's acceptance criteria include content authoring (prose, business records, claims), the criteria distinguish between code changes an agent can make and content that requires human authoring. The RFC must not claim content will be "auto-generated" when it requires human authoring.
+- **Storage policy**: if the RFC touches persistence, it does not introduce cookies (`document.cookie`, `Set-Cookie`). Client-side persistence is `localStorage` only; server-side is `unstorage`.
+
+## Axis F — Pragmatism
+
+- **Minimal command surface**: each proposed command earns its existence — no command that could be a flag on an existing command, no command that duplicates an existing command's scope.
+- **Lean contracts**: TypeScript types are the minimum needed to understand the shape — no speculative generality, no unused optional fields, no abstraction for needs the RFC doesn't have.
+- **Existing patterns**: the RFC checks whether an existing command, schema, or pattern can be extended before proposing a new one. If a new one is proposed, the alternatives section explains why extension was insufficient.
+- **Scope discipline**: `appsImpacted` and `packagesImpacted` list only what's actually impacted. `nonGoals` are explicit and meaningful, not boilerplate.
+
+## Axis G — Blind spots
+
+- **Performance**: build-time commands specify their cost (file scan count, regex complexity, I/O patterns). A command that scans all `apps/**` on every `build.check` is a bottleneck.
+- **False positives**: validators estimate their false-positive rate and describe how to suppress noise during migration.
+- **Edge cases**: the RFC considers empty states (new app with no content, package with no manifests), concurrent execution (two builds, two agents), and interrupted operations (crash mid-write).
+- **Migration path**: existing apps' path to compliance is documented — do they pass without changes, or is there a documented migration window?
+- **Security/privacy**: if the RFC touches user data, PII, or external services, it addresses GDPR/privacy implications and secret management (no hardcoded keys, env vars documented in `.env.example` per DNA-40).

package/skills/fo/fo-idea-audit/SKILL.md

@@ -236,9 +236,9 @@ Semantic audit of RFC-XXXX (<title>). Verdict: <approved | needs-revision | reje
 
 Stage only the audit file — do not stage unrelated changes. Another agent may be working in a different session; `git add -A` or `git add .` is forbidden.
 
-### 8. Stop
+### 8. Stop and suggest next step
 
-Do not modify the RFC or any other file. Do not run `/fo-idea-plan` or `/fo-idea-implement` — those are separate skills with different purposes. Present the report and stop. If the user asks to fix the findings, suggest running `/fo-idea-enhance` — it reads the persisted audit and applies the fixes. The full pipeline is: create → audit → enhance → plan → implement.
+Do not modify the RFC or any other file. Present the report. Then follow the pipeline continuation protocol per `_shared/fo-pipeline-conventions.md` §Pipeline continuation — proactively suggest the next step (`fo-idea-enhance`) and offer to proceed via `ask_user_question`. Do not automatically run the next skill — ask the operator first. The full pipeline is: create → audit → enhance → plan → implement.
 
 ## Constraints
 

package/skills/fo/fo-idea-create-adr/SKILL.md

@@ -54,7 +54,7 @@ If any item is false, use `fo-idea-create-rfc` instead and stop.
 - **title** (required) — short imperative sentence.
 - **scope** — `package`, `app`, or `workspace`. Default `package`.
 - **decider** — default `architecture`. The named decider is the only role that may move the ADR out of `proposed`.
-- **reviewers** — default empty. When the operator has not specified a reviewer, read the default reviewer(s) from the `reviewers` field comment in `docs/adrs/adr-0000-template.md` (currently `human:andrii-syrokomskyi`). Set all listed default reviewers.
+- **reviewers** — default empty. When the operator has not specified a reviewer, read the default reviewer(s) from the `reviewers` field comment in `docs/adrs/adr-0000-template.md`. Set all listed default reviewers.
 - **related** — any RFCs, ADRs, DNA invariants, or specs this decision relates to.
 
 ### 4. Grill the concept (skip if invoked with an accepted decision)