@warpgogol/forge 1.2.2 → 2.1.0

package/profiles/godot-csharp.yaml

@@ -108,6 +108,9 @@ workspace:
     - packages
     - services
     - scripts
+    - tools
+    - missions
+    - systems-cache
   files:
     - path: pnpm-workspace.yaml
       content: |
@@ -159,6 +162,14 @@ workspace:
         obj/
         *.user
         *.csproj.user
+    - path: .vscode/extensions.json
+      content: |
+        {
+          "recommendations": [
+            "ms-dotnettools.csharp",
+            "geequla.godot-tools"
+          ]
+        }
     - path: .github/workflows/ci.yml
       content: |
         name: CI
@@ -284,6 +295,14 @@ workspace:
             "build:check": "turbo run build:check",
             "test": "turbo run test",
             "upgrade-packages": "pnpm -r up"
+          },
+          "devDependencies": {
+            "typescript": "^5.7.0",
+            "turbo": "^2.3.0",
+            "prettier": "^3.4.0",
+            "@warpgogol/forge": "^2.0.0",
+            "@warpgogol/werkstatt": "^1.0.0",
+            "@warpgogol/werkstatt-godot": "^0.5.0"
           }
         }
     - path: scripts/clean.mjs
@@ -325,8 +344,149 @@ workspace:
         }
 
         console.log(`Cleaned ${toDelete.length} directories.`);
