@pieai/pro-gov 0.7.2 → 0.7.3

package/README.md

@@ -11,8 +11,7 @@ station:
 - `pro-gov` shows which reusable project-governance parts are present or missing;
 - `@pieai/doc-gov` checks documents, routing, links, guardrails, and CI;
 - the AI host and project checks own normal execution;
-- optional Matt skills trigger only when their narrow descriptions match;
-- `capture-learning` records a reusable lesson only when one exists.
+- `capture-learning` visibly decides whether completed verified work produced a reusable lesson, and records it only when one exists.
 
 The current `pro-gov` release is conservative by design. Public init and sync
 commands inspect and compare; they do not silently overwrite another project's
@@ -140,20 +139,20 @@ the private-source and public-copy hashes recorded during promotion.
 
 ## Lightweight Agent Workflow
 
-The AI host and the target project's proof commands own ordinary work. Matt
-Pocock's skills may be exposed as an optional unchanged library; each skill
-triggers from its own narrow description and does not become a mandatory
-pipeline or workflow owner.
+The AI host and the target project's proof commands own ordinary work. PGS
+does not appoint a mandatory workflow owner or require an external skill pack.
 
 Before
 non-trivial implementation, debugging, release, architecture, or portfolio-sync
 work, run `pro-gov learn recall --query "<task summary>"` and read relevant
 `docs/reference/learnings/**` or `CONCEPTS.md` hits before changing files.
 
-After verified work, use the small `capture-learning` skill only when the result
-will help future work. It calls `pro-gov learn capture` and writes a compact
-`docs/reference/learnings/**` record. PGS does not install Stop/SubagentStop reminder
-hooks or require a completion ceremony.
+After completed, verified, non-trivial work, the small `capture-learning` Skill
+makes one visible decision. It writes a compact `docs/reference/learnings/**`
+record only when the result will help future work; otherwise it reports a skip.
+Resolve the CLI through the project (`pnpm pro-gov` in the PGS source repository)
+instead of assuming a global binary. PGS does not install Stop/SubagentStop
+reminder hooks or require a completion gate.
 
 Read the
 [full project introduction](https://github.com/PieAIStudio/ProjectGovernanceSystem#readme)

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

@@ -25,8 +25,8 @@ Use this when a project wants to migrate into the Project Governance System.
 
 Before choosing optional AI skills, read
 `docs/reference/adoption/recommended-agent-tooling.md`. It explains which PGS
-packages are required, how Matt skills remain trigger-based, and how the small
-native learning-capture path works.
+packages are required, how optional capabilities remain explicit, and how the
+small native learning-capture path works.
 
 ## The Short Version
 
@@ -203,9 +203,8 @@ Do not copy the upstream root `integrations/` directory into target projects by
 If a project needs local external-workflow guidance, keep it thin in `AGENTS.md` or put project-specific notes under `docs/reference/integrations/`.
 
 For engineering projects, normal execution belongs to the AI host and the
-project's own proof commands. Matt Pocock's skills remain available as a
-lightweight library and trigger only when their narrow descriptions match; they
-are not a mandatory pipeline or workflow owner.
+project's own proof commands. PGS does not appoint a mandatory pipeline or
+workflow owner.
 
 Use PGS Learning Recall before non-trivial work:
 
@@ -214,9 +213,10 @@ pro-gov learn recall --query "<task summary>"
 ```
 
 This reads the project's existing `docs/reference/learnings/**` and `CONCEPTS.md` records.
-After verified work, use `capture-learning` only when the result is genuinely
-reusable. The skill calls `pro-gov learn capture`; no exit hook or completion
-ceremony is required.
+After completed, verified, non-trivial work, let `capture-learning` visibly
+decide whether the result is genuinely reusable. The Skill captures or reports a
+skip; no exit hook or mandatory completion ceremony is required. Resolve
+`pro-gov` through the project rather than assuming a global binary.
 
 ### Doc-Only
 

package/assets/docs/reference/adoption/migration-v1.0.md

@@ -27,9 +27,9 @@ document systems instead of adding another layer.
 ## Decision Surface
 
 1. Move every durable decision from `docs/decisions/**` to `docs/adr/**`.
-2. Rename numbered files to Matt's `NNNN-slug.md` form where practical.
-3. Preserve useful existing frontmatter; Matt can read richer ADRs, but new ADRs
-   may stay as short as a heading plus one decision paragraph.
+2. Rename numbered files to the `NNNN-slug.md` form where practical.
+3. Preserve useful existing frontmatter; new ADRs may stay concise while still
+   using the governed decision schema.
 4. Remove external ADR ids from governed documents' `related` arrays. Keep a
    normal Markdown path to the ADR in the body when the relationship matters;
    Doc Gov validates only ids in its governed document graph.

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

@@ -28,8 +28,7 @@ work; tools and skills add capabilities only when their narrow trigger matches.
 | --- | --- | --- |
 | `@pieai/pro-gov` | required | Profiles, assets, learning recall/capture, portfolio checks |
 | `@pieai/doc-gov` | required | Governed-document and router validation |
-| mattpocock/skills | available | Optional specialist toolbox; no bootstrap or workflow owner |
-| `capture-learning` | available | Save a verified reusable lesson after completed work |
+| `capture-learning` | available | Make a visible soft closeout decision and save a verified reusable lesson only when one exists |
 | Superpowers | do not install | Retired mandatory workflow plugin |
 | Compound Engineering | do not install | Retired; native PGS capture keeps the useful learning loop |
 | Ponytail | do not install | Retired global mode/hooks; ordinary engineering judgment stays lean |
@@ -40,15 +39,27 @@ Before non-trivial work:
 pro-gov learn recall --query "<task summary>"
 ```
 
-After verified work, `capture-learning` first checks for an existing lesson and
-then calls this only when a new reusable lesson exists:
+After completed, verified, non-trivial work, `capture-learning` makes one visible
+closeout decision. It first checks for an existing lesson and then calls this only
+when a new reusable lesson exists:
 
 ```bash
 pro-gov learn capture --title "<learning title>" --summary "<reusable lesson>"
 ```
 
 Do not add Stop/SubagentStop workflow reminder hooks. Verification belongs in
-the task and the project's real command ladder.
+the task and the project's real command ladder. The Skill is implicitly
+discoverable, but its closeout check is soft: trivial work is silent, unfinished
+work is not interrupted, and a reusable lesson is never required for completion.
+
+Do not treat a long conversation as a learning record by default. Current state
+belongs in current-work, hard-to-reverse decisions in ADRs, approved requirements
+in Specs, execution order in Plans, and only verified recurring guidance in
+`docs/reference/learnings/**`.
+
+Resolve the CLI through the project rather than assuming a global binary. The PGS
+source repository uses `pnpm pro-gov`; consumers may expose `pro-gov` directly or
+through their package manager's local executable command.
 
 Host plugins that provide external capabilities—such as GitHub, Vercel,
 Supabase, browsers, documents, or device control—remain independent choices.

package/assets/integrations/.gitkeep

@@ -0,0 +1 @@
+