@pieai/pro-gov 0.4.2 → 0.4.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +17 -59
- package/assets/docs/reference/adoption/adoption-playbook.md +16 -68
- package/assets/docs/reference/adoption/agent-workflow-methodology-comparison.md +10 -2
- package/assets/docs/reference/adoption/recommended-agent-tooling.md +21 -118
- package/assets/integrations/compound-engineering.md +8 -161
- package/assets/integrations/directed-development.md +4 -6
- package/assets/integrations/mattpocock-skills.md +27 -130
- package/assets/integrations/ponytail.md +6 -158
- package/assets/integrations/superpowers.md +9 -104
- package/assets/profiles/doc-only/manifest.yml +1 -4
- package/assets/profiles/doc-only/profile.md +4 -2
- package/assets/profiles/engineering-runtime/manifest.yml +1 -4
- package/assets/profiles/engineering-runtime/profile.md +6 -14
- package/assets/starter/AGENTS.template.md +5 -7
- package/assets/starter/docs/governance/agents-routing/doc-only-v0.9.md +2 -2
- package/assets/starter/docs/governance/agents-routing/engineering-runtime-v0.9.md +5 -4
- package/assets/starter/docs/governance/boundary.md +4 -7
- package/assets/starter/docs/governance/ssot-v0.9.md +3 -4
- package/assets/starter/docs/reference/documentation-map.md +4 -4
- package/cli-guide.md +17 -38
- package/dist/cli.js +135 -707
- package/package.json +2 -2
- package/assets/starter/.agents/hooks.json +0 -26
- package/assets/starter/.claude/settings.json +0 -26
- package/assets/starter/.codex/hooks.json +0 -28
|
@@ -50,13 +50,12 @@ Markdown.
|
|
|
50
50
|
|
|
51
51
|
Extra governed roots are allowed only when a project explicitly opts in.
|
|
52
52
|
|
|
53
|
-
|
|
54
|
-
|
|
53
|
+
Learning and optional-tool artifacts are explicitly outside the default Doc Gov
|
|
54
|
+
schema:
|
|
55
55
|
|
|
56
56
|
- `docs/solutions/**`
|
|
57
57
|
- `docs/brainstorms/**`
|
|
58
58
|
- `docs/pulse-reports/**`
|
|
59
|
-
- CE-native root artifacts under `docs/plans/*`
|
|
60
59
|
|
|
61
60
|
PGS plans remain under `docs/plans/active/**` and
|
|
62
61
|
`docs/plans/completed/**`.
|
|
@@ -117,7 +116,7 @@ works for governed docs:
|
|
|
117
116
|
| Project AI/development policy | `docs/policy/` |
|
|
118
117
|
| Product or feature requirement | `docs/specs/` |
|
|
119
118
|
| Step-by-step implementation work | `docs/plans/` |
|
|
120
|
-
|
|
|
119
|
+
| Reusable learning records | `docs/solutions/**`, outside Doc Gov schema |
|
|
121
120
|
| Durable workspace/system truth | `docs/canon/` |
|
|
122
121
|
| How-to guides, architecture maps, tool notes | `docs/reference/` |
|
|
123
122
|
| Retired governed history | `docs/archive/` |
|
|
@@ -40,7 +40,7 @@ Use `AGENTS.md` for startup reading. It should point agents to:
|
|
|
40
40
|
| `docs/specs/completed/` | Completed specs |
|
|
41
41
|
| `docs/plans/active/` | Active implementation plans |
|
|
42
42
|
| `docs/plans/completed/` | Completed execution records |
|
|
43
|
-
| `docs/solutions/` |
|
|
43
|
+
| `docs/solutions/` | Reusable learning records, outside Doc Gov schema |
|
|
44
44
|
| `docs/canon/` | Durable project truth |
|
|
45
45
|
| `docs/reference/` | Guides and references |
|
|
46
46
|
| `docs/archive/` | Retired history |
|
|
@@ -51,6 +51,6 @@ project-package canon, generated media notes, and source-package files stay in
|
|
|
51
51
|
their product/workbench structure unless this project explicitly opts them into
|
|
52
52
|
doc-gov.
|
|
53
53
|
|
|
54
|
-
|
|
55
|
-
`docs/pulse-reports
|
|
56
|
-
|
|
54
|
+
Optional skills may create `docs/solutions/**`, `docs/brainstorms/**`, or
|
|
55
|
+
`docs/pulse-reports/**`. Those are external artifacts, not Doc Gov canonical
|
|
56
|
+
documents.
|
package/cli-guide.md
CHANGED
|
@@ -21,17 +21,15 @@ pro-gov portfolio plan --config /path/to/portfolio.json --target web-app --json
|
|
|
21
21
|
pro-gov portfolio assets-check --config /path/to/portfolio.json --json
|
|
22
22
|
pro-gov portfolio doctor --config /path/to/portfolio.json --json
|
|
23
23
|
pro-gov learn recall --query "release downstream sync" --target .
|
|
24
|
-
pro-gov learn capture --title "
|
|
24
|
+
pro-gov learn capture --title "Reusable learning" --summary "Reusable lesson..." --target .
|
|
25
25
|
pro-gov lens inspect --target .
|
|
26
26
|
pro-gov lens report --target . --out .pro-gov/lens-report.md
|
|
27
27
|
pro-gov lens audit init --target /path/to/project --out audits/project/2026-07-01
|
|
28
28
|
pro-gov lens audit check --dir audits/project/2026-07-01
|
|
29
|
-
pro-gov host-hook --host codex --event Stop --compound-gate-mode off|lite|strict
|
|
30
29
|
pro-gov init --profile engineering-runtime --dry-run
|
|
31
30
|
pro-gov init --profile engineering-runtime --apply
|
|
32
31
|
pro-gov init --profile doc-only --dry-run
|
|
33
32
|
pro-gov sync --check [--profile engineering-runtime|doc-only]
|
|
34
|
-
pro-gov sync --apply-host-hooks --profile engineering-runtime
|
|
35
33
|
pro-gov doctor
|
|
36
34
|
```
|
|
37
35
|
|
|
@@ -43,46 +41,28 @@ Actions references stay packaged but are not installed by default.
|
|
|
43
41
|
|
|
44
42
|
`sync --check` is read-only. It compares shared governance core files strictly,
|
|
45
43
|
but checks project-local seeds such as `AGENTS.md`, project policy, and current
|
|
46
|
-
work for presence only.
|
|
47
|
-
consumer
|
|
48
|
-
|
|
44
|
+
work for presence only. Optional `lefthook.yml` and CI guardrails remain
|
|
45
|
+
consumer-owned when installed; `doc-gov doctor` validates their required PGS
|
|
46
|
+
commands without requiring byte-for-byte template equality. It infers the
|
|
47
|
+
installed profile when exactly one route exists; `--profile` resolves an empty
|
|
48
|
+
or temporarily ambiguous target. PGS does not install or modify AI-host hooks.
|
|
49
49
|
|
|
50
|
-
`
|
|
51
|
-
host configs. It updates only PGS Compound Gate entries and preserves consumer
|
|
52
|
-
`PreToolUse`, other events, other top-level keys, and non-PGS entries inside
|
|
53
|
-
Stop/SubagentStop arrays. All three files are parsed before any write.
|
|
54
|
-
|
|
55
|
-
`learn recall` is the pre-work companion to Compound Engineering's post-work
|
|
56
|
-
`ce-compound` learning records. It searches `docs/solutions/**` and
|
|
50
|
+
`learn recall` searches `docs/solutions/**` and
|
|
57
51
|
`CONCEPTS.md` in the target repository and returns the most relevant prior
|
|
58
52
|
lessons for the current task. Use it before non-trivial implementation,
|
|
59
53
|
debugging, release, architecture, or portfolio-sync work. It is read-only and
|
|
60
54
|
does not require a full local PGS checkout.
|
|
61
55
|
|
|
62
|
-
`learn capture` is the
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
reusable lesson that is not already covered by an existing `docs/solutions/**`
|
|
66
|
-
record:
|
|
56
|
+
`learn capture` is the small native capture path. Use it only after verified
|
|
57
|
+
work produced a reusable lesson that is not already covered by an existing
|
|
58
|
+
`docs/solutions/**` record:
|
|
67
59
|
|
|
68
60
|
```bash
|
|
69
61
|
pro-gov learn capture \
|
|
70
|
-
--title "
|
|
71
|
-
--summary "Capture the
|
|
62
|
+
--title "Keep the reusable lesson searchable" \
|
|
63
|
+
--summary "Capture the lesson so Learning Recall can find it later."
|
|
72
64
|
```
|
|
73
65
|
|
|
74
|
-
Then report:
|
|
75
|
-
|
|
76
|
-
```text
|
|
77
|
-
Compound Gate: ran fallback capture -> docs/solutions/<category>/<file>.md
|
|
78
|
-
```
|
|
79
|
-
|
|
80
|
-
`host-hook` is the cross-host Compound Gate adapter for Codex, Claude Code, and
|
|
81
|
-
Antigravity. `--compound-gate-mode off` is the default and does not interrupt
|
|
82
|
-
the main session. `lite` emits a short continuation prompt when completed
|
|
83
|
-
engineering work lacks a Compound Gate marker. `strict` emits the fuller legacy
|
|
84
|
-
prompt. The same value can be supplied through `PGS_COMPOUND_GATE_MODE`.
|
|
85
|
-
|
|
86
66
|
Full upstream-checkout commands:
|
|
87
67
|
|
|
88
68
|
```bash
|
|
@@ -120,7 +100,7 @@ maintainer checks.
|
|
|
120
100
|
`portfolio assets-check` verifies that the currently recorded lock and managed
|
|
121
101
|
links are healthy. `portfolio doctor` additionally compares each target with the
|
|
122
102
|
current portfolio `assetBundles`, registry hashes, package versions, target-local
|
|
123
|
-
router
|
|
103
|
+
router checks, and optional `hostTooling` requirements. The doctor is
|
|
124
104
|
offline and read-only by default. A dirty product worktree is reported as
|
|
125
105
|
evidence but is not itself a governance failure.
|
|
126
106
|
|
|
@@ -138,14 +118,14 @@ The native tools own fetching and installation. PGS reviews resulting asset
|
|
|
138
118
|
changes, regenerates plans, and verifies the fleet; it does not implement a
|
|
139
119
|
second plugin marketplace or silently accept upstream changes.
|
|
140
120
|
|
|
141
|
-
`lens audit init` creates a raw-first audit package for Project Lens
|
|
142
|
-
|
|
121
|
+
`lens audit init` creates a raw-first audit package for Project Lens reviews.
|
|
122
|
+
For a "read-only project audit", the target repository remains
|
|
143
123
|
read-only, but the audit package is still the required output record. `lens
|
|
144
124
|
audit check` fails when the package is missing required artifacts, when
|
|
145
125
|
artifacts are still marked pending, or when generated template text was not
|
|
146
126
|
replaced with real audit output. It also requires method records for the
|
|
147
|
-
read-only boundary, agent execution, subagent trace, Project Lens
|
|
148
|
-
sources, target status, and audit package status. Use
|
|
127
|
+
read-only boundary, agent execution, subagent trace, Project Lens and simplicity
|
|
128
|
+
review sources, target status, and audit package status. Use
|
|
149
129
|
`lens audit check --mode fresh` when this session must prove it created the raw
|
|
150
130
|
passes; use `--mode reuse` when it only verifies an existing audit package.
|
|
151
131
|
|
|
@@ -160,7 +140,6 @@ pnpm pro-gov init --profile engineering-runtime --dry-run
|
|
|
160
140
|
pnpm pro-gov init --profile engineering-runtime --apply
|
|
161
141
|
pnpm doc-gov scan
|
|
162
142
|
pnpm pro-gov sync --check --profile engineering-runtime
|
|
163
|
-
pnpm pro-gov sync --apply-host-hooks --profile engineering-runtime
|
|
164
143
|
pnpm doc-gov migrate --profile engineering-runtime --check
|
|
165
144
|
pnpm doc-gov doctor
|
|
166
145
|
```
|