@pieai/pro-gov 0.4.3 → 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 +16 -58
- 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 +1 -1
- package/assets/profiles/engineering-runtime/manifest.yml +1 -4
- package/assets/profiles/engineering-runtime/profile.md +3 -13
- 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 +16 -40
- package/dist/cli.js +134 -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
|
@@ -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
|
|
|
@@ -45,47 +43,26 @@ Actions references stay packaged but are not installed by default.
|
|
|
45
43
|
but checks project-local seeds such as `AGENTS.md`, project policy, and current
|
|
46
44
|
work for presence only. Optional `lefthook.yml` and CI guardrails remain
|
|
47
45
|
consumer-owned when installed; `doc-gov doctor` validates their required PGS
|
|
48
|
-
commands without requiring byte-for-byte template equality.
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
`sync --apply-host-hooks` is the bounded write path for engineering-runtime
|
|
54
|
-
host configs. It updates only PGS Compound Gate entries and preserves consumer
|
|
55
|
-
`PreToolUse`, other events, other top-level keys, and non-PGS entries inside
|
|
56
|
-
Stop/SubagentStop arrays. All three files are parsed before any write.
|
|
57
|
-
|
|
58
|
-
`learn recall` is the pre-work companion to Compound Engineering's post-work
|
|
59
|
-
`ce-compound` learning records. It searches `docs/solutions/**` and
|
|
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
|
+
|
|
50
|
+
`learn recall` searches `docs/solutions/**` and
|
|
60
51
|
`CONCEPTS.md` in the target repository and returns the most relevant prior
|
|
61
52
|
lessons for the current task. Use it before non-trivial implementation,
|
|
62
53
|
debugging, release, architecture, or portfolio-sync work. It is read-only and
|
|
63
54
|
does not require a full local PGS checkout.
|
|
64
55
|
|
|
65
|
-
`learn capture` is the
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
reusable lesson that is not already covered by an existing `docs/solutions/**`
|
|
69
|
-
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:
|
|
70
59
|
|
|
71
60
|
```bash
|
|
72
61
|
pro-gov learn capture \
|
|
73
|
-
--title "
|
|
74
|
-
--summary "Capture the
|
|
62
|
+
--title "Keep the reusable lesson searchable" \
|
|
63
|
+
--summary "Capture the lesson so Learning Recall can find it later."
|
|
75
64
|
```
|
|
76
65
|
|
|
77
|
-
Then report:
|
|
78
|
-
|
|
79
|
-
```text
|
|
80
|
-
Compound Gate: ran fallback capture -> docs/solutions/<category>/<file>.md
|
|
81
|
-
```
|
|
82
|
-
|
|
83
|
-
`host-hook` is the cross-host Compound Gate adapter for Codex, Claude Code, and
|
|
84
|
-
Antigravity. `--compound-gate-mode off` is the default and does not interrupt
|
|
85
|
-
the main session. `lite` emits a short continuation prompt when completed
|
|
86
|
-
engineering work lacks a Compound Gate marker. `strict` emits the fuller legacy
|
|
87
|
-
prompt. The same value can be supplied through `PGS_COMPOUND_GATE_MODE`.
|
|
88
|
-
|
|
89
66
|
Full upstream-checkout commands:
|
|
90
67
|
|
|
91
68
|
```bash
|
|
@@ -123,7 +100,7 @@ maintainer checks.
|
|
|
123
100
|
`portfolio assets-check` verifies that the currently recorded lock and managed
|
|
124
101
|
links are healthy. `portfolio doctor` additionally compares each target with the
|
|
125
102
|
current portfolio `assetBundles`, registry hashes, package versions, target-local
|
|
126
|
-
router
|
|
103
|
+
router checks, and optional `hostTooling` requirements. The doctor is
|
|
127
104
|
offline and read-only by default. A dirty product worktree is reported as
|
|
128
105
|
evidence but is not itself a governance failure.
|
|
129
106
|
|
|
@@ -141,14 +118,14 @@ The native tools own fetching and installation. PGS reviews resulting asset
|
|
|
141
118
|
changes, regenerates plans, and verifies the fleet; it does not implement a
|
|
142
119
|
second plugin marketplace or silently accept upstream changes.
|
|
143
120
|
|
|
144
|
-
`lens audit init` creates a raw-first audit package for Project Lens
|
|
145
|
-
|
|
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
|
|
146
123
|
read-only, but the audit package is still the required output record. `lens
|
|
147
124
|
audit check` fails when the package is missing required artifacts, when
|
|
148
125
|
artifacts are still marked pending, or when generated template text was not
|
|
149
126
|
replaced with real audit output. It also requires method records for the
|
|
150
|
-
read-only boundary, agent execution, subagent trace, Project Lens
|
|
151
|
-
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
|
|
152
129
|
`lens audit check --mode fresh` when this session must prove it created the raw
|
|
153
130
|
passes; use `--mode reuse` when it only verifies an existing audit package.
|
|
154
131
|
|
|
@@ -163,7 +140,6 @@ pnpm pro-gov init --profile engineering-runtime --dry-run
|
|
|
163
140
|
pnpm pro-gov init --profile engineering-runtime --apply
|
|
164
141
|
pnpm doc-gov scan
|
|
165
142
|
pnpm pro-gov sync --check --profile engineering-runtime
|
|
166
|
-
pnpm pro-gov sync --apply-host-hooks --profile engineering-runtime
|
|
167
143
|
pnpm doc-gov migrate --profile engineering-runtime --check
|
|
168
144
|
pnpm doc-gov doctor
|
|
169
145
|
```
|