@pieai/pro-gov 0.4.9 → 0.5.1

package/README.md

@@ -148,11 +148,11 @@ pipeline or workflow owner.
 Before
 non-trivial implementation, debugging, release, architecture, or portfolio-sync
 work, run `pro-gov learn recall --query "<task summary>"` and read relevant
-`docs/solutions/**` or `CONCEPTS.md` hits before changing files.
+`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/solutions/**` record. PGS does not install Stop/SubagentStop reminder
+`docs/reference/learnings/**` record. PGS does not install Stop/SubagentStop reminder
 hooks or require a completion ceremony.
 
 Read the

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

@@ -167,10 +167,10 @@ Required concepts:
 
 - `docs/reference/documentation-map.md`
 - `docs/governance/boundary.md`
-- `docs/governance/ssot-v0.9.md`
+- `docs/governance/ssot-v1.0.md`
 - `docs/governance/doc-agent-rules.md`
 - `docs/governance/doc-types.md`
-- `docs/governance/agents-routing/<selected-profile>-v0.9.md`
+- `docs/governance/agents-routing/<selected-profile>-v1.0.md`
 - `docs/governance/templates/*.md`
 - `docs/policy/best-practice-for-this-project.md`
 - `docs/reference/execution/current-work.md`
@@ -188,7 +188,7 @@ Required concepts:
 
 Add:
 
-- `docs/governance/agents-routing/engineering-runtime-v0.9.md`
+- `docs/governance/agents-routing/engineering-runtime-v1.0.md`
 - engineering lane summary in `AGENTS.md`
 - detailed lane profile in `docs/policy/best-practice-for-this-project.md`
 
@@ -207,7 +207,7 @@ Use PGS Learning Recall before non-trivial work:
 pro-gov learn recall --query "<task summary>"
 ```
 
-This reads the project's existing `docs/solutions/**` and `CONCEPTS.md` records.
+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.
@@ -216,8 +216,8 @@ ceremony is required.
 
 Add:
 
-- `docs/governance/agents-routing/doc-only-v0.9.md`
-- `docs/governance/ssot-v0.9.md`
+- `docs/governance/agents-routing/doc-only-v1.0.md`
+- `docs/governance/ssot-v1.0.md`
 - AI-in-the-Loop rules linked from the project's external shared-rule source
 - canon/provenance/archive rules in `docs/policy/best-practice-for-this-project.md`
 
@@ -257,8 +257,8 @@ Prompts, generated media notes, project-package canon, source assets, and
 workbench files stay in their product package unless the project explicitly opts
 them into doc-gov.
 
-For the v0.9 structural migration, use
-`docs/reference/adoption/migration-v0.9.md` as the checklist.
+For the v1.0 structural migration, use
+`docs/reference/adoption/migration-v1.0.md` as the checklist.
 
 ## Step 8: Validate
 

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

@@ -0,0 +1,77 @@
+---
+id: REF-MIGRATION-V1-0
+title: Project Governance System v1.0 Migration Checklist
+type: reference
+status: stable
+canonical: true
+owner: human
+created: 2026-07-12
+last_reviewed: 2026-07-12
+domain: adoption
+tags:
+  - migration
+  - v1.0
+  - adr
+  - learning-recall
+pinned: false
+related:
+  - POLICY-VERSIONING
+  - REF-ADOPTION-PLAYBOOK
+---
+
+# v1.0 Migration Checklist
+
+Use this checklist when upgrading a v0.9 project. v1.0 removes two parallel
+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.
+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.
+5. Remove the empty `docs/decisions/` directory.
+6. Do not copy or promote ADRs into a second decision directory.
+
+## Learning Surface
+
+1. Review every record under `docs/solutions/**`.
+2. Delete mechanical, duplicated, unfinished, or CE-only process records.
+3. Move reusable records to `docs/reference/learnings/<category>/**`.
+4. Give each retained record normal Doc Gov `reference` frontmatter, including
+   a unique id and block-list `tags` rather than CE-era inline tags.
+5. Remove stale instructions that prefer Compound Engineering or require a
+   completion hook.
+6. Remove the empty `docs/solutions/` directory.
+
+`pro-gov learn recall` reads the new governed path. During the v1.0 migration
+window it can still find legacy `docs/solutions/**`, but `learn capture` writes
+only the new path.
+
+## Router Contract
+
+Update the project to:
+
+- `<!-- PGS-ROUTER:BEGIN v1.0 -->`
+- `docs/governance/ssot-v1.0.md`
+- `docs/governance/agents-routing/<selected-profile>-v1.0.md`
+
+Replace the v0.9 files rather than keeping two current router contracts.
+
+## Verification
+
+```bash
+pnpm pro-gov sync --check --profile <engineering-runtime|doc-only>
+pnpm doc-gov check
+pnpm doc-gov router-check
+pnpm doc-gov scan --check
+pnpm doc-gov links
+pnpm doc-gov doctor
+git diff --check
+```
+
+Run the target project's normal typecheck, tests, and build when the migration
+touches an engineering repository.

package/assets/integrations/mattpocock-skills.md

@@ -30,8 +30,10 @@ Matt-native artifacts remain external to Doc Gov by default:
 - `.scratch/**`;
 - GitHub/GitLab issues.
 
-Promote durable truth intentionally into `docs/decisions/**`, `docs/specs/**`,
-`docs/plans/**`, `docs/canon/**`, or `docs/reference/**`.
+`docs/adr/**` is the only durable decision surface. Do not copy or promote an
+ADR into a second PGS decision directory. Product truth, requirements,
+implementation plans, and reusable references still belong in
+`docs/canon/**`, `docs/specs/**`, `docs/plans/**`, and `docs/reference/**`.
 
 ## Distribution