+    - path: tools/kernel.config.ts
+      content: |
+        import { defineKernelConfig } from "@warpgogol/werkstatt/kernel/types";
+        import { werkstattGodotPlugin } from "@warpgogol/werkstatt-godot";
+
+        export default defineKernelConfig({
+          name: "__PROJECT_NAME__",
+          description: "__PROJECT_NAME__ workshop",
+          moduleLoaders: {
+            "forge-core": async () => (await import("@warpgogol/forge/os/core")).forgeCoreModule,
+            "forge-rfc": async () => (await import("@warpgogol/forge/os/rfc-module")).forgeRfcModule,
+            "forge-adr": async () => (await import("@warpgogol/forge/os/adr-module")).forgeAdrModule,
+            "forge-plan": async () => (await import("@warpgogol/forge/os/plan-module")).forgePlanModule,
+            "forge-audit": async () => (await import("@warpgogol/forge/os/audit-module")).forgeAuditModule,
+            "forge-compass": async () => (await import("@warpgogol/forge/os/compass")).forgeCompassModule,
+            "forge-naming": async () => (await import("@warpgogol/forge/os/naming-module")).forgeNamingModule,
+            "forge-workflow": async () => (await import("@warpgogol/forge/os/workflow-module")).forgeWorkflowModule,
+            "forge-session": async () => (await import("@warpgogol/forge/os/session-module")).forgeSessionModule,
+            "forge-mission": async () => (await import("@warpgogol/forge/os/mission-module")).forgeMissionModule,
+            "forge-spec": async () => (await import("@warpgogol/forge/os/spec-module")).forgeSpecModule,
+            "forge-exploration": async () => (await import("@warpgogol/forge/os/exploration")).forgeExplorationModule,
+            "forge-program": async () => (await import("@warpgogol/forge/os/program")).forgeProgramModule,
+            "forge-werkstatt": async () => (await import("@warpgogol/forge/os/werkstatt")).forgeWerkstattModule,
+            mission: async () => (await import("@warpgogol/werkstatt/mission-module")).createMissionModule(),
+            sternsystem: async () => (await import("@warpgogol/werkstatt/sternsystem-module")).createSternsystemModule(),
+            bordbuch: async () => (await import("@warpgogol/werkstatt/bordbuch-module")).createBordbuchModule(),
+            "artifact-store": async () => (await import("@warpgogol/werkstatt/artifact-store-module")).createArtifactStoreModule(),
+            release: async () => (await import("@warpgogol/werkstatt/release-module")).createReleaseModule(),
+            leitstand: async () => (await import("@warpgogol/werkstatt/leitstand-module")).createLeitstandModule(),
+            notausgang: async () => (await import("@warpgogol/werkstatt/notausgang-module")).createNotausgangModule(),
+            evidence: async () => (await import("@warpgogol/werkstatt/evidence-module")).createEvidenceModule(),
+            "werkstatt-plugin": async () => (await import("@warpgogol/werkstatt/os/werkstatt-plugin-module")).forgeWerkstattPluginModule,
+            "werkstatt-autonomy": async () => (await import("@warpgogol/werkstatt/os/werkstatt-autonomy-module")).werkstattAutonomyModule,
+            "__PROJECT_NAME__-plugin": async () => werkstattGodotPlugin,
+          },
+        });
+    - path: .npmrc
+      content: |
+        # @warpgogol scoped registry — replace YOUR_NPM_TOKEN with a valid npm read token
+        @warpgogol:registry=https://registry.npmjs.org/
+        //registry.npmjs.org/:_authToken=YOUR_NPM_TOKEN
+    - path: eslint.config.js
+      content: |
+        export default [
+          {
+            rules: {},
+          },
+        ];
+    - path: .prettierrc.mjs
+      content: |
+        export default {
+          semi: true,
+          singleQuote: false,
+          trailingComma: "all",
+          printWidth: 100,
+          tabWidth: 2,
+        };
+    - path: .gitattributes
+      content: |
+        # No LFS patterns for this stack
+    - path: hooks/pre-commit
+      content: |
+        #!/bin/sh
+        # Platform-scope pre-commit guard
+        # Runs werkstatt autonomy and plugin validation before commits
+        echo "Pre-commit: running platform checks..."
+        pnpm exec werkstatt run werkstatt.autonomy.validate || exit 1
+        pnpm exec werkstatt run werkstatt.plugin.validate || exit 1
+    - path: systems-cache/.gitkeep
+      content: |
+        # Sternsystem cache directory (RFC-0790)
+        # Per-system config and state files live in systems-cache/<id>/
+    - path: missions/.gitkeep
+      content: ""
+    - path: .forge/pinned.yaml
+      content: |
+        # Pinned foundation files (DNA-62, RFC-0733)
+        # Protect mode: warns on delete/move. Freeze mode: blocks modify too.
+        entries:
+          - path: tools/kernel.config.ts
+            mode: protect
+          - path: forge.yaml
+            mode: protect
+          - path: pnpm-workspace.yaml
+            mode: protect
+          - path: turbo.json
+            mode: protect
+          - path: tsconfig.base.json
+            mode: protect
+          - path: systems-cache/.gitkeep
+            mode: protect
+    - path: README.md
+      content: |
+        # __PROJECT_NAME__
+
+        A Warpgogol workshop powered by the Werkstatt engine and the @warpgogol/werkstatt-godot plugin.
+
+        ## Prerequisites
+
+        - Node.js 24+
+        - pnpm 10+
+        - .NET SDK 8+
+        - Godot 4.x (with .NET support)
+
+        ## Setup
+
+        ### 1. Configure npm token
+
+        This workshop depends on private @warpgogol packages. Edit `.npmrc` and replace `YOUR_NPM_TOKEN` with a valid npm read token:
+
+        ```sh
+        sed -i 's/YOUR_NPM_TOKEN/your_actual_token/' .npmrc
+        ```
+
+        ### 2. Install dependencies
+
+        ```sh
+        pnpm install
+        ```
+
+        ### 3. Verify the workshop
+
+        ```sh
+        pnpm exec werkstatt run forge.doctor
+        pnpm exec werkstatt run werkstatt.plugin.validate
+        pnpm exec werkstatt run werkstatt.autonomy.validate
+        ```
+
+        ## Running the game
+
+        ```sh
+        godot --path games/my-game
+        ```
+
+        You should see "Hello, my-game!" in the game window.
+
+        ## Stack
+
+        - Engine: @warpgogol/werkstatt
+        - Plugin: @warpgogol/werkstatt-godot
+        - Stack profile: godot-csharp
 install:
-  - pnpm add -D typescript turbo @warpgogol/forge @warpgogol/werkstatt @warpgogol/werkstatt-godot prettier
+  - pnpm install
 firstWorkspace:
   path: games/my-game
   files:
@@ -347,7 +507,10 @@ firstWorkspace:
         project/assembly_name="my-game"
     - path: Game.csproj
       content: |
-        <Project Sdk="Godot.NET.Sdk">
+        <Project Sdk="Godot.NET.Sdk" />
+    - path: Directory.Build.props
+      content: |
+        <Project>
           <PropertyGroup>
             <TargetFramework>net8.0</TargetFramework>
             <TargetFramework Condition="'$(OS)' == 'Windows_NT'">net8.0-windows</TargetFramework>
@@ -356,15 +519,101 @@ firstWorkspace:
             <Nullable>enable</Nullable>
           </PropertyGroup>
         </Project>
+    - path: global.json
+      content: |
+        {
+          "sdk": {
+            "version": "8.0.100",
+            "rollForward": "latestFeature"
+          }
+        }
+    - path: Game.sln
+      content: |
+        Microsoft Visual Studio Solution File, Format Version 12.00
+        # Visual Studio Version 17
+        Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "my-game", "Game.csproj", "{AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA}"
+        EndProject
+        Global
+        	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+        		Debug|Any CPU = Debug|Any CPU
+        		Release|Any CPU = Release|Any CPU
+        	EndGlobalSection
+        	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+        		{AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+        		{AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA}.Debug|Any CPU.Build.0 = Debug|Any CPU
+        		{AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA}.Release|Any CPU.ActiveCfg = Release|Any CPU
+        		{AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA}.Release|Any CPU.Build.0 = Release|Any CPU
+        	EndGlobalSection
+        EndGlobal
+    - path: export_presets.cfg
+      content: |
+        [preset.0]
+
+        name="Web"
+        platform="Web"
+        runnable=true
+        dedicated_server=false
+        custom_features=""
+        export_filter="all_resources"
+        include_filter=""
+        exclude_filter=""
+        export_path="bin/web/index.html"
+        encryption_include_filters=""
+        encryption_exclude_filters=""
+        encrypt_export=false
+
+        [preset.0.options]
+
+        html/export_icon=true
+        html/custom_html_shell=""
+        html/head_include=""
+    - path: omnisharp.json
+      content: |
+        {
+          "FormattingOptions": {
+            "UseTabs": true,
+            "TabSize": 4,
+            "IndentationSize": 4,
+            "NewLine": "\n"
+          },
+          "RoslynExtensionsOptions": {
+            "EnableAnalyzersSupport": true
+          }
+        }
+    - path: .vscode/settings.json
+      content: |
+        {
+          "files.associations": {
+            "*.tscn": "gdscript",
+            "*.tres": "gdscript",
+            "*.gd": "gdscript"
+          },
+          "search.exclude": {
+            "**/.godot": true,
+            "**/bin": true,
+            "**/obj": true
+          },
+          "files.watcherExclude": {
+            "**/.godot/**": true,
+            "**/bin/**": true,
+            "**/obj/**": true
+          }
+        }
     - path: Scenes/Main.tscn
       content: |
-        [gd_scene load_steps=1 format=3 uid="uid://main_scene"]
+        [gd_scene load_steps=2 format=3 uid="uid://main_scene"]
 
-        [ext_resource type="Script" path="res://Scripts/Main.cs" id="1"]
         [ext_resource type="Script" path="res://Scripts/Main.cs" id="1_script"]
 
         [node name="Main" type="Node2D"]
         script = ExtResource("1_script")
+
+        [node name="HelloLabel" type="Label" parent="."]
+        offset_left = 200.0
+        offset_top = 200.0
+        offset_right = 600.0
+        offset_bottom = 300.0
+        text = "Hello, my-game!"
     - path: Scripts/Main.cs
       content: |
         using Godot;
@@ -383,6 +632,31 @@ firstWorkspace:
         obj/
         *.user
         *.csproj.user
+    - path: icon.svg
+      content: |
+        <svg width="128" height="128" viewBox="0 0 128 128" xmlns="http://www.w3.org/2000/svg">
+          <rect width="128" height="128" rx="16" fill="#478cbf"/>
+          <text x="64" y="80" font-family="Arial, sans-serif" font-size="48" font-weight="bold" fill="white" text-anchor="middle">G</text>
+        </svg>
+    - path: .editorconfig
+      content: |
+        root = true
+
+        [*]
+        charset = utf-8
+        end_of_line = lf
+        insert_final_newline = true
+        trim_trailing_whitespace = true
+
+        [*.{cs,csproj}]
+        indent_style = tab
+        indent_size = 4
+
+        [*.{tscn,tres,godot,cfg}]
+        indent_style = tab
+        indent_size = 4
+
+        [*.{md,txt}]
+        trim_trailing_whitespace = false
   install:
-    - dotnet new sln --name my-game
-    - dotnet sln add Game.csproj
+    - dotnet restore

package/profiles/phaser-turborepo.yaml

@@ -11,6 +11,9 @@ workspace:
     - packages
     - services
     - scripts
+    - tools
+    - missions
+    - systems-cache
   files:
     - path: pnpm-workspace.yaml
       content: |
@@ -201,6 +204,137 @@ workspace:
         }
 
         console.log(`Cleaned ${toDelete.length} directories.`);
+    - path: tools/kernel.config.ts
+      content: |
+        import { defineKernelConfig } from "@warpgogol/werkstatt/kernel/types";
+        import { werkstattGamePlugin } from "@warpgogol/werkstatt-game";
+
+        export default defineKernelConfig({
+          name: "__PROJECT_NAME__",
+          description: "__PROJECT_NAME__ workshop",
+          moduleLoaders: {
+            "forge-core": async () => (await import("@warpgogol/forge/os/core")).forgeCoreModule,
+            "forge-rfc": async () => (await import("@warpgogol/forge/os/rfc-module")).forgeRfcModule,
+            "forge-adr": async () => (await import("@warpgogol/forge/os/adr-module")).forgeAdrModule,
+            "forge-plan": async () => (await import("@warpgogol/forge/os/plan-module")).forgePlanModule,
+            "forge-audit": async () => (await import("@warpgogol/forge/os/audit-module")).forgeAuditModule,
+            "forge-compass": async () => (await import("@warpgogol/forge/os/compass")).forgeCompassModule,
+            "forge-naming": async () => (await import("@warpgogol/forge/os/naming-module")).forgeNamingModule,
+            "forge-workflow": async () => (await import("@warpgogol/forge/os/workflow-module")).forgeWorkflowModule,
+            "forge-session": async () => (await import("@warpgogol/forge/os/session-module")).forgeSessionModule,
+            "forge-mission": async () => (await import("@warpgogol/forge/os/mission-module")).forgeMissionModule,
+            "forge-spec": async () => (await import("@warpgogol/forge/os/spec-module")).forgeSpecModule,
+            "forge-exploration": async () => (await import("@warpgogol/forge/os/exploration")).forgeExplorationModule,
+            "forge-program": async () => (await import("@warpgogol/forge/os/program")).forgeProgramModule,
+            "forge-werkstatt": async () => (await import("@warpgogol/forge/os/werkstatt")).forgeWerkstattModule,
+            mission: async () => (await import("@warpgogol/werkstatt/mission-module")).createMissionModule(),
+            sternsystem: async () => (await import("@warpgogol/werkstatt/sternsystem-module")).createSternsystemModule(),
+            bordbuch: async () => (await import("@warpgogol/werkstatt/bordbuch-module")).createBordbuchModule(),
+            "artifact-store": async () => (await import("@warpgogol/werkstatt/artifact-store-module")).createArtifactStoreModule(),
+            release: async () => (await import("@warpgogol/werkstatt/release-module")).createReleaseModule(),
+            leitstand: async () => (await import("@warpgogol/werkstatt/leitstand-module")).createLeitstandModule(),
+            notausgang: async () => (await import("@warpgogol/werkstatt/notausgang-module")).createNotausgangModule(),
+            evidence: async () => (await import("@warpgogol/werkstatt/evidence-module")).createEvidenceModule(),
+            "werkstatt-plugin": async () => (await import("@warpgogol/werkstatt/os/werkstatt-plugin-module")).forgeWerkstattPluginModule,
+            "werkstatt-autonomy": async () => (await import("@warpgogol/werkstatt/os/werkstatt-autonomy-module")).werkstattAutonomyModule,
+            "__PROJECT_NAME__-plugin": async () => werkstattGamePlugin,
+          },
+        });
+    - path: .npmrc
+      content: |
+        # @warpgogol scoped registry — replace YOUR_NPM_TOKEN with a valid npm read token
+        @warpgogol:registry=https://registry.npmjs.org/
+        //registry.npmjs.org/:_authToken=YOUR_NPM_TOKEN
+    - path: eslint.config.js
+      content: |
+        export default [
+          {
+            rules: {},
+          },
+        ];
+    - path: .prettierrc.mjs
+      content: |
+        export default {
+          semi: true,
+          singleQuote: false,
+          trailingComma: "all",
+          printWidth: 100,
+          tabWidth: 2,
+        };
+    - path: .gitattributes
+      content: |
+        # No LFS patterns for this stack
+    - path: hooks/pre-commit
+      content: |
+        #!/bin/sh
+        # Platform-scope pre-commit guard
+        # Runs werkstatt autonomy and plugin validation before commits
+        echo "Pre-commit: running platform checks..."
+        pnpm exec werkstatt run werkstatt.autonomy.validate || exit 1
+        pnpm exec werkstatt run werkstatt.plugin.validate || exit 1
+    - path: systems-cache/.gitkeep
+      content: |
+        # Sternsystem cache directory (RFC-0790)
+        # Per-system config and state files live in systems-cache/<id>/
+    - path: missions/.gitkeep
+      content: ""
+    - path: .forge/pinned.yaml
+      content: |
+        # Pinned foundation files (DNA-62, RFC-0733)
+        # Protect mode: warns on delete/move. Freeze mode: blocks modify too.
+        entries:
+          - path: tools/kernel.config.ts
+            mode: protect
+          - path: forge.yaml
+            mode: protect
+          - path: pnpm-workspace.yaml
+            mode: protect
+          - path: turbo.json
+            mode: protect
+          - path: tsconfig.base.json
+            mode: protect
+          - path: systems-cache/.gitkeep
+            mode: protect
+    - path: README.md
+      content: |
+        # __PROJECT_NAME__
+
+        A Warpgogol workshop powered by the Werkstatt engine and the @warpgogol/werkstatt-game plugin.
+
+        ## Prerequisites
+
+        - Node.js 24+
+        - pnpm 10+
+
+        ## Setup
+
+        ### 1. Configure npm token
+
+        This workshop depends on private @warpgogol packages. Edit `.npmrc` and replace `YOUR_NPM_TOKEN` with a valid npm read token:
+
+        ```sh
+        sed -i 's/YOUR_NPM_TOKEN/your_actual_token/' .npmrc
+        ```
+
+        ### 2. Install dependencies
+
+        ```sh
+        pnpm install
+        ```
+
+        ### 3. Verify the workshop
+
+        ```sh
+        pnpm exec werkstatt run forge.doctor
+        pnpm exec werkstatt run werkstatt.plugin.validate
+        pnpm exec werkstatt run werkstatt.autonomy.validate
+        ```
+
+        ## Stack
+
+        - Engine: @warpgogol/werkstatt
+        - Plugin: @warpgogol/werkstatt-game
+        - Stack profile: phaser-turborepo
 install:
   - pnpm add -D typescript turbo @warpgogol/forge @warpgogol/werkstatt @warpgogol/werkstatt-shared @warpgogol/werkstatt-game prettier
 firstWorkspace:

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

@@ -164,6 +164,61 @@ When the operator says any session-end trigger phrase (e.g. "Завершаем
 
 The `fo-session-retro` skill IS the session-end protocol — it runs transcript save, temp cleanup, docs.archive, clean tree check, RFC verification, insight triage, and produces the closing block. Do not substitute it with a manual summary. The closing block comes from `fo-session-retro`, not from the agent directly.
 
+## Pre-pipeline checkpoint
+
+When a pipeline skill (`fo-idea-i-just-want-to-see-the-result`, `fo-idea-i-just-want-to-see-the-plan`, `fo-idea-implement`) is invoked after substantial pre-existing session context — discussion, code exploration, document creation, debugging — the agent performs a pre-pipeline checkpoint to release that context before the pipeline starts. The pipeline is self-sufficient: it reads the RFC/ADR, plan, AGENTS.md, and DNA invariants fresh. Pre-existing session context is no longer actionable once the pipeline begins.
+
+### When to emit
+
+Emit the pre-pipeline checkpoint when **both** conditions are met:
+
+1. **Pre-existing context exists** — the session has accumulated context from prior work (discussion, file reads, search results, document creation, debugging). If the skill is invoked at the start of a session with no prior context, skip the checkpoint — there is nothing to release.
+2. **The skill runs a pipeline** — `fo-idea-i-just-want-to-see-the-result` (full or `stopAfter: plan`), `fo-idea-i-just-want-to-see-the-plan`, or `fo-idea-implement`. Skills that perform a single action (e.g. `fo-idea-audit`, `fo-idea-enhance`) do not need this checkpoint.
+
+**Double-checkpoint guard:** If a pre-pipeline checkpoint was already emitted by a calling orchestrator (e.g. `fo-idea-i-just-want-to-see-the-result` emitted one, then invoked `fo-idea-implement`), the called skill MUST skip its own checkpoint — the context was already released. Scan conversation output for an existing `checkpoint: pre-pipeline` block before emitting a new one.
+
+**Wrapper skills:** `fo-idea-i-just-want-to-see-the-plan` delegates to `fo-idea-i-just-want-to-see-the-result` and does not emit its own checkpoint — the orchestrator handles it.
+
+### How to emit
+
+1. **Emit pre-pipeline checkpoint block** — output a YAML-formatted block in conversation output with the following fields:
+
+```yaml
+---
+checkpoint: pre-pipeline
+documents:
+  - id: RFC-XXXX
+    type: RFC
+    status: accepted
+operatorConstraints:
+  - "explicit constraints from the operator not captured in the document"
+aiLanguage: uk
+sessionSummary: >
+  1-3 sentences capturing key decisions, edge cases, and mental models
+  from the pre-pipeline discussion that are not in the document text.
+---
+```
+
+2. **Preserve critical fields** — the following must survive the context release:
+   - `documents` — id, type, and status of each document to process (needed by the pipeline's step 0 detection)
+   - `operatorConstraints` — explicit constraints or preferences the operator stated in conversation that are not written into the RFC/ADR (e.g. "don't touch packages/foo", "use approach Y"). Empty if none.
+   - `aiLanguage` — the operator's AI language preference (to avoid re-reading `PREFERENCES.md`)
+   - `sessionSummary` — 1-3 freeform sentences capturing key decisions, edge cases, and mental models from the discussion. This mitigates the session-affinity risk: the `fo-idea-implement` skill warns that "session context contains edge cases and mental models not fully captured in the plan text." The summary preserves the most important ones.
+
+3. **Release pre-existing context** — explicitly treat all detailed context from before the checkpoint as no longer actionable: discussion text, codebase search results, file reads, edit operations, intermediate reasoning, debug output. Retain only the checkpoint block and `PREFERENCES.md` settings.
+
+4. **Fresh start** — begin the pipeline with a fresh read phase: re-read the RFC/ADR file and all related documents (amends, supersedes, related RFCs, DNA invariants, AGENTS.md sections).
+
+### What NOT to release
+
+- **`PREFERENCES.md` settings** — `aiLanguage`, `documentationLanguage`, and other preferences remain active.
+- **The checkpoint block itself** — it is the resume marker and the only link to pre-pipeline context.
+- **Operator constraints** — if the operator said "don't touch X" or "use approach Y" in conversation, these must be respected throughout the pipeline.
+
+### Resume behavior
+
+When resuming an interrupted session, scan conversation output for the last pre-pipeline checkpoint block. If found, extract `documents`, `operatorConstraints`, `aiLanguage`, and `sessionSummary` to restore the pre-pipeline context without re-reading the full conversation history. Then proceed with the pipeline's own resume logic (detecting completed steps via git log, file inspection, frontmatter status).
+
 ## Context checkpoint between batch items
 
 When the orchestrator skill processes multiple documents (>=2), perform a context checkpoint after completing one document and before starting the next:

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

@@ -249,8 +249,8 @@ Skills that delegate to `fo-doc-audit`:
 
 - **`fo-fix`** step 5 ("Documentation audit") — invokes `fo-doc-audit`.
 - **`fo-fix`** merge conflict resolution step 4 ("Documentation audit") — invokes `fo-doc-audit`.
-- **`fo-idea-implement`** step 3.9 ("Documentation audit") — invokes `fo-doc-audit`.
-- **`fo-idea-implement`** ADR-FLOW step 4.6 ("Documentation audit") — invokes `fo-doc-audit`.
+- **`fo-idea-implement`** step 4.9 ("Documentation audit") — invokes `fo-doc-audit`.
+- **`fo-idea-implement`** ADR-FLOW step 5.6 ("Documentation audit") — invokes `fo-doc-audit`.
 
 ## Constraints
 

package/skills/fo/fo-idea-i-just-want-to-see-the-plan/SKILL.md

@@ -19,6 +19,8 @@ See `_shared/fo-pipeline-conventions.md` §Language policy.
 
 Thin wrapper around `fo-idea-i-just-want-to-see-the-result`. Invokes the orchestrator with `stopAfter: plan`, which runs steps 0–3 only (idea → audit → enhance → plan). Step 4 (implement, which includes review and fix) is not run.
 
+The orchestrator handles the pre-pipeline checkpoint per `_shared/fo-pipeline-conventions.md` §Pre-pipeline checkpoint — no separate checkpoint is needed in this wrapper.
+
 ## ADR documents
 
 ADRs skip audit, enhance, and plan. The orchestrator stops after step 0 (idea creation) with the message: "ADR does not require a plan. Run `/fo-idea-implement` to implement."

package/skills/fo/fo-idea-i-just-want-to-see-the-result/SKILL.md

@@ -50,7 +50,11 @@ Determine whether the operator provided a raw idea or a document id:
 
 Record the document id(s) and type(s) (RFC or ADR). If multiple documents were created in a series, process them in dependency order — the same order `fo-idea` created them.
 
-### 1. Run the pipeline
+### 1. Pre-pipeline checkpoint
+
+Before starting the pipeline, perform a pre-pipeline checkpoint per `_shared/fo-pipeline-conventions.md` §Pre-pipeline checkpoint. If pre-existing session context exists (discussion, document creation, debugging), emit the checkpoint block, release pre-existing context, and start the pipeline with a fresh read phase. If the session has no prior context, skip the checkpoint.
+
+### 2. Run the pipeline
 
 For each document, run the full pipeline inline. The pipeline differs for RFCs and ADRs.
 
@@ -120,7 +124,7 @@ Do not invoke `fo-review` or `fo-fix` separately — they are built into `fo-ide
 
 This fallback ensures review and fix are never skipped, even if `fo-idea-implement` failed to execute them internally.
 
-### 2. Report and stop
+### 3. Report and stop
 
 After the pipeline is complete (or if it was interrupted and resumed), present a single summary in `aiLanguage`. **Translate all labels and headings to `aiLanguage`** — the template below is structural only. Only identifiers (RFC-XXXX, ADR-XXXX, file paths) stay untranslated.
 
@@ -142,7 +146,7 @@ If multiple documents were processed, present one summary block per document.
 
 **Stop.** Do not invoke `/grilling` or any other skill after the pipeline is complete. The operator asked to "just see the result" — the result is the summary above.
 
-### 3. Resume if interrupted
+### 4. Resume if interrupted
 
 If the session was interrupted (agent stopped, context limit, crash, checkpoint summary) and the operator re-invokes this skill or continues the session: