@pareto4/pp-core 1.5.2 → 1.5.3

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.
Files changed (158) hide show
  1. package/.claude-plugin/plugin.json +1 -1
  2. package/agents/pp-advisor-researcher.md +1 -1
  3. package/agents/pp-ai-researcher.md +1 -1
  4. package/agents/pp-assumptions-analyzer.md +1 -1
  5. package/agents/pp-code-fixer.md +2 -2
  6. package/agents/pp-codebase-mapper.md +2 -2
  7. package/agents/pp-debug-session-manager.md +1 -1
  8. package/agents/pp-debugger.md +2 -2
  9. package/agents/pp-doc-classifier.md +1 -1
  10. package/agents/pp-doc-synthesizer.md +1 -1
  11. package/agents/pp-doc-verifier.md +1 -1
  12. package/agents/pp-doc-writer.md +12 -12
  13. package/agents/pp-domain-researcher.md +1 -1
  14. package/agents/pp-eval-planner.md +1 -1
  15. package/agents/pp-executor.md +4 -4
  16. package/agents/pp-framework-selector.md +1 -1
  17. package/agents/pp-intel-updater.md +13 -13
  18. package/agents/pp-pattern-mapper.md +1 -1
  19. package/agents/pp-phase-researcher.md +4 -4
  20. package/agents/pp-plan-checker.md +2 -2
  21. package/agents/pp-planner.md +6 -6
  22. package/agents/pp-project-researcher.md +3 -3
  23. package/agents/pp-research-synthesizer.md +2 -2
  24. package/agents/pp-roadmapper.md +2 -2
  25. package/agents/pp-ui-checker.md +1 -1
  26. package/agents/pp-ui-researcher.md +1 -1
  27. package/agents/pp-user-profiler.md +1 -1
  28. package/agents/pp-verifier.md +4 -4
  29. package/bin/install.js +15 -15
  30. package/commands/pp-autonomous.md +3 -3
  31. package/commands/pp-capture.md +1 -1
  32. package/commands/pp-code-review.md +1 -1
  33. package/commands/pp-config.md +4 -4
  34. package/commands/pp-debug.md +1 -1
  35. package/commands/pp-docs-update.md +2 -2
  36. package/commands/pp-execute-phase.md +1 -1
  37. package/commands/pp-explore.md +1 -1
  38. package/commands/pp-forensics.md +2 -2
  39. package/commands/pp-graphify.md +8 -8
  40. package/commands/pp-health.md +1 -1
  41. package/commands/pp-help.md +2 -2
  42. package/commands/pp-import.md +4 -4
  43. package/commands/pp-manager.md +2 -2
  44. package/commands/pp-mempalace-capture.md +2 -2
  45. package/commands/pp-mempalace-recall.md +4 -4
  46. package/commands/pp-mvp-phase.md +2 -2
  47. package/commands/pp-ns-manage.md +4 -4
  48. package/commands/pp-ns-workflow.md +1 -1
  49. package/commands/pp-plan-review-convergence.md +5 -5
  50. package/commands/pp-pr-branch.md +1 -1
  51. package/commands/pp-profile-user.md +1 -1
  52. package/commands/pp-progress.md +5 -5
  53. package/commands/pp-quick.md +5 -5
  54. package/commands/pp-review-backlog.md +2 -2
  55. package/commands/pp-settings.md +2 -2
  56. package/commands/pp-sketch.md +1 -1
  57. package/commands/pp-spike.md +1 -1
  58. package/commands/pp-surface.md +4 -4
  59. package/commands/pp-ultraplan-phase.md +1 -1
  60. package/commands/pp-undo.md +2 -2
  61. package/commands/pp-update.md +4 -4
  62. package/commands/pp-workspace.md +4 -4
  63. package/commands/pp-workstreams.md +8 -8
  64. package/gemini-extension.json +1 -1
  65. package/package.json +1 -1
  66. package/pp-core/references/agent-contracts.md +1 -1
  67. package/pp-core/references/artifact-types.md +2 -2
  68. package/pp-core/references/context-budget.md +2 -2
  69. package/pp-core/references/doc-conflict-engine.md +2 -2
  70. package/pp-core/references/edge-probe.md +2 -2
  71. package/pp-core/references/gates.md +1 -1
  72. package/pp-core/references/git-integration.md +3 -3
  73. package/pp-core/references/model-profiles.md +8 -8
  74. package/pp-core/references/planner-human-verify-mode.md +1 -1
  75. package/pp-core/references/planning-config.md +7 -7
  76. package/pp-core/references/prohibition-probe.md +2 -2
  77. package/pp-core/references/project-skills-discovery.md +1 -1
  78. package/pp-core/references/thinking-models-debug.md +1 -1
  79. package/pp-core/references/thinking-models-execution.md +1 -1
  80. package/pp-core/references/thinking-models-planning.md +1 -1
  81. package/pp-core/references/thinking-models-research.md +1 -1
  82. package/pp-core/references/thinking-models-verification.md +1 -1
  83. package/pp-core/references/ui-brand.md +3 -3
  84. package/pp-core/references/universal-anti-patterns.md +4 -4
  85. package/pp-core/references/workstream-flag.md +8 -8
  86. package/pp-core/templates/README.md +4 -4
  87. package/pp-core/templates/claude-md.md +2 -2
  88. package/pp-core/templates/codebase/architecture.md +2 -2
  89. package/pp-core/templates/codebase/structure.md +1 -1
  90. package/pp-core/templates/copilot-instructions.md +3 -3
  91. package/pp-core/templates/dev-preferences.md +1 -1
  92. package/pp-core/templates/research.md +1 -1
  93. package/pp-core/templates/summary-complex.md +1 -1
  94. package/pp-core/workflows/add-tests.md +2 -2
  95. package/pp-core/workflows/add-todo.md +1 -1
  96. package/pp-core/workflows/ai-integration-phase.md +3 -3
  97. package/pp-core/workflows/audit-milestone.md +1 -1
  98. package/pp-core/workflows/autonomous.md +9 -9
  99. package/pp-core/workflows/debug.md +1 -1
  100. package/pp-core/workflows/diagnose-issues.md +2 -2
  101. package/pp-core/workflows/discuss-phase/modes/chain.md +2 -2
  102. package/pp-core/workflows/discuss-phase-assumptions.md +2 -2
  103. package/pp-core/workflows/do.md +4 -4
  104. package/pp-core/workflows/docs-update.md +5 -5
  105. package/pp-core/workflows/eval-review.md +3 -3
  106. package/pp-core/workflows/execute-phase.md +5 -5
  107. package/pp-core/workflows/execute-plan.md +1 -1
  108. package/pp-core/workflows/explore.md +2 -2
  109. package/pp-core/workflows/extract-learnings.md +1 -1
  110. package/pp-core/workflows/forensics.md +1 -1
  111. package/pp-core/workflows/health.md +2 -2
  112. package/pp-core/workflows/help/modes/brief.md +2 -2
  113. package/pp-core/workflows/help/modes/default.md +7 -7
  114. package/pp-core/workflows/help/modes/full.md +16 -16
  115. package/pp-core/workflows/help.md +1 -1
  116. package/pp-core/workflows/import.md +11 -11
  117. package/pp-core/workflows/inbox.md +4 -4
  118. package/pp-core/workflows/ingest-docs.md +5 -5
  119. package/pp-core/workflows/list-workspaces.md +4 -4
  120. package/pp-core/workflows/manager.md +6 -6
  121. package/pp-core/workflows/map-codebase.md +2 -2
  122. package/pp-core/workflows/mvp-phase.md +12 -12
  123. package/pp-core/workflows/new-milestone.md +9 -9
  124. package/pp-core/workflows/new-project.md +12 -12
  125. package/pp-core/workflows/new-workspace.md +5 -5
  126. package/pp-core/workflows/next.md +4 -4
  127. package/pp-core/workflows/note.md +1 -1
  128. package/pp-core/workflows/plan-phase.md +13 -13
  129. package/pp-core/workflows/plan-review-convergence.md +3 -3
  130. package/pp-core/workflows/plant-seed.md +1 -1
  131. package/pp-core/workflows/pr-branch.md +2 -2
  132. package/pp-core/workflows/profile-user.md +2 -2
  133. package/pp-core/workflows/progress.md +1 -1
  134. package/pp-core/workflows/quick.md +15 -15
  135. package/pp-core/workflows/reapply-patches.md +6 -6
  136. package/pp-core/workflows/remove-workspace.md +1 -1
  137. package/pp-core/workflows/review.md +3 -3
  138. package/pp-core/workflows/scan.md +1 -1
  139. package/pp-core/workflows/secure-phase.md +4 -4
  140. package/pp-core/workflows/session-report.md +1 -1
  141. package/pp-core/workflows/settings-advanced.md +6 -6
  142. package/pp-core/workflows/settings-integrations.md +2 -2
  143. package/pp-core/workflows/settings.md +2 -2
  144. package/pp-core/workflows/ship.md +2 -2
  145. package/pp-core/workflows/sketch-wrap-up.md +2 -2
  146. package/pp-core/workflows/sketch.md +2 -2
  147. package/pp-core/workflows/spec-phase.md +4 -4
  148. package/pp-core/workflows/spike-wrap-up.md +2 -2
  149. package/pp-core/workflows/spike.md +2 -2
  150. package/pp-core/workflows/sync-skills.md +6 -6
  151. package/pp-core/workflows/thread.md +1 -1
  152. package/pp-core/workflows/ui-phase.md +4 -4
  153. package/pp-core/workflows/ui-review.md +4 -4
  154. package/pp-core/workflows/ultraplan-phase.md +6 -6
  155. package/pp-core/workflows/undo.md +6 -6
  156. package/pp-core/workflows/update.md +12 -12
  157. package/pp-core/workflows/validate-phase.md +4 -4
  158. package/pp-core/workflows/verify-work.md +5 -5
@@ -82,7 +82,7 @@ Parse JSON output:
82
82
 
83
83
  ```
84
84
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
85
- GSD Health Check
85
+ pp-core Health Check
86
86
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
87
87
 
88
88
  Status: HEALTHY | DEGRADED | BROKEN
@@ -179,7 +179,7 @@ Report final status.
179
179
  | W008 | warning | config.json: workflow.nyquist_validation absent (defaults to enabled but agents may skip) | Yes |
180
180
  | W009 | warning | Phase has Validation Architecture in RESEARCH.md but no VALIDATION.md | No |
181
181
  | W018 | warning | MILESTONES.md missing entry for archived milestone snapshot | Yes (`--backfill`) |
182
- | W019 | warning | Unrecognized .planning/ root file — not a canonical GSD artifact | No |
182
+ | W019 | warning | Unrecognized .planning/ root file — not a canonical pp-core artifact | No |
183
183
  | I001 | info | Plan without SUMMARY (may be in progress) | No |
184
184
 
185
185
  </error_codes>
@@ -3,7 +3,7 @@ One-liner refresher for returning users. Output ONLY the `<reference>` content b
3
3
  </purpose>
4
4
 
5
5
  <reference>
6
- **GSD — top commands**
6
+ **pp-core — top commands**
7
7
 
8
8
  ```text
9
9
  /pp:new-project Initialize a project (greenfield)
@@ -11,7 +11,7 @@ One-liner refresher for returning users. Output ONLY the `<reference>` content b
11
11
  /pp:plan-phase <N> Create a phase plan
12
12
  /pp:execute-phase <N> Execute a phase
