@pieai/pro-gov 0.3.17 → 0.4.0

package/README.md

@@ -154,8 +154,13 @@ work, run `pro-gov learn recall --query "<task summary>"` and read relevant
 `docs/solutions/**` or `CONCEPTS.md` hits before changing files.
 
 Engineering-runtime starters include cross-host Stop hooks for Codex,
-Claude Code, and Antigravity. Those hooks call `pro-gov host-hook` and require
-the final report to include either:
+Claude Code, and Antigravity. Those hooks call `pro-gov host-hook`. The starter
+default is `--compound-gate-mode off`: wiring is present, but the hook does not
+interrupt the main session. Use `--compound-gate-mode lite` for a short
+exit-door reminder, or `--compound-gate-mode strict` for the older blocking
+gate.
+
+When enabled, the hook expects the final report to include either:
 
 ```text
 Compound Gate: ran ce-compound -> <path>

package/assets/docs/reference/adoption/adoption-playbook.md

@@ -225,9 +225,11 @@ so prior lessons can shape the work without making Compound Engineering the
 default execution workflow.
 
 The host-hook gate is deliberately small. It does not make Compound Engineering
-the main workflow. It only blocks a final completion report that looks like
-finished engineering work but does not say whether the Compound Gate ran or was
-skipped:
+the main workflow. Starter hooks default to `--compound-gate-mode off`, so they
+prove the wiring without interrupting the main session. Switch a target to
+`--compound-gate-mode lite` for a short reminder, or `--compound-gate-mode
+strict` when a project intentionally wants the old blocking exit gate. In
+`lite` or `strict`, the hook checks whether a completion report says one of:
 
 ```text
 Compound Gate: ran ce-compound -> <path>
@@ -310,8 +312,9 @@ engineering runtime profile.
 
 `pro-gov doctor --strict-hooks` is a wiring check, not a live host simulation.
 It proves the project has hook files that call `pro-gov host-hook`; PGS package
-tests prove the expected Stop/SubagentStop behavior for the supported host
-schemas. After installing or changing hooks, validate from a fresh AI session.
+tests prove the expected Stop/SubagentStop behavior for `off`, `lite`, and
+`strict` modes across the supported host schemas. After installing or changing
+hooks, validate from a fresh AI session.
 For Antigravity, a real invocation writes diagnostics under
 `.git/pro-gov-hook-debug/` because the starter hook command sets
 `PGS_HOST_HOOK_DEBUG=1`. Absence of a diagnostic file after a fresh

package/assets/integrations/directed-development.md

@@ -4,6 +4,11 @@ Directed Development is an optional workflow for mixed, cross-domain, interdepen
 
 It is not the default for every task.
 
+It is not a Superpowers startup adapter and not a second engineering plugin. It
+is a small PGS routing rule for cases where product work must be split into
+ordered dependency-aware Blocks before the selected lane uses its normal
+workflow. Superpowers still owns the engineering process inside that lane.
+
 ## Boundary
 
 Directed Development may define:
@@ -16,6 +21,7 @@ Directed Development may define:
 Directed Development must not define:
 
 - artifact locations
+- Superpowers skill invocation rules
 - project document paths
 - project lane names
 - runtime truth
@@ -25,6 +31,10 @@ Those remain owned by the project and doc-gov.
 Agents routing decides whether this workflow applies. Directed Development does
 not replace the project router.
 
+BDD-style scenarios are allowed only as acceptance language for a DD Block. They
+do not turn Directed Development into a default BDD ceremony and do not replace
+Superpowers TDD, debugging, or verification workflows.
+
 ## Trigger
 
 Use Directed Development only when all are true:

package/assets/integrations/mattpocock-skills.md

@@ -0,0 +1,143 @@
+# mattpocock/skills Integration
+
+mattpocock/skills is an external npx skill pack. This repository may install
+the pack unchanged, but it does not vendor, rewrite, or fork the skill bodies.
+
+## The Beginner Version
+
+Think of the project as a workshop:
+
+- PGS is the traffic desk and filing cabinet.
+- Superpowers is the default construction process for engineering work.
+- mattpocock/skills is a set of sharp workshop tools for grilling ideas,
+  modeling domain language, turning decisions into PRDs/issues, and running
+  specific implementation flows.
+- Compound Engineering is the verified-learning notebook written after the work.
+
+Installing a box of tools does not mean every tool runs by itself. PGS decides
+the lane first. Superpowers remains the default engineering workflow. Matt
+skills may add useful artifacts and focused flows when their trigger fits.
+
+## Default Rule
+
+For PGS-governed engineering/runtime projects, mattpocock/skills is optional
+capability inside the selected lane. It is not the default workflow owner.
+
+Use this order:
+
+1. PGS routes the task and selects the project lane.
+2. For non-trivial engineering work, run Learning Recall.
+3. Superpowers owns the normal engineering workflow when that lane needs one.
+4. Matt skills may run when the user explicitly invokes a Matt flow or when an
+   active Matt flow calls one of its helper skills.
+5. The Compound Gate still runs before final reporting.
+
+Do not make routine work choose between Superpowers and Matt. The useful split
+is simpler:
+
+- Superpowers owns default engineering discipline.
+- Matt owns demand shaping, domain modeling, PRD/issues generation, triage, and
+  explicitly requested Matt implementation flows.
+- CE owns post-work reusable learning.
+
+## Trigger Boundary
+
+User-invoked Matt skills, such as `/grill-with-docs`, `/to-prd`,
+`/to-issues`, `/implement`, `/triage`, and `/ask-matt`, require an explicit
+user request or an already active Matt flow that named them.
+
+Model-invoked Matt helper skills, such as `domain-modeling`, `tdd`,
+`code-review`, `research`, and `prototype`, may run only when they support the
+current selected lane and do not replace the current workflow owner.
+
+If a Matt helper and a Superpowers skill both fit, keep the current workflow
+owner unless the user explicitly switches. For example:
+
+- normal feature implementation -> Superpowers remains the default;
+- user says `/implement issue 123` -> Matt `/implement` owns that flow;
+- user says "grill this idea and make docs" -> Matt `/grill-with-docs` owns
+  that shaping flow;
+- user says "use CE full workflow" -> CE owns the explicitly requested flow.
+
+## PGS Central Setup
+
+The PGS central repository uses these Matt setup choices:
+
+| Setup item | PGS central value |
+| --- | --- |
+| Issue tracker | GitHub Issues for `PieAIStudio/ProjectGovernanceSystem` |
+| External PRs as request surface | No by default |
+| Triage labels | Default Matt labels: `needs-triage`, `needs-info`, `ready-for-agent`, `ready-for-human`, `wontfix` |
+| Domain docs layout | Single-context: root `CONTEXT.md` and `docs/adr/**` when Matt creates them |
+
+The setup files live under `docs/agents/**`. They are Matt-owned external
+configuration files, not PGS canonical product truth.
+
+## Matt-Owned Artifacts
+
+The following outputs are Matt-owned external artifacts:
+
+| Path or surface | Owner | Rule |
+| --- | --- | --- |
+| `CONTEXT.md` | Matt | Domain glossary/context. Helpful input, not a replacement for `docs/canon/**`. |
+| `CONTEXT-MAP.md` | Matt | Multi-context map when a project opts into that layout. |
+| `docs/agents/**` | Matt | Per-repo Matt setup: issue tracker, triage labels, domain docs. |
+| `docs/adr/**` | Matt | Matt-generated ADRs. Promote manually to `docs/decisions/**` if they become PGS-governed decisions. |
+| `.scratch/**` | Matt | Local issue tracker or temporary work surface. Keep project-specific. |
+| GitHub/GitLab issues | Matt/project | PRDs, issue breakdowns, triage state. They are work-tracking artifacts, not doc-gov records by themselves. |
+
+Doc Gov must ignore `docs/agents/**` and `docs/adr/**` as external artifacts.
+When a Matt artifact becomes durable PGS truth, promote it into the normal
+governed layer:
+
+- decisions -> `docs/decisions/**`
+- specs -> `docs/specs/**`
+- plans -> `docs/plans/**`
+- canon -> `docs/canon/**`
+- references -> `docs/reference/**`
+
+Do not try to make one file satisfy both Matt's native artifact contract and a
+PGS governed document contract.
+
+## Downstream Install Rule
+
+Install or update Matt skills in downstream repositories through the PGS asset
+workflow. Do not run `npx skills add mattpocock/skills` inside every downstream
+project as an unmanaged one-off.
+
+The central intake flow is:
+
+```bash
+pro-gov assets npx add mattpocock/skills --plan --root agent-assets/skills/npx-skills
+```
+
+Review the plan, then install into the PGS central npx skill root. Downstream
+projects receive managed symlinks through the private PGS asset bundle
+`mattpocock-skills` and project-local Matt setup files according to their
+selected profile and host support.
+
+## Verification
+
+Central verification:
+
+```bash
+node packages/doc-gov/dist/cli.js router-check
+node packages/doc-gov/dist/cli.js check
+node packages/doc-gov/dist/cli.js scan --check
+git diff --check
+```
+
+Matt install verification:
+
+```bash
+test -f agent-assets/skills/npx-skills/skills-lock.json
+find agent-assets/skills/npx-skills/.agents/skills -maxdepth 2 -name SKILL.md
+```
+
+Downstream verification must prove:
+
+- the target's project router points to its selected profile;
+- Matt skills are linked from the managed PGS asset source;
+- `docs/agents/**` exists when Matt engineering skills are enabled;
+- Doc Gov ignores Matt-owned external artifacts;
+- Superpowers, Matt, and CE each keep their documented ownership.

package/assets/integrations/superpowers.md

@@ -29,6 +29,13 @@ Superpowers owns engineering workflows such as:
 - verification before completion
 - worktree usage
 
+Superpowers 6.x for Codex is skill-routed, not hook-driven. The plugin manifest
+does not need a SessionStart hook for PGS to make use of it. The startup
+behavior comes from the `using-superpowers` skill description, which tells the
+host to check relevant skills at the start of a conversation and before acting.
+Do not add a PGS hook just to force Superpowers startup unless a future
+Superpowers release explicitly requires one.
+
 Project Governance System owns:
 
 - documentation lifecycle

package/assets/profiles/engineering-runtime/manifest.yml

@@ -11,6 +11,7 @@ required:
 optional:
   compound_engineering: integrations/compound-engineering.md
   directed_development: integrations/directed-development.md
+  mattpocock_skills: integrations/mattpocock-skills.md
   superpowers: integrations/superpowers.md
 project_local_required:
   - docs/policy/best-practice-for-this-project.md

package/assets/profiles/engineering-runtime/profile.md

@@ -12,6 +12,7 @@ Use for code-heavy projects: apps, games, runtimes, services, browser products,
 - `integrations/superpowers.md`
 - `integrations/compound-engineering.md`
 - `integrations/directed-development.md`
+- `integrations/mattpocock-skills.md`
 - starter `docs/governance/` and `docs/policy/` templates
 
 ## Requires Project-Local Rules
@@ -31,6 +32,7 @@ Each project must define:
 - game/app-specific lane wording
 - Superpowers plugin body
 - Compound Engineering plugin body
+- mattpocock/skills body
 
 ## Automation Boundary
 
@@ -42,9 +44,10 @@ content under the target project's ownership.
 
 Engineering-runtime starters also include Codex, Claude Code, and Antigravity
 Stop hooks that call `pro-gov host-hook`. Use `pro-gov doctor --strict-hooks`
-after sync to confirm the exit gate is wired. The hook enforces the Compound
-Gate final-report marker; it does not replace verification, tests, or
-`ce-compound` itself.
+after sync to confirm the host configs are wired. The starter default is
+`--compound-gate-mode off`, so the hook does not interrupt the main session
+unless the project explicitly switches to `lite` or `strict`. Even when enabled,
+the hook does not replace verification, tests, or `ce-compound` itself.
 
 For non-trivial engineering work, run `pro-gov learn recall --query "<task
 summary>"` before changing files so existing `docs/solutions/**` and

package/assets/starter/.agents/hooks.json

@@ -5,7 +5,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "cd \"$(git rev-parse --show-toplevel)\" && if [ -x ./node_modules/.bin/pro-gov ]; then PGS_HOST_HOOK_DEBUG=1 ./node_modules/.bin/pro-gov host-hook --host antigravity --event Stop; elif [ -f packages/pro-gov/src/cli.ts ] && { command -v corepack >/dev/null 2>&1 || command -v pnpm >/dev/null 2>&1; }; then pgs_pnpm() { if command -v corepack >/dev/null 2>&1; then corepack pnpm \"$@\"; else pnpm \"$@\"; fi; }; PGS_HOST_HOOK_DEBUG=1 pgs_pnpm --silent --filter @pieai/pro-gov dev host-hook --host antigravity --event Stop; else PGS_HOST_HOOK_DEBUG=1 npx --no-install @pieai/pro-gov host-hook --host antigravity --event Stop; fi",
+            "command": "cd \"$(git rev-parse --show-toplevel)\" && if [ -x ./node_modules/.bin/pro-gov ]; then PGS_HOST_HOOK_DEBUG=1 ./node_modules/.bin/pro-gov host-hook --host antigravity --event Stop --compound-gate-mode off; elif [ -f packages/pro-gov/src/cli.ts ] && { command -v corepack >/dev/null 2>&1 || command -v pnpm >/dev/null 2>&1; }; then pgs_pnpm() { if command -v corepack >/dev/null 2>&1; then corepack pnpm \"$@\"; else pnpm \"$@\"; fi; }; PGS_HOST_HOOK_DEBUG=1 pgs_pnpm --silent --filter @pieai/pro-gov dev host-hook --host antigravity --event Stop --compound-gate-mode off; else PGS_HOST_HOOK_DEBUG=1 npx --no-install @pieai/pro-gov host-hook --host antigravity --event Stop --compound-gate-mode off; fi",
             "timeout": 30
           }
         ]
@@ -16,7 +16,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "cd \"$(git rev-parse --show-toplevel)\" && if [ -x ./node_modules/.bin/pro-gov ]; then PGS_HOST_HOOK_DEBUG=1 ./node_modules/.bin/pro-gov host-hook --host antigravity --event SubagentStop; elif [ -f packages/pro-gov/src/cli.ts ] && { command -v corepack >/dev/null 2>&1 || command -v pnpm >/dev/null 2>&1; }; then pgs_pnpm() { if command -v corepack >/dev/null 2>&1; then corepack pnpm \"$@\"; else pnpm \"$@\"; fi; }; PGS_HOST_HOOK_DEBUG=1 pgs_pnpm --silent --filter @pieai/pro-gov dev host-hook --host antigravity --event SubagentStop; else PGS_HOST_HOOK_DEBUG=1 npx --no-install @pieai/pro-gov host-hook --host antigravity --event SubagentStop; fi",
+            "command": "cd \"$(git rev-parse --show-toplevel)\" && if [ -x ./node_modules/.bin/pro-gov ]; then PGS_HOST_HOOK_DEBUG=1 ./node_modules/.bin/pro-gov host-hook --host antigravity --event SubagentStop --compound-gate-mode off; elif [ -f packages/pro-gov/src/cli.ts ] && { command -v corepack >/dev/null 2>&1 || command -v pnpm >/dev/null 2>&1; }; then pgs_pnpm() { if command -v corepack >/dev/null 2>&1; then corepack pnpm \"$@\"; else pnpm \"$@\"; fi; }; PGS_HOST_HOOK_DEBUG=1 pgs_pnpm --silent --filter @pieai/pro-gov dev host-hook --host antigravity --event SubagentStop --compound-gate-mode off; else PGS_HOST_HOOK_DEBUG=1 npx --no-install @pieai/pro-gov host-hook --host antigravity --event SubagentStop --compound-gate-mode off; fi",
             "timeout": 30
           }
         ]

package/assets/starter/.claude/settings.json

@@ -5,7 +5,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "cd \"${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel)}\" && if [ -x ./node_modules/.bin/pro-gov ]; then ./node_modules/.bin/pro-gov host-hook --host claude-code --event Stop; elif [ -f packages/pro-gov/src/cli.ts ] && { command -v corepack >/dev/null 2>&1 || command -v pnpm >/dev/null 2>&1; }; then pgs_pnpm() { if command -v corepack >/dev/null 2>&1; then corepack pnpm \"$@\"; else pnpm \"$@\"; fi; }; pgs_pnpm --silent --filter @pieai/pro-gov dev host-hook --host claude-code --event Stop; else npx --no-install @pieai/pro-gov host-hook --host claude-code --event Stop; fi",
+            "command": "cd \"${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel)}\" && if [ -x ./node_modules/.bin/pro-gov ]; then ./node_modules/.bin/pro-gov host-hook --host claude-code --event Stop --compound-gate-mode off; elif [ -f packages/pro-gov/src/cli.ts ] && { command -v corepack >/dev/null 2>&1 || command -v pnpm >/dev/null 2>&1; }; then pgs_pnpm() { if command -v corepack >/dev/null 2>&1; then corepack pnpm \"$@\"; else pnpm \"$@\"; fi; }; pgs_pnpm --silent --filter @pieai/pro-gov dev host-hook --host claude-code --event Stop --compound-gate-mode off; else npx --no-install @pieai/pro-gov host-hook --host claude-code --event Stop --compound-gate-mode off; fi",
             "timeout": 30
           }
         ]
@@ -16,7 +16,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "cd \"${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel)}\" && if [ -x ./node_modules/.bin/pro-gov ]; then ./node_modules/.bin/pro-gov host-hook --host claude-code --event SubagentStop; elif [ -f packages/pro-gov/src/cli.ts ] && { command -v corepack >/dev/null 2>&1 || command -v pnpm >/dev/null 2>&1; }; then pgs_pnpm() { if command -v corepack >/dev/null 2>&1; then corepack pnpm \"$@\"; else pnpm \"$@\"; fi; }; pgs_pnpm --silent --filter @pieai/pro-gov dev host-hook --host claude-code --event SubagentStop; else npx --no-install @pieai/pro-gov host-hook --host claude-code --event SubagentStop; fi",
+            "command": "cd \"${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel)}\" && if [ -x ./node_modules/.bin/pro-gov ]; then ./node_modules/.bin/pro-gov host-hook --host claude-code --event SubagentStop --compound-gate-mode off; elif [ -f packages/pro-gov/src/cli.ts ] && { command -v corepack >/dev/null 2>&1 || command -v pnpm >/dev/null 2>&1; }; then pgs_pnpm() { if command -v corepack >/dev/null 2>&1; then corepack pnpm \"$@\"; else pnpm \"$@\"; fi; }; pgs_pnpm --silent --filter @pieai/pro-gov dev host-hook --host claude-code --event SubagentStop --compound-gate-mode off; else npx --no-install @pieai/pro-gov host-hook --host claude-code --event SubagentStop --compound-gate-mode off; fi",
             "timeout": 30
           }
         ]

package/assets/starter/.codex/hooks.json

@@ -5,7 +5,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "cd \"$(git rev-parse --show-toplevel)\" && if [ -x ./node_modules/.bin/pro-gov ]; then ./node_modules/.bin/pro-gov host-hook --host codex --event Stop; elif [ -f packages/pro-gov/src/cli.ts ] && { command -v corepack >/dev/null 2>&1 || command -v pnpm >/dev/null 2>&1; }; then pgs_pnpm() { if command -v corepack >/dev/null 2>&1; then corepack pnpm \"$@\"; else pnpm \"$@\"; fi; }; pgs_pnpm --silent --filter @pieai/pro-gov dev host-hook --host codex --event Stop; else npx --no-install @pieai/pro-gov host-hook --host codex --event Stop; fi",
+            "command": "cd \"$(git rev-parse --show-toplevel)\" && if [ -x ./node_modules/.bin/pro-gov ]; then ./node_modules/.bin/pro-gov host-hook --host codex --event Stop --compound-gate-mode off; elif [ -f packages/pro-gov/src/cli.ts ] && { command -v corepack >/dev/null 2>&1 || command -v pnpm >/dev/null 2>&1; }; then pgs_pnpm() { if command -v corepack >/dev/null 2>&1; then corepack pnpm \"$@\"; else pnpm \"$@\"; fi; }; pgs_pnpm --silent --filter @pieai/pro-gov dev host-hook --host codex --event Stop --compound-gate-mode off; else npx --no-install @pieai/pro-gov host-hook --host codex --event Stop --compound-gate-mode off; fi",
             "timeout": 30,
             "statusMessage": "Checking PGS Compound Gate"
           }
@@ -17,7 +17,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "cd \"$(git rev-parse --show-toplevel)\" && if [ -x ./node_modules/.bin/pro-gov ]; then ./node_modules/.bin/pro-gov host-hook --host codex --event SubagentStop; elif [ -f packages/pro-gov/src/cli.ts ] && { command -v corepack >/dev/null 2>&1 || command -v pnpm >/dev/null 2>&1; }; then pgs_pnpm() { if command -v corepack >/dev/null 2>&1; then corepack pnpm \"$@\"; else pnpm \"$@\"; fi; }; pgs_pnpm --silent --filter @pieai/pro-gov dev host-hook --host codex --event SubagentStop; else npx --no-install @pieai/pro-gov host-hook --host codex --event SubagentStop; fi",
+            "command": "cd \"$(git rev-parse --show-toplevel)\" && if [ -x ./node_modules/.bin/pro-gov ]; then ./node_modules/.bin/pro-gov host-hook --host codex --event SubagentStop --compound-gate-mode off; elif [ -f packages/pro-gov/src/cli.ts ] && { command -v corepack >/dev/null 2>&1 || command -v pnpm >/dev/null 2>&1; }; then pgs_pnpm() { if command -v corepack >/dev/null 2>&1; then corepack pnpm \"$@\"; else pnpm \"$@\"; fi; }; pgs_pnpm --silent --filter @pieai/pro-gov dev host-hook --host codex --event SubagentStop --compound-gate-mode off; else npx --no-install @pieai/pro-gov host-hook --host codex --event SubagentStop --compound-gate-mode off; fi",
             "timeout": 30,
             "statusMessage": "Checking PGS subagent Compound Gate"
           }

package/assets/starter/AGENTS.template.md

@@ -43,7 +43,7 @@
 - Engineering projects may use Superpowers, Directed Development, GStack, or other external workflows only inside the selected lane; do not copy upstream integration guides into the target project by default.
 - For engineering projects, Superpowers is the default engineering workflow. Compound Engineering is used by default only as the post-work Compound Gate through `ce-compound`; full CE workflows require an explicit user request.
 - For engineering projects, PGS Learning Recall is the pre-work companion to that post-work gate: recall existing lessons first, then do the work, then decide whether a new lesson should be compounded.
-- Engineering projects should have PGS Stop hooks wired for Codex, Claude Code, and Antigravity. Before final reporting after completed engineering work, report `Compound Gate: ran ce-compound -> <path>`, `Compound Gate: ran fallback capture -> <path>`, or `Compound Gate: skipped -> <reason>`.
+- Engineering projects should have PGS Stop hooks wired for Codex, Claude Code, and Antigravity. Starter hooks default to `--compound-gate-mode off`; opt into `lite` or `strict` only when this project wants runtime exit-gate reminders. Before final reporting after completed engineering work, report `Compound Gate: ran ce-compound -> <path>`, `Compound Gate: ran fallback capture -> <path>`, or `Compound Gate: skipped -> <reason>`.
 - Use fallback capture only when the current host cannot load Compound Engineering; run `pro-gov learn capture --title "<learning title>" --summary "<reusable lesson>"` so Learning Recall can find the lesson later.
 - Doc-only projects should say that Superpowers TDD and Directed Development are not enabled by default.
 - External workflow systems such as Superpowers or GStack run inside the lane selected by this router. They must not replace this project router.

package/cli-guide.md

@@ -26,6 +26,7 @@ pro-gov lens inspect --target .
 pro-gov lens report --target . --out .pro-gov/lens-report.md
 pro-gov lens audit init --target /path/to/project --out audits/project/2026-07-01
 pro-gov lens audit check --dir audits/project/2026-07-01
+pro-gov host-hook --host codex --event Stop --compound-gate-mode off|lite|strict
 pro-gov init --profile engineering-runtime --dry-run
 pro-gov init --profile engineering-runtime --apply
 pro-gov init --profile doc-only --dry-run
@@ -69,6 +70,12 @@ Then report:
 Compound Gate: ran fallback capture -> docs/solutions/<category>/<file>.md
 ```
 
+`host-hook` is the cross-host Compound Gate adapter for Codex, Claude Code, and
+Antigravity. `--compound-gate-mode off` is the default and does not interrupt
+the main session. `lite` emits a short continuation prompt when completed
+engineering work lacks a Compound Gate marker. `strict` emits the fuller legacy
+prompt. The same value can be supplied through `PGS_COMPOUND_GATE_MODE`.
+
 Full upstream-checkout commands:
 
 ```bash

package/dist/cli.js

@@ -1763,8 +1763,19 @@ var compoundGateInstruction = [
   "If there is no reusable learning, report:",
   "Compound Gate: skipped -> <reason>"
 ].join("\n");
+var liteCompoundGateInstruction = [
+  "Pass the PGS Compound Gate before final reporting.",
+  "Report one line:",
+  "Compound Gate: ran ce-compound -> <path>",
+  "Compound Gate: ran fallback capture -> <path>",
+  "Compound Gate: skipped -> <reason>"
+].join("\n");
 var maxTranscriptBytes = 2 * 1024 * 1024;
 function evaluateHostHook(request) {
+  const mode = request.compoundGateMode ?? "off";
+  if (mode === "off") {
+    return { action: "allow" };
+  }
   if (request.event !== "Stop" && request.event !== "SubagentStop") {
     return { action: "allow" };
   }
@@ -1781,7 +1792,10 @@ function evaluateHostHook(request) {
   if (!looksLikeCompletedEngineeringWork(input.lastAssistantMessage)) {
     return { action: "allow" };
   }
-  return { action: "continue", reason: compoundGateInstruction };
+  return { action: "continue", reason: compoundGateInstructionForMode(mode) };
+}
+function compoundGateInstructionForMode(mode) {
+  return mode === "lite" ? liteCompoundGateInstruction : compoundGateInstruction;
 }
 function formatHostHookOutput(host, event, decision) {
   if (decision.action === "allow") {
@@ -1953,6 +1967,9 @@ function isHostHookHost(value) {
 function isHostHookEvent(value) {
   return value === "PostToolUse" || value === "PreToolUse" || value === "Stop" || value === "SubagentStop" || value === "UserPromptSubmit";
 }
+function isCompoundGateMode(value) {
+  return value === "off" || value === "lite" || value === "strict";
+}
 
 // src/commands/host-hook.ts
 var defaultStdinTimeoutMs = 750;
@@ -1960,6 +1977,7 @@ var maxDebugRawInputBytes = 256 * 1024;
 async function runHostHook(args) {
   const host = readOption(args, "--host");
   const event = readOption(args, "--event");
+  const compoundGateMode = readCompoundGateMode(args);
   if (!isHostHookHost(host)) {
     console.error("Expected --host <codex|claude-code|antigravity>");
     return 1;
@@ -1970,9 +1988,10 @@ async function runHostHook(args) {
   }
   const rawInput = await readStdinText(defaultStdinTimeoutMs);
   const input = parseStdinJson(rawInput);
-  const decision = evaluateHostHook({ host, event, input });
+  const decision = evaluateHostHook({ compoundGateMode, host, event, input });
   const output = formatHostHookOutput(host, event, decision);
   writeDebugLogIfRequested(args, {
+    compoundGateMode,
     decision,
     event,
     host,
@@ -1984,6 +2003,11 @@ async function runHostHook(args) {
 `);
   return 0;
 }
+function readCompoundGateMode(args) {
+  const value = readOption(args, "--compound-gate-mode") ?? process.env.PGS_COMPOUND_GATE_MODE ?? "off";
+  if (isCompoundGateMode(value)) return value;
+  return "off";
+}
 function readOption(args, name) {
   const index = args.indexOf(name);
   if (index < 0) return void 0;
@@ -2041,6 +2065,7 @@ function writeDebugLogIfRequested(args, record) {
         {
           schemaVersion: 1,
           cwd: process.cwd(),
+          compoundGateMode: record.compoundGateMode,
           event: record.event,
           host: record.host,
           nodeVersion: process.version,
@@ -4172,7 +4197,7 @@ var COMMANDS = [
   "lens report --target <path> --out <path>",
   "lens audit init --target <path> --out <path>",
   "lens audit check --dir <path> [--json]",
-  "host-hook --host <codex|claude-code|antigravity> --event <Stop|SubagentStop|...>",
+  "host-hook --host <codex|claude-code|antigravity> --event <Stop|SubagentStop|...> [--compound-gate-mode off|lite|strict]",
   "init --profile <engineering-runtime|doc-only> <--dry-run|--apply>",
   "sync --check [--profile <engineering-runtime|doc-only>]",
   "doctor"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pieai/pro-gov",
-  "version": "0.3.17",
+  "version": "0.4.0",
   "description": "Project-level distribution kit for Project Governance System.",
   "keywords": [
     "ai-agents",
@@ -35,7 +35,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pieai/doc-gov": "^0.3.17"
+    "@pieai/doc-gov": "^0.4.0"
   },
   "devDependencies": {
     "@types/node": "24.13.2",