@pieai/pro-gov 0.4.5 → 0.4.6

package/assets/docs/reference/adoption/recommended-agent-tooling.md

@@ -53,3 +53,41 @@ the task and the project's real command ladder.
 Host plugins that provide external capabilities—such as GitHub, Vercel,
 Supabase, browsers, documents, or device control—remain independent choices.
 PGS does not require them unless a portfolio manifest explicitly declares one.
+
+## Who Owns Verification
+
+The AI agent executing the task owns verification. Tests do not act on their
+own, and no workflow plugin is required to make the agent run them.
+
+Use the target project's real command ladder as evidence: unit tests, type
+checks, builds, browser checks, deployment checks, or documentation checks as
+appropriate. A narrow skill may help when its trigger matches—such as `tdd` for
+an explicitly test-first request or `diagnosing-bugs` for a hard failure—but no
+skill owns ordinary implementation.
+
+Beginner version: removing the driving instructor does not remove the car's
+brakes or the driver's duty to check them. Superpowers' mandatory ceremony is
+gone; project-specific verification remains because it proves the change works.
+
+## Skill Lifecycle Vocabulary
+
+These states are different. Do not use “installed” as a shortcut for all of
+them.
+
+| State | Meaning | Context/runtime effect |
+| --- | --- | --- |
+| marketplace-listed | The host can offer the plugin for installation. | None until installed. |
+| cached | Source bytes exist locally for reuse or marketplace display. | Not necessarily enabled or discoverable. |
+| registered | PGS knows the asset id, source, scope, and placement. | Inventory only. |
+| bundled | A reviewed PGS bundle names the asset. | Still not installed in a target. |
+| installed | A host plugin record or managed project/user link exists. | May become discoverable, depending on placement and enablement. |
+| enabled | The host is allowed to load an installed plugin. | Plugin components may be exposed to sessions. |
+| discoverable | The host exposes a skill's name and description to the model. | Small catalog/context cost. |
+| model-invoked | The skill description may trigger automatically on a matching task. | Body loads only when selected. |
+| user-invoked | The user or an explicit flow must request the skill. | No automatic skill-body load. |
+| loaded | The host has read the skill body for the current task. | Full skill instructions affect the current turn. |
+
+User-scoped skills are linked once under supported user roots. Project-scoped
+skills are installed through a reviewed asset plan and recorded in the target's
+asset lock. Marketplace catalogs and retired-plugin archives are not installed
+skills.

package/assets/starter/AGENTS.template.md

@@ -11,38 +11,35 @@
 1. All Markdown files under `docs/policy/**/*.md`, including files in
    subdirectories and symlinked shared-rule files.
 2. `docs/governance/boundary.md`
-3. `docs/governance/ssot-v0.9.md`
-4. `docs/governance/doc-agent-rules.md`
-5. `docs/governance/doc-types.md`
-6. The selected agents routing file:
+3. The selected agents routing file:
    - `docs/governance/agents-routing/engineering-runtime-v0.9.md`, or
    - `docs/governance/agents-routing/doc-only-v0.9.md`
-7. `docs/reference/execution/current-work.md`
-8. Before non-trivial implementation, debugging, release, architecture, or
+4. `docs/reference/execution/current-work.md`
+5. Before non-trivial implementation, debugging, release, architecture, or
    migration work, run `pro-gov learn recall --query "<task summary>"` and read
    any relevant prior-learning hits before changing files.
 
+When the task creates, edits, moves, deletes, or governs documentation, also
+read `docs/governance/ssot-v0.9.md`,
+`docs/governance/doc-agent-rules.md`, and `docs/governance/doc-types.md` before
+changing governed files.
+
 ## Governance
 
 - Use doc-gov for governed Markdown.
 - Governed Markdown lives under `docs/**` by default.
 - Product artifacts outside `docs/**` are not governed docs unless this project explicitly opts them in.
 - Before creating docs: `pnpm doc-gov find <topic>`.
-- Before claiming doc work complete:
-  - `pnpm doc-gov router-check`
-  - `pnpm doc-gov check`
-  - `pnpm doc-gov scan --check`
-  - `pnpm doc-gov links`
-  - `pnpm doc-gov audit`
-  - `pnpm doc-gov doctor`
+- Before claiming doc work complete, run `pnpm doc-gov router-check`, `pnpm
+  doc-gov check`, `pnpm doc-gov scan --check`, `pnpm doc-gov links`, `pnpm
+  doc-gov audit`, and `pnpm doc-gov doctor`.
 
 ## Routing
 
 - Name this project's adopted profile: `engineering-runtime` or `doc-only`.
-- Point to the chosen agents-routing file from `docs/governance/agents-routing/`.
-- Before non-trivial work, use Learning Recall. After verified work, use `capture-learning` only when a non-obvious reusable lesson exists.
+- After verified work, use `capture-learning` only when a non-obvious reusable lesson exists.
 - Do not install Stop/SubagentStop workflow reminder hooks.
-- Doc-only projects should say that engineering test workflows are not enabled by default.
+- PROFILE_WORKFLOW_NOTE
 
 <!-- PGS-ROUTER:END -->
 

package/assets/starter/docs/governance/agents-routing/doc-only-v0.9.md

@@ -6,7 +6,7 @@ status: stable
 canonical: true
 owner: human
 created: 2026-05-09
-last_reviewed: 2026-05-09
+last_reviewed: 2026-07-12
 domain: agents-routing
 tags:
   - agents-routing
@@ -51,7 +51,6 @@ flowchart TD
 
 ## Rules
 
-- Do not ask whether the task needs TDD unless the project has actual runtime code.
 - Prefer SSOT, provenance, and approval clarity over engineering ceremonies.
 - Use AI-in-the-Loop for evidence: inspect source, change one thing, verify the target document or asset path.
 

package/dist/cli.js

@@ -1801,13 +1801,14 @@ function applyStarterFiles(files, profile) {
 }
 function renderAgentsTemplate(template, projectName, profile) {
   const selectedRoute = `docs/governance/agents-routing/${profile}-v0.9.md`;
+  const profileWorkflowNote = profile === "doc-only" ? "- Engineering test workflows are not enabled by default for this doc-only project." : "";
   return template.replace("# PROJECT_NAME AI Router", `# ${projectName} AI Router`).replace(
-    /6\. The selected agents routing file:\n   - `docs\/governance\/agents-routing\/engineering-runtime-v0\.9\.md`, or\n   - `docs\/governance\/agents-routing\/doc-only-v0\.9\.md`/,
-    `6. The selected agents routing file: \`${selectedRoute}\``
+    /\d+\. The selected agents routing file:\n   - `docs\/governance\/agents-routing\/engineering-runtime-v0\.9\.md`, or\n   - `docs\/governance\/agents-routing\/doc-only-v0\.9\.md`/,
+    `3. The selected agents routing file: \`${selectedRoute}\``
   ).replace(
     "- Name this project's adopted profile: `engineering-runtime` or `doc-only`.",
     `- This project adopts the \`${profile}\` profile.`
-  );
+  ).replace("- PROFILE_WORKFLOW_NOTE", profileWorkflowNote).replace(/\n{3,}/g, "\n\n");
 }
 function readFlag(args, flag) {
   const index = args.indexOf(flag);

package/package.json

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