@pieai/pro-gov 0.4.8 → 0.5.0

package/assets/profiles/doc-only/manifest.yml

@@ -6,7 +6,7 @@ required:
   ai_in_the_loop:
     target: docs/policy/shared-rules/ai-in-the-loop.md
     source: external shared-rule SSOT
-  agents_routing: docs/governance/agents-routing/doc-only-v0.9.md
+  agents_routing: docs/governance/agents-routing/doc-only-v1.0.md
   current_work: docs/reference/execution/current-work.md
 project_local_required:
   - docs/policy/best-practice-for-this-project.md

package/assets/profiles/doc-only/profile.md

@@ -6,9 +6,9 @@ Use for non-runtime projects: IP development, AI media production, research vaul
 
 - `packages/doc-gov`
 - `packages/pro-gov`
-- `docs/governance/ssot-v0.9.md`
+- `docs/governance/ssot-v1.0.md`
 - external AI-in-the-Loop policy linked by target projects under `docs/policy/shared-rules/ai-in-the-loop.md`
-- `docs/governance/agents-routing/doc-only-v0.9.md`
+- `docs/governance/agents-routing/doc-only-v1.0.md`
 - starter `docs/governance/` and `docs/policy/` templates
 
 ## Does Not Include By Default

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

@@ -6,7 +6,7 @@ required:
   ai_in_the_loop:
     target: docs/policy/shared-rules/ai-in-the-loop.md
     source: external shared-rule SSOT
-  agents_routing: docs/governance/agents-routing/engineering-runtime-v0.9.md
+  agents_routing: docs/governance/agents-routing/engineering-runtime-v1.0.md
   current_work: docs/reference/execution/current-work.md
 optional:
   mattpocock_skills: integrations/mattpocock-skills.md

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

@@ -6,9 +6,9 @@ Use for code-heavy projects: apps, games, runtimes, services, browser products,
 
 - `packages/doc-gov`
 - `packages/pro-gov`
-- `docs/governance/ssot-v0.9.md`
+- `docs/governance/ssot-v1.0.md`
 - external AI-in-the-Loop policy linked by target projects under `docs/policy/shared-rules/ai-in-the-loop.md`
-- `docs/governance/agents-routing/engineering-runtime-v0.9.md`
+- `docs/governance/agents-routing/engineering-runtime-v1.0.md`
 - `integrations/mattpocock-skills.md`
 - starter `docs/governance/` and `docs/policy/` templates
 
@@ -41,6 +41,6 @@ guardrails are also consumer-owned when installed; `doc-gov doctor` checks that
 their required governance commands remain present.
 
 For non-trivial engineering work, run `pro-gov learn recall --query "<task
-summary>"` before changing files so existing `docs/solutions/**` and
+summary>"` before changing files so existing `docs/reference/learnings/**` and
 `CONCEPTS.md` lessons can shape the work. After verified work, use the
 `capture-learning` skill only when a reusable lesson exists.

package/assets/starter/AGENTS.template.md

@@ -2,7 +2,7 @@
 
 ## PGS Router Block
 
-<!-- PGS-ROUTER:BEGIN v0.9 -->
+<!-- PGS-ROUTER:BEGIN v1.0 -->
 
 ## Boundary
 
@@ -19,7 +19,7 @@
 ## Documentation Tasks
 
 When the task creates, edits, moves, deletes, or governs documentation, read
-`docs/governance/boundary.md`, `docs/governance/ssot-v0.9.md`,
+`docs/governance/boundary.md`, `docs/governance/ssot-v1.0.md`,
 `docs/governance/doc-agent-rules.md`, `docs/governance/doc-types.md`, the
 selected agents routing file, and all Markdown under `docs/policy/**/*.md`.
 That policy set includes subdirectories and symlinked shared-rule files; keep

package/assets/starter/docs/governance/agents-routing/{doc-only-v0.9.md → doc-only-v1.0.md}

@@ -1,6 +1,6 @@
 ---
-id: GOV-AGENTS-ROUTING-DOC-ONLY-V0-9
-title: Doc-Only Agents Routing v0.9
+id: GOV-AGENTS-ROUTING-DOC-ONLY-V1-0
+title: Doc-Only Agents Routing v1.0
 type: policy
 status: stable
 canonical: true
@@ -14,13 +14,13 @@ tags:
   - workflow
 pinned: true
 related:
-  - GOV-SSOT-V0-9
+  - GOV-SSOT-V1-0
   - REF-DOC-GOVERNANCE-BOUNDARY
 supersedes: []
 superseded_by: null
 ---
 
-# Doc-Only Agents Routing v0.9
+# Doc-Only Agents Routing v1.0
 
 Shared routing algorithm for non-runtime projects such as AI media, IP development, research, and asset governance workspaces.
 

package/assets/starter/docs/governance/agents-routing/{engineering-runtime-v0.9.md → engineering-runtime-v1.0.md}

@@ -1,6 +1,6 @@
 ---
-id: GOV-AGENTS-ROUTING-ENGINEERING-RUNTIME-V0-9
-title: Engineering Runtime Agents Routing v0.9
+id: GOV-AGENTS-ROUTING-ENGINEERING-RUNTIME-V1-0
+title: Engineering Runtime Agents Routing v1.0
 type: policy
 status: stable
 canonical: true
@@ -14,13 +14,13 @@ tags:
   - workflow
 pinned: true
 related:
-  - GOV-SSOT-V0-9
+  - GOV-SSOT-V1-0
   - REF-DOC-GOVERNANCE-BOUNDARY
 supersedes: []
 superseded_by: null
 ---
 
-# Engineering Runtime Agents Routing v0.9
+# Engineering Runtime Agents Routing v1.0
 
 Shared routing algorithm for app, game, runtime, and code-heavy projects.
 

package/assets/starter/docs/governance/boundary.md

@@ -53,13 +53,14 @@ project-specific AI development habits live.
 | --- | --- |
 | AI startup entry | `AGENTS.md` |
 | Agent routing algorithm | `docs/governance/agents-routing/` |
-| Governed SSOT rules | `docs/governance/ssot-v0.9.md` |
+| Governed SSOT rules | `docs/governance/ssot-v1.0.md` |
 | Project AI development practices | `docs/policy/best-practice-for-this-project.md` |
 | Current work index | `docs/reference/execution/current-work.md` |
 | Product or world truth | `docs/canon/` |
+| Durable decisions | `docs/adr/`, the single Matt-compatible decision surface |
 | Active implementation work | `docs/plans/active/` |
 | Completed proof records | `docs/plans/completed/` |
-| Reusable project learnings | `docs/solutions/**` as learning artifacts |
+| Reusable project learnings | `docs/reference/learnings/**` as governed reference documents |
 | Product artifacts outside governed docs | Project package, workbench, assets, runtime config, or source tree |
 
 When unsure, ask this question: is this rule about how the document system works,
@@ -76,5 +77,6 @@ product packages, workbenches, prompt libraries, source folders, or asset
 folders can be product artifacts. Keep those files where the product package
 expects them unless a project explicitly opts them into doc-gov.
 
-Learning artifacts under `docs/solutions/**` are not governed docs by default.
-They remain searchable project artifacts with their own lightweight metadata.
+Matt-native files under `docs/adr/**` and `docs/agents/**` are not governed docs
+by default. `docs/adr/**` is nevertheless the only durable decision surface;
+do not copy ADRs into a second PGS decision directory.

package/assets/starter/docs/governance/doc-agent-rules.md

@@ -42,7 +42,6 @@ If a canonical document exists, update it instead of creating a parallel documen
 Use only:
 
 - `policy`
-- `decision`
 - `spec`
 - `plan`
 - `canon`
@@ -57,14 +56,11 @@ Normal documents:
 draft -> active -> completed -> stable -> superseded -> archived
 ```
 
-Decision documents:
-
-```text
-proposed -> accepted -> rejected | superseded
-```
-
 `completed` is for finished execution records or specs that should no longer appear in active folders.
 
+Durable decisions belong only in `docs/adr/**`. They use Matt's concise ADR
+format and remain outside the Doc Gov status machine.
+
 ## Upstream Rule
 
 Do not locally invent doc-gov core changes. Propose core changes upstream in

package/assets/starter/docs/governance/doc-types.md

@@ -28,7 +28,6 @@ Allowed types:
 | Type | Default path |
 | --- | --- |
 | `policy` | `docs/policy/` for project policy; `docs/governance/` for doc-system policy |
-| `decision` | `docs/decisions/` |
 | `spec` | `docs/specs/active/` or `docs/specs/completed/` |
 | `plan` | `docs/plans/active/` or `docs/plans/completed/` |
 | `canon` | `docs/canon/` |
@@ -43,8 +42,5 @@ Normal documents use:
 draft -> active -> completed -> stable -> superseded -> archived
 ```
 
-Decision documents use:
-
-```text
-proposed -> accepted -> rejected | superseded
-```
+Durable decisions use the Matt-compatible `docs/adr/**` surface and stay
+outside the Doc Gov schema. Do not duplicate them in another decision folder.

package/assets/starter/docs/governance/{ssot-v0.9.md → ssot-v1.0.md}

@@ -1,6 +1,6 @@
 ---
-id: GOV-SSOT-V0-9
-title: SSOT Documentation Governance Rules v0.9
+id: GOV-SSOT-V1-0
+title: SSOT Documentation Governance Rules v1.0
 type: policy
 status: stable
 canonical: true
@@ -19,7 +19,7 @@ supersedes: []
 superseded_by: null
 ---
 
-# SSOT Documentation Governance Rules v0.9
+# SSOT Documentation Governance Rules v1.0
 
 This rule defines how projects using Project Governance System handle
 **SSOT (Single Source of Truth)** for governed documentation.
@@ -37,7 +37,7 @@ Project Governance System governs:
 - `AGENTS.md` and equivalent AI entry files.
 - Governed Markdown under `docs/**`.
 - Documentation governance rules, agent routing rules, templates, manifests,
-  plans, specs, decisions, references, canon, and archives that live under
+  plans, specs, references, canon, and archives that live under
   `docs/**`.
 
 Project Governance System does **not** automatically govern every Markdown file
@@ -50,10 +50,12 @@ Markdown.
 
 Extra governed roots are allowed only when a project explicitly opts in.
 
-Learning and optional-tool artifacts are explicitly outside the default Doc Gov
-schema:
+Matt-native and optional-tool artifacts are explicitly outside the default Doc
+Gov schema:
 
-- `docs/solutions/**`
+- `CONTEXT.md` and `CONTEXT-MAP.md`
+- `docs/adr/**`
+- `docs/agents/**`
 - `docs/brainstorms/**`
 - `docs/pulse-reports/**`
 
@@ -83,7 +85,7 @@ Before changing docs, look for project-local guidance in this order:
 
 1. `AGENTS.md`, `CLAUDE.md`, or equivalent AI router/config adapter.
 2. `docs/governance/boundary.md`.
-3. `docs/governance/ssot-v0.9.md`.
+3. `docs/governance/ssot-v1.0.md`.
 4. `docs/governance/agents-routing/` and the project's selected agents-routing file.
 5. `docs/reference/documentation-map.md`, root `README.md` for human-facing
    orientation, or another project-defined documentation index.
@@ -114,9 +116,10 @@ works for governed docs:
 | Agents-routing rules | `docs/governance/agents-routing/` |
 | Doc-system rules, templates, and manifest | `docs/governance/` |
 | Project AI/development policy | `docs/policy/` |
+| Durable decisions | `docs/adr/`, the single Matt-compatible decision surface outside Doc Gov schema |
 | Product or feature requirement | `docs/specs/` |
 | Step-by-step implementation work | `docs/plans/` |
-| Reusable learning records | `docs/solutions/**`, outside Doc Gov schema |
+| Reusable learning records | `docs/reference/learnings/**`, governed as `reference` documents and recalled on demand |
 | Durable workspace/system truth | `docs/canon/` |
 | How-to guides, architecture maps, tool notes | `docs/reference/` |
 | Retired governed history | `docs/archive/` |

package/assets/starter/docs/governance/templates/adr.md

@@ -1,23 +1,3 @@
----
-id: REPLACE-ME
-title: Replace Me
-type: decision
-status: proposed
-canonical: true
-owner: human
-created: YYYY-MM-DD
-last_reviewed: YYYY-MM-DD
-domain: meta
-tags:
-  - replace-me
-pinned: false
-related: []
----
+# Replace Me
 
-# REPLACE-ME: Replace Me
-
-## Context
-
-## Decision
-
-## Consequences
+Record the context, decision, and why in one to three sentences.

package/assets/starter/docs/reference/documentation-map.md

@@ -24,10 +24,10 @@ Use `AGENTS.md` for startup reading. It should point agents to:
 
 - `docs/policy/*.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/reference/execution/current-work.md`
 
 ## Areas
@@ -35,12 +35,12 @@ Use `AGENTS.md` for startup reading. It should point agents to:
 | Area | Purpose |
 | --- | --- |
 | `docs/policy/` | Project policy and AI development rules |
-| `docs/decisions/` | Durable decisions |
+| `docs/adr/` | The single Matt-compatible durable decision surface, outside Doc Gov schema |
 | `docs/specs/active/` | Active requirements |
 | `docs/specs/completed/` | Completed specs |
 | `docs/plans/active/` | Active implementation plans |
 | `docs/plans/completed/` | Completed execution records |
-| `docs/solutions/` | Reusable learning records, outside Doc Gov schema |
+| `docs/reference/learnings/` | Governed reusable learning references, recalled only when relevant |
 | `docs/canon/` | Durable project truth |
 | `docs/reference/` | Guides and references |
 | `docs/archive/` | Retired history |
@@ -51,6 +51,6 @@ project-package canon, generated media notes, and source-package files stay in
 their product/workbench structure unless this project explicitly opts them into
 doc-gov.
 
-Optional skills may create `docs/solutions/**`, `docs/brainstorms/**`, or
-`docs/pulse-reports/**`. Those are external artifacts, not Doc Gov canonical
-documents.
+Optional skills may create `docs/brainstorms/**` or `docs/pulse-reports/**` as
+external artifacts. Capture Learning writes governed references under
+`docs/reference/learnings/**`.

package/cli-guide.md

@@ -48,7 +48,7 @@ commands without requiring byte-for-byte template equality. It infers the
 installed profile when exactly one route exists; `--profile` resolves an empty
 or temporarily ambiguous target. PGS does not install or modify AI-host hooks.
 
-`learn recall` searches `docs/solutions/**` and
+`learn recall` searches `docs/reference/learnings/**` and
 `CONCEPTS.md` in the target repository and returns the most relevant prior
 lessons for the current task. Use it before non-trivial implementation,
 debugging, release, architecture, or portfolio-sync work. It is read-only and
@@ -56,7 +56,7 @@ does not require a full local PGS checkout.
 
 `learn capture` is the small native capture path. Use it only after verified
 work produced a reusable lesson that is not already covered by an existing
-`docs/solutions/**` record:
+`docs/reference/learnings/**` record:
 
 ```bash
 pro-gov learn capture \