13
13
  /pp:progress Where am I, what's next
14
- /pp:quick Small ad-hoc task with GSD guarantees
14
+ /pp:quick Small ad-hoc task with pp-core guarantees
15
15
  /pp:fast "<task>" Trivial inline task — no subagents
16
16
  /pp:debug "<symptom>" Persistent debug session (survives /clear)
17
17
  /pp:capture Save an idea / todo / note
@@ -1,11 +1,11 @@
1
1
  <purpose>
2
- One-page newcomer-oriented tour of GSD Core. Output ONLY the `<reference>` content below. No additions.
2
+ One-page newcomer-oriented tour of pp-core. Output ONLY the `<reference>` content below. No additions.
3
3
  </purpose>
4
4
 
5
5
  <reference>
6
- # GSD Core — Git. Ship. Done.
6
+ # pp-core — The Pareto delivery framework.
7
7
 
8
- Plan-driven development for solo agentic work with Claude Code. GSD Core turns a vague idea into a hierarchical plan, then executes it phase by phase with state tracking and atomic commits.
8
+ Plan-driven development for solo agentic work with Claude Code. pp-core turns a vague idea into a hierarchical plan, then executes it phase by phase with state tracking and atomic commits.
9
9
 
10
10
  ## Start here (3 commands)
11
11
 
@@ -15,14 +15,14 @@ Plan-driven development for solo agentic work with Claude Code. GSD Core turns a
15
15
  /pp:execute-phase 1 # Execute all plans in the phase
16
16
  ```
17
17
 
18
- Existing codebase? Run `/pp:map-codebase` first to ground GSD in your code.
18
+ Existing codebase? Run `/pp:map-codebase` first to ground pp-core in your code.
19
19
 
20
20
  ## Common commands
21
21
 
22
22
  | Command | Purpose |
23
23
  |---|---|
24
24
  | `/pp:progress` | Where am I, what's next — also routes freeform intent with `--do "..."` |
25
- | `/pp:quick` | Small ad-hoc task with GSD guarantees (planning dir + atomic commit) |
25
+ | `/pp:quick` | Small ad-hoc task with pp-core guarantees (planning dir + atomic commit) |
26
26
  | `/pp:fast "<task>"` | Trivial inline change — no subagents, ≤3 file edits |
27
27
  | `/pp:discuss-phase <N>` | Capture vision and decisions before planning |
28
28
  | `/pp:debug "<symptom>"` | Persistent debug session, survives `/clear` |
@@ -42,9 +42,9 @@ Existing codebase? Run `/pp:map-codebase` first to ground GSD in your code.
42
42
 
43
43
  Topics: `workflow` · `planning` · `execute` · `quick` · `debug` · `capture` · `ship` · `config` · `milestones` · `spike` · `sketch` · `review` · `audit` · `progress`
44
44
 
45
- ## Update GSD
45
+ ## Update pp-core
46
46
 
47
47
  ```bash
48
- npx @opengsd/pp-core@latest
48
+ npx @pareto4/pp-core@latest
49
49
  ```
50
50
  </reference>
@@ -1,11 +1,11 @@
1
1
  <purpose>
2
- Display the complete GSD Core command reference. Output ONLY the reference content. Do NOT add project-specific analysis, git status, next-step suggestions, or any commentary beyond the reference.
2
+ Display the complete pp-core command reference. Output ONLY the reference content. Do NOT add project-specific analysis, git status, next-step suggestions, or any commentary beyond the reference.
3
3
  </purpose>
4
4
 
5
5
  <reference>
6
- # GSD Core Command Reference
6
+ # pp-core Command Reference
7
7
 
8
- **GSD Core** (Git. Ship. Done.) creates hierarchical project plans optimized for solo agentic development with Claude Code.
8
+ **pp-core** (The Pareto delivery framework.) creates hierarchical project plans optimized for solo agentic development with Claude Code.
9
9
 
10
10
  ## Quick Start
11
11
 
@@ -15,10 +15,10 @@ Display the complete GSD Core command reference. Output ONLY the reference conte
15
15
 
16
16
  ## Staying Updated
17
17
 
18
- GSD evolves fast. Update periodically:
18
+ pp-core evolves fast. Update periodically:
19
19
 
20
20
  ```bash
21
- npx @opengsd/pp-core@latest
21
+ npx @pareto4/pp-core@latest
22
22
  ```
23
23
 
24
24
  ## Core Workflow
@@ -128,9 +128,9 @@ Usage: `/pp:execute-phase 5 --wave 2`
128
128
  ### Smart Router
129
129
 
130
130
  **`/pp:progress --do "<description>"`**
131
- Route freeform text to the right GSD command automatically.
131
+ Route freeform text to the right pp-core command automatically.
132
132
 
133
- - Analyzes natural language input to find the best matching GSD command
133
+ - Analyzes natural language input to find the best matching pp-core command
134
134
  - Acts as a dispatcher — never does the work itself
135
135
  - Resolves ambiguity by asking you to pick between top matches
136
136
  - Use when you know what you want but don't know which `/pp-*` command to run
@@ -142,7 +142,7 @@ Usage: `/pp:progress --do "I want to start a new milestone"`
142
142
  ### Quick Mode
143
143
 
144
144
  **`/pp:quick [--full] [--validate] [--discuss] [--research]`**
145
- Execute small, ad-hoc tasks with GSD guarantees but skip optional agents.
145
+ Execute small, ad-hoc tasks with pp-core guarantees but skip optional agents.
146
146
 
147
147
  Quick mode uses the same system with a shorter path:
148
148
  - Spawns planner + executor (skips researcher, checker, verifier by default)
@@ -440,7 +440,7 @@ Create a clean branch for pull requests by filtering out .planning/ commits.
440
440
 
441
441
  - Classifies commits: code-only (include), planning-only (exclude), mixed (include sans .planning/)
442
442
  - Cherry-picks code commits onto a clean branch
443
- - Reviewers see only code changes, no GSD artifacts
443
+ - Reviewers see only code changes, no pp-core artifacts
444
444
 
445
445
  Usage: `/pp:pr-branch` or `/pp:pr-branch main`
446
446
 
@@ -499,7 +499,7 @@ Configure workflow toggles and model profile interactively.
499
499
  Usage: `/pp:settings`
500
500
 
501
501
  **`/pp:config [--profile <profile> | --advanced | --integrations]`**
502
- Configure GSD beyond the basic settings: model profile, advanced tuning, and third-party integrations.
502
+ Configure pp-core beyond the basic settings: model profile, advanced tuning, and third-party integrations.
503
503
 
504
504
  - `--profile <profile>` — quick switch model profile (`quality | balanced | budget | inherit`)
505
505
  - `--advanced` — power-user tuning: plan bounce, timeouts, branch templates, cross-AI execution (replaces the former `pp-settings-advanced`)
@@ -538,7 +538,7 @@ Archive accumulated phase directories from completed milestones.
538
538
  Usage: `/pp:cleanup`
539
539
 
540
540
  **`/pp:help [--brief | --full | <topic> | --brief <topic>]`**
541
- Show GSD command help at the tier you ask for.
541
+ Show pp-core command help at the tier you ask for.
542
542
 
543
543
  - `--brief` — one-liner refresher of the top commands (~10 lines)
544
544
  - *(no flag)* — one-page newcomer tour (default)
@@ -555,9 +555,9 @@ Usage: `/pp:help debug`
555
555
  Usage: `/pp:help --brief debug`
556
556
 
557
557
  **`/pp:update [--sync] [--reapply] [--next | --rc]`**
558
- Update GSD to latest version with changelog preview.
558
+ Update pp-core to latest version with changelog preview.
559
559
 
560
- - `--sync` — sync managed GSD skills across runtime roots (replaces the former `pp-sync-skills`)
560
+ - `--sync` — sync managed pp-core skills across runtime roots (replaces the former `pp-sync-skills`)
561
561
  - `--reapply` — reapply local modifications after an update (replaces the former `pp-reapply-patches`)
562
562
  - `--next` (alias `--rc`) — install/refresh from the `@next` RC dist-tag instead of `@latest` (ADR #660); omit for the stable channel
563
563
 
@@ -565,7 +565,7 @@ Update GSD to latest version with changelog preview.
565
565
  - Displays changelog entries for versions you've missed
566
566
  - Highlights breaking changes
567
567
  - Confirms before running install
568
- - Better than raw `npx @opengsd/pp-core`
568
+ - Better than raw `npx @pareto4/pp-core`
569
569
 
570
570
  Usage: `/pp:update`
571
571
 
@@ -602,7 +602,7 @@ The commands above cover the most common day-to-day flows. Every command listed
602
602
  ### Diagnostics & Maintenance
603
603
 
604
604
  - **`/pp:health [--repair] [--context]`** — Diagnose planning directory health and optionally repair issues.
605
- - **`/pp:forensics [problem description]`** — Post-mortem investigation for failed GSD workflows; diagnoses what went wrong.
605
+ - **`/pp:forensics [problem description]`** — Post-mortem investigation for failed pp-core workflows; diagnoses what went wrong.
606
606
  - **`/pp:undo --last N | --phase NN | --plan NN-MM`** — Safe git revert. Roll back phase or plan commits using the phase manifest with dependency checks.
607
607
  - **`/pp:docs-update [--force] [--verify-only]`** — Generate or update project documentation verified against the codebase.
608
608
  - **`/pp:extract-learnings <phase>`** — Extract decisions, lessons, patterns, and surprises from completed phase artifacts.
@@ -619,7 +619,7 @@ The commands above cover the most common day-to-day flows. Every command listed
619
619
  ### Workflow & Orchestration
620
620
 
621
621
  - **`/pp:manager [--analyze-deps]`** — Interactive command center for managing multiple phases from one terminal. `--analyze-deps` scans ROADMAP phases for dependency relationships before parallel execution.
622
- - **`/pp:workspace [--new | --list | --remove] [name]`** — Manage GSD workspaces: create, list, or remove isolated workspace environments.
622
+ - **`/pp:workspace [--new | --list | --remove] [name]`** — Manage pp-core workspaces: create, list, or remove isolated workspace environments.
623
623
  - **`/pp:workstreams`** — Manage parallel workstreams: list, create, switch, status, progress, complete, and resume.
624
624
  - **`/pp:review-backlog`** — Review and promote backlog items to active milestone.
625
625
  - **`/pp:milestone-summary [version]`** — Generate a comprehensive project summary from milestone artifacts for team onboarding and review.
@@ -1,5 +1,5 @@
1
1
  <purpose>
2
- Display GSD command help at the tier the user asked for. Output ONLY the reference content of the chosen mode. Do NOT add project-specific analysis, git status, next-step suggestions, or any commentary beyond the reference.
2
+ Display pp-core command help at the tier the user asked for. Output ONLY the reference content of the chosen mode. Do NOT add project-specific analysis, git status, next-step suggestions, or any commentary beyond the reference.
3
3
  </purpose>
4
4
 
5
5
  <progressive_disclosure>
@@ -14,7 +14,7 @@ Display the stage banner:
14
14
 
15
15
  ```
16
16
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
17
- GSD ► IMPORT
17
+ pp-core ► IMPORT
18
18
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
19
19
  ```
20
20
 
@@ -27,14 +27,14 @@ Parse `$ARGUMENTS` to determine the execution mode:
27
27
  - If `--from` is present: extract FILEPATH (the next token after `--from`), set MODE=plan
28
28
  - If `--prd` is present: display message that `--prd` is not yet implemented and exit:
29
29
  ```
30
- GSD > --prd mode is planned for a future release. Use --from to import plan files.
30
+ pp-core > --prd mode is planned for a future release. Use --from to import plan files.
31
31
  ```
32
32
  - If neither flag is found: display usage and exit:
33
33
 
34
34
  ```
35
35
  Usage: /pp:import --from <path>
36
36
 
37
- --from <path> Import an external plan file into GSD format
37
+ --from <path> Import an external plan file into pp-core format
38
38
  ```
39
39
 
40
40
  **Validate the file path:**
@@ -74,7 +74,7 @@ Load project context for conflict detection:
74
74
  2. Read `.planning/PROJECT.md` — extract project constraints, tech stack, scope boundaries.
75
75
  **If PROJECT.md does not exist:** skip constraint checks that rely on it and display:
76
76
  ```
77
- GSD > Note: No PROJECT.md found. Conflict checks against project constraints will be skipped.
77
+ pp-core > Note: No PROJECT.md found. Conflict checks against project constraints will be skipped.
78
78
  ```
79
79
  3. Read `.planning/REQUIREMENTS.md` — extract existing requirements for overlap and contradiction checks.
80
80
  **If REQUIREMENTS.md does not exist:** skip requirement conflict checks and continue.
@@ -93,7 +93,7 @@ Store loaded context for conflict detection in the next step.
93
93
  Read the imported file at FILEPATH.
94
94
 
95
95
  Determine the format:
96
- - **GSD PLAN.md format**: Has YAML frontmatter with `phase:`, `plan:`, `type:` fields
96
+ - **pp-core PLAN.md format**: Has YAML frontmatter with `phase:`, `plan:`, `type:` fields
97
97
  - **Freeform document**: Any other format (markdown spec, design doc, task list, etc.)
98
98
 
99
99
  Extract from the imported content:
@@ -147,7 +147,7 @@ If user selects "Abort": exit cleanly with message "Import cancelled."
147
147
 
148
148
  <step name="plan_convert">
149
149
 
150
- Convert the imported content to GSD PLAN.md format.
150
+ Convert the imported content to pp-core PLAN.md format.
151
151
 
152
152
  Ensure the PLAN.md has all required frontmatter fields:
153
153
  ```yaml
@@ -166,9 +166,9 @@ must_haves:
166
166
  ```
167
167
 
168
168
  **Reject PBR naming conventions in source content:**
169
- If the imported plan references PBR plan naming (e.g., `PLAN-01.md`, `plan-01.md`), rename all references to GSD `{NN}-{MM}-PLAN.md` convention during conversion.
169
+ If the imported plan references PBR plan naming (e.g., `PLAN-01.md`, `plan-01.md`), rename all references to pp-core `{NN}-{MM}-PLAN.md` convention during conversion.
170
170
 
171
- Apply GSD naming convention for the output filename:
171
+ Apply pp-core naming convention for the output filename:
172
172
  - Format: `{NN}-{MM}-PLAN.md` (e.g., `04-01-PLAN.md`)
173
173
  - NEVER use `PLAN-01.md`, `plan-01.md`, or any other format
174
174
  - NN = phase number (zero-padded), MM = plan number within the phase (zero-padded)
@@ -202,7 +202,7 @@ Print: "Delegating to pp-plan-checker (runs in a subagent — no output until it
202
202
  ```
203
203
  Agent({
204
204
  subagent_type: "pp-plan-checker",
205
- prompt: "Validate: .planning/phases/{phase}/{plan}-PLAN.md — check frontmatter completeness, task structure, and GSD conventions. Report any issues."
205
+ prompt: "Validate: .planning/phases/{phase}/{plan}-PLAN.md — check frontmatter completeness, task structure, and pp-core conventions. Report any issues."
206
206
  })
207
207
  ```
208
208
 
@@ -234,7 +234,7 @@ pp_run query commit "docs({phase}): import plan from {basename FILEPATH}" --file
234
234
  Display completion:
235
235
  ```
236
236
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
237
- GSD ► IMPORT COMPLETE
237
+ pp-core ► IMPORT COMPLETE
238
238
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
239
239
  ```
240
240
 
@@ -250,7 +250,7 @@ Do NOT:
250
250
  - Violate the shared conflict-engine contract in `references/doc-conflict-engine.md` (no markdown tables, no new severity labels, no bypass of the BLOCKER gate)
251
251
  - Write PLAN.md files as `PLAN-01.md` or `plan-01.md` — always use `{NN}-{MM}-PLAN.md`
252
252
  - Use `pbr:plan-checker` or `pbr:planner` — use `pp-plan-checker` and `pp-planner`
253
- - Write `.planning/.active-skill` — this is a PBR pattern with no GSD equivalent
253
+ - Write `.planning/.active-skill` — this is a PBR pattern with no pp-core equivalent
254
254
  - Reference `pbr-tools`, `pbr:`, or `PLAN-BUILD-RUN` anywhere
255
255
  - Write any PLAN.md file when blockers exist — the safety gate must hold
256
256
  - Skip path validation on the --from file argument
@@ -103,7 +103,7 @@ For each classified issue, review against its template requirements.
103
103
  - **Gate check:** If PR exists linking this issue, does issue have `approved-enhancement`?
104
104
 
105
105
  **Bug Report Review Checklist:**
106
- - [ ] GSD Version provided
106
+ - [ ] pp-core Version provided
107
107
  - [ ] Runtime selected
108
108
  - [ ] OS selected
109
109
  - [ ] Node.js version provided
@@ -239,7 +239,7 @@ Produce a structured triage report:
239
239
 
240
240
  ```
241
241
  ===================================================================
242
- GSD INBOX TRIAGE — {repo} — {date}
242
+ pp-core INBOX TRIAGE — {repo} — {date}
243
243
  ===================================================================
244
244
 
245
245
  SUMMARY
@@ -317,12 +317,12 @@ Label recommendations:
317
317
  **If --close-incomplete:**
318
318
  For issues scoring below 50% completeness:
319
319
  ```bash
320
- gh issue close {number} --comment "Closed by GSD inbox triage: this issue is missing required fields per the issue template. Missing: {list}. Please reopen with a complete submission. See CONTRIBUTING.md for requirements."
320
+ gh issue close {number} --comment "Closed by pp-core inbox triage: this issue is missing required fields per the issue template. Missing: {list}. Please reopen with a complete submission. See CONTRIBUTING.md for requirements."
321
321
  ```
322
322
 
323
323
  For PRs with gate violations:
324
324
  ```bash
325
- gh pr close {number} --comment "Closed by GSD inbox triage: this PR does not meet the issue-first requirement. {specific violation}. See CONTRIBUTING.md for the correct process."
325
+ gh pr close {number} --comment "Closed by pp-core inbox triage: this PR does not meet the issue-first requirement. {specific violation}. See CONTRIBUTING.md for the correct process."
326
326
  ```
327
327
 
328
328
  Always confirm with the user before closing anything:
@@ -15,7 +15,7 @@ Display the stage banner:
15
15
 
16
16
  ```
17
17
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
18
- GSD ► INGEST DOCS
18
+ pp-core ► INGEST DOCS
19
19
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
20
20
  ```
21
21
 
@@ -127,7 +127,7 @@ De-duplicate the union (a file matched by multiple patterns is one doc).
127
127
  **Cap:** hard limit of 50 docs per invocation (documented v1 constraint). If the discovered set exceeds 50:
128
128
 
129
129
  ```
130
- GSD > Discovered {N} docs, which exceeds the v1 cap of 50.
130
+ pp-core > Discovered {N} docs, which exceeds the v1 cap of 50.
131
131
  Use --manifest to narrow the set to ≤ 50 files, or run
132
132
  /pp:ingest-docs again with a narrower <path>.
133
133
  ```
@@ -222,7 +222,7 @@ Apply the safety semantics from `references/doc-conflict-engine.md`. Operation n
222
222
  Render the report to the user, then display:
223
223
 
224
224
  ```
225
- GSD > BLOCKED: {N} blockers must be resolved before ingest can proceed.
225
+ pp-core > BLOCKED: {N} blockers must be resolved before ingest can proceed.
226
226
  ```
227
227
 
228
228
  Exit WITHOUT writing PROJECT.md, REQUIREMENTS.md, ROADMAP.md, or STATE.md. The staging intel files remain for inspection. The safety gate holds — no destination files are written when blockers exist.
@@ -238,7 +238,7 @@ On Abort: exit cleanly with "Ingest cancelled. Staged intel preserved at `.plann
238
238
 
239
239
  **If BLOCKERS = 0 and WARNINGS = 0:**
240
240
 
241
- Proceed to routing silently, or optionally display `GSD > No conflicts. Auto-resolved: {N}.`
241
+ Proceed to routing silently, or optionally display `pp-core > No conflicts. Auto-resolved: {N}.`
242
242
 
243
243
  </step>
244
244
 
@@ -312,7 +312,7 @@ Display completion:
312
312
 
313
313
  ```
314
314
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
315
- GSD ► INGEST DOCS COMPLETE
315
+ pp-core ► INGEST DOCS COMPLETE
316
316
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
317
317
  ```
318
318
 
@@ -1,5 +1,5 @@
1
1
  <purpose>
2
- List all GSD workspaces found in ~/pp-workspaces/ with their status.
2
+ List all pp-core workspaces found in ~/pp-workspaces/ with their status.
3
3
  </purpose>
4
4
 
5
5
  <required_reading>
@@ -36,9 +36,9 @@ Done.
36
36
  Display a table:
37
37
 
38
38
  ```
39
- GSD Workspaces (~/pp-workspaces/)
39
+ pp-core Workspaces (~/pp-workspaces/)
40
40
 
41
- | Name | Repos | Strategy | GSD Project |
41
+ | Name | Repos | Strategy | pp-core Project |
42
42
  |------|-------|----------|-------------|
43
43
  | feature-a | 3 | worktree | Yes |
44
44
  | feature-b | 2 | clone | No |
@@ -52,6 +52,6 @@ For each workspace, show:
52
52
  - **Name** — directory name
53
53
  - **Repos** — count from init data
54
54
  - **Strategy** — from WORKSPACE.md
55
- - **GSD Project** — whether `.planning/PROJECT.md` exists (Yes/No)
55
+ - **pp-core Project** — whether `.planning/PROJECT.md` exists (Yes/No)
56
56
 
57
57
  </process>
@@ -39,7 +39,7 @@ Display startup banner:
39
39
 
40
40
  ```
41
41
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
42
- GSD ► MANAGER
42
+ pp-core ► MANAGER
43
43
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
44
44
 
45
45
  {milestone_version} — {milestone_name}
@@ -90,7 +90,7 @@ Example output:
90
90
 
91
91
  ```
92
92
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
93
- GSD ► DASHBOARD
93
+ pp-core ► DASHBOARD
94
94
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
95
95
  ████████████░░░░░░░░ 60% (3/5 phases)
96
96
  ◆ Background: Planning Phase 4
@@ -193,7 +193,7 @@ Continue:
193
193
  → Discuss Phase 35 (inline)
194
194
  ```
195
195
 
196
- **Auto-refresh:** If background agents are running (`is_active` is true for any phase), set a 60-second auto-refresh cycle. After presenting the action menu, if no user input is received within 60 seconds, automatically refresh the dashboard. This interval is configurable via `manager_refresh_interval` in GSD config (default: 60 seconds, set to 0 to disable).
196
+ **Auto-refresh:** If background agents are running (`is_active` is true for any phase), set a 60-second auto-refresh cycle. After presenting the action menu, if no user input is received within 60 seconds, automatically refresh the dashboard. This interval is configurable via `manager_refresh_interval` in pp-core config (default: 60 seconds, set to 0 to disable).
197
197
 
198
198
  Present via AskUserQuestion:
199
199
  - **question:** "What would you like to do?"
@@ -270,7 +270,7 @@ Then loop back to dashboard step.
270
270
  Agent(
271
271
  description="Plan phase {N}: {phase_name}",
272
272
  run_in_background=true,
273
- prompt="You are running the GSD plan-phase workflow for phase {N} of the project.
273
+ prompt="You are running the pp-core plan-phase workflow for phase {N} of the project.
274
274
 
275
275
  Working directory: {cwd}
276
276
  Phase: {N} — {phase_name}
@@ -324,7 +324,7 @@ Then loop back to dashboard step.
324
324
  Agent(
325
325
  description="Execute phase {N}: {phase_name}",
326
326
  run_in_background=true,
327
- prompt="You are running the GSD execute-phase workflow for phase {N} of the project.
327
+ prompt="You are running the pp-core execute-phase workflow for phase {N} of the project.
328
328
 
329
329
  Working directory: {cwd}
330
330
  Phase: {N} — {phase_name}
@@ -400,7 +400,7 @@ Display final status with progress bar:
400
400
 
401
401
  ```
402
402
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
403
- GSD ► SESSION END
403
+ pp-core ► SESSION END
404
404
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
405
405
 
406
406
  {milestone_version} — {milestone_name}
@@ -7,7 +7,7 @@ Output: .planning/codebase/ folder with 7 structured documents about the codebas
7
7
  </purpose>
8
8
 
9
9
  <available_agent_types>
10
- Valid GSD subagent types (use exact names — do not fall back to 'general-purpose'):
10
+ Valid pp-core subagent types (use exact names — do not fall back to 'general-purpose'):
11
11
  - pp-codebase-mapper — Maps project structure and dependencies
12
12
  </available_agent_types>
13
13
 
@@ -440,5 +440,5 @@ End workflow.
440
440
  - All 7 codebase documents exist
441
441
  - No empty documents (each should have >20 lines)
442
442
  - Clear completion summary with line counts
443
- - User offered clear next steps in GSD style
443
+ - User offered clear next steps in pp-core style
444
444
  </success_criteria>
@@ -1,5 +1,5 @@
1
1
  <purpose>
2
- Guide the user through MVP-mode planning for a phase. Prompts for an "As a / I want to / So that" user story, runs SPIDR splitting check on the story, writes the result to ROADMAP.md, and delegates to `/gsd plan-phase` (which auto-detects MVP via the roadmap mode field shipped in PRD Phase 1).
2
+ Guide the user through MVP-mode planning for a phase. Prompts for an "As a / I want to / So that" user story, runs SPIDR splitting check on the story, writes the result to ROADMAP.md, and delegates to `/pp:plan-phase` (which auto-detects MVP via the roadmap mode field shipped in PRD Phase 1).
3
3
  </purpose>
4
4
 
5
5
  <required_reading>
@@ -23,9 +23,9 @@ Extract the phase number from `$ARGUMENTS` (integer or decimal like `2.1`). Opti
23
23
  If no argument:
24
24
  ```
25
25
  ERROR: Phase number required
26
- Usage: /gsd mvp-phase <phase-number>
27
- Example: /gsd mvp-phase 1
28
- Example: /gsd mvp-phase 2.1
26
+ Usage: /pp:mvp-phase <phase-number>
27
+ Example: /pp:mvp-phase 1
28
+ Example: /pp:mvp-phase 2.1
29
29
  ```
30
30
  Exit.
31
31
 
@@ -54,7 +54,7 @@ else
54
54
  fi
55
55
  ```
56
56
 
57
- If `PHASE_FOUND` is `false`: error and exit. Suggest `/gsd add-phase` or `/gsd insert-phase` to create the phase first.
57
+ If `PHASE_FOUND` is `false`: error and exit. Suggest `/pp:phase` or `/pp:phase` to create the phase first.
58
58
 
59
59
  **Status guard.** If the phase is `in_progress` (has plans but not complete) or `completed`, refuse unless `--force` is in `$ARGUMENTS`:
60
60
 
@@ -63,7 +63,7 @@ ERROR: Phase ${PHASE} is currently ${STATUS}.
63
63
  Converting an active or completed phase to MVP mode mid-flight will
64
64
  invalidate any existing plans and summaries.
65
65
 
66
- To proceed anyway: /gsd mvp-phase ${PHASE} --force
66
+ To proceed anyway: /pp:mvp-phase ${PHASE} --force
67
67
  ```
68
68
 
69
69
  **Already-MVP guard.** If `PHASE_MODE` is already `mvp`, surface this and ask whether to re-prompt the user story or abort:
@@ -155,7 +155,7 @@ d) Produce a split proposal. Example:
155
155
 
156
156
  Use `AskUserQuestion` [Accept / Modify / Reject].
157
157
 
158
- - **Accept**: `USER_STORY` becomes the first split's story (`${HAPPY_STORY}` in the example). Surface the remaining splits as a list of `/gsd add-phase` invocations the user can run after this command completes — do NOT auto-create the new phases (preserve user control over numbering).
158
+ - **Accept**: `USER_STORY` becomes the first split's story (`${HAPPY_STORY}` in the example). Surface the remaining splits as a list of `/pp:phase` invocations the user can run after this command completes — do NOT auto-create the new phases (preserve user control over numbering).
159
159
  - **Modify**: re-prompt the splits one more time, then accept or reject.
160
160
  - **Reject**: revert `USER_STORY` to the original, proceed without splitting.
161
161
 
@@ -194,9 +194,9 @@ Assert:
194
194
 
195
195
  If either assertion fails, surface the discrepancy to the user and exit. Do not proceed to plan-phase delegation with a half-applied write.
196
196
 
197
- ## 7. Delegate to /gsd plan-phase
197
+ ## 7. Delegate to /pp:plan-phase
198
198
 
199
- Invoke `/gsd plan-phase ${PHASE}` (no flags). Phase 1's MVP_MODE resolution chain (CLI flag → roadmap mode → config → false) will detect the new `**Mode:** mvp` line and run plan-phase in vertical-slice mode automatically.
199
+ Invoke `/pp:plan-phase ${PHASE}` (no flags). Phase 1's MVP_MODE resolution chain (CLI flag → roadmap mode → config → false) will detect the new `**Mode:** mvp` line and run plan-phase in vertical-slice mode automatically.
200
200
 
201
201
  The Walking Skeleton gate (also from Phase 1) will fire automatically if `${PHASE} == "01"` and there are zero prior phase summaries.
202
202
 
@@ -209,11 +209,11 @@ If SPIDR produced a split in step 4, append a final user-facing message:
209
209
  > Your original story was split. The first slice is now planned via plan-phase.
210
210
  > To create the remaining slice(s) as new phases, run:
211
211
  >
212
- > - `/gsd add-phase` — for the next slice: «${SPLIT_2_STORY}»
213
- > - `/gsd add-phase` — for the next slice: «${SPLIT_3_STORY}»
212
+ > - `/pp:phase` — for the next slice: «${SPLIT_2_STORY}»
213
+ > - `/pp:phase` — for the next slice: «${SPLIT_3_STORY}»
214
214
  >
215
215
  > Each will be added to the end of the current milestone. You can then run
216
- > `/gsd mvp-phase <new-phase-number>` on each to plan them as MVP slices."
216
+ > `/pp:mvp-phase <new-phase-number>` on each to plan them as MVP slices."
217
217
 
218
218
  ## 9. Exit
219
219
 
@@ -11,7 +11,7 @@ Read all files referenced by the invoking prompt's execution_context before star
11
11
  </required_reading>
12
12
 
13
13
  <available_agent_types>
14
- Valid GSD subagent types (use exact names — do not fall back to 'general-purpose'):
14
+ Valid pp-core subagent types (use exact names — do not fall back to 'general-purpose'):
15
15
  - pp-project-researcher — Researches project-level technical decisions
16
16
  - pp-research-synthesizer — Synthesizes findings from parallel research agents
17
17
  - pp-roadmapper — Creates phased execution roadmaps
@@ -107,7 +107,7 @@ Before writing any files, present a summary of what was gathered and ask for con
107
107
 
108
108
  ```
109
109
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
110
- GSD ► MILESTONE SUMMARY
110
+ pp-core ► MILESTONE SUMMARY
111
111
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
112
112
 
113
113
  **Milestone v[X.Y]: [Name]**
@@ -230,13 +230,13 @@ Extract from init JSON: `researcher_model`, `synthesizer_model`, `roadmapper_mod
230
230
 
231
231
  **If `agents_installed` is false:** Display a warning before proceeding:
232
232
  ```
233
- ⚠ GSD agents not installed. The following agents are missing from your agents directory:
233
+ ⚠ pp-core agents not installed. The following agents are missing from your agents directory:
234
234
  {missing_agents joined with newline}
235
235
 
236
236
  Subagent spawns (pp-project-researcher, pp-research-synthesizer, pp-roadmapper) will fail
237
237
  with "agent type not found". Run the installer with --global to make agents available:
238
238
 
239
- npx @opengsd/pp-core@latest --global
239
+ npx @pareto4/pp-core@latest --global
240
240
 
241
241
  Proceeding without research subagents — roadmap will be generated inline.
242
242
  ```
@@ -284,7 +284,7 @@ AskUserQuestion: "Research the domain ecosystem for new features before defining
284
284
 
285
285
  ```
286
286
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
287
- GSD ► RESEARCHING
287
+ pp-core ► RESEARCHING
288
288
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
289
289
 
290
290
  ◆ Spawning 4 researchers in parallel... (each runs in a subagent — no output until they return, ~1–5 min; expected, not a freeze)
@@ -373,7 +373,7 @@ This guarantees `pp-roadmapper` (which lists SUMMARY.md as required reading) nev
373
373
  Display key findings from SUMMARY.md:
374
374
  ```
375
375
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
376
- GSD ► RESEARCH COMPLETE ✓
376
+ pp-core ► RESEARCH COMPLETE ✓
377
377
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
378
378
 
379
379
  **Stack additions:** [from SUMMARY.md]
@@ -387,7 +387,7 @@ Display key findings from SUMMARY.md:
387
387
 
388
388
  ```
389
389
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
390
- GSD ► DEFINING REQUIREMENTS
390
+ pp-core ► DEFINING REQUIREMENTS
391
391
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
392
392
  ```
393
393
 
@@ -460,7 +460,7 @@ pp_run query commit "docs: define milestone v[X.Y] requirements" --files .planni
460
460
 
461
461
  ```
462
462
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
463
- GSD ► CREATING ROADMAP
463
+ pp-core ► CREATING ROADMAP
464
464
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
465
465
 
466
466
  ◆ Spawning roadmapper... (runs in a subagent — no output until it returns, ~1–5 min; expected, not a freeze)
@@ -596,7 +596,7 @@ Print a summary:
596
596
 
597
597
  ```
598
598
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
599
- GSD ► MILESTONE INITIALIZED ✓
599
+ pp-core ► MILESTONE INITIALIZED ✓
600
600
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
601
601
 
602
602
  **Milestone v[X.Y]: [Name]**