@pareto4/pp-core 1.5.1 → 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.
- package/.claude-plugin/plugin.json +1 -1
- package/agents/pp-advisor-researcher.md +1 -1
- package/agents/pp-ai-researcher.md +1 -1
- package/agents/pp-assumptions-analyzer.md +1 -1
- package/agents/pp-code-fixer.md +2 -2
- package/agents/pp-codebase-mapper.md +2 -2
- package/agents/pp-debug-session-manager.md +1 -1
- package/agents/pp-debugger.md +2 -2
- package/agents/pp-doc-classifier.md +1 -1
- package/agents/pp-doc-synthesizer.md +1 -1
- package/agents/pp-doc-verifier.md +1 -1
- package/agents/pp-doc-writer.md +12 -12
- package/agents/pp-domain-researcher.md +1 -1
- package/agents/pp-eval-planner.md +1 -1
- package/agents/pp-executor.md +4 -4
- package/agents/pp-framework-selector.md +1 -1
- package/agents/pp-intel-updater.md +13 -13
- package/agents/pp-pattern-mapper.md +1 -1
- package/agents/pp-phase-researcher.md +4 -4
- package/agents/pp-plan-checker.md +2 -2
- package/agents/pp-planner.md +6 -6
- package/agents/pp-project-researcher.md +3 -3
- package/agents/pp-research-synthesizer.md +2 -2
- package/agents/pp-roadmapper.md +2 -2
- package/agents/pp-ui-checker.md +1 -1
- package/agents/pp-ui-researcher.md +1 -1
- package/agents/pp-user-profiler.md +1 -1
- package/agents/pp-verifier.md +4 -4
- package/bin/install.js +47 -23
- package/commands/pp-autonomous.md +3 -3
- package/commands/pp-capture.md +1 -1
- package/commands/pp-code-review.md +1 -1
- package/commands/pp-config.md +4 -4
- package/commands/pp-debug.md +1 -1
- package/commands/pp-docs-update.md +2 -2
- package/commands/pp-execute-phase.md +1 -1
- package/commands/pp-explore.md +1 -1
- package/commands/pp-forensics.md +2 -2
- package/commands/pp-graphify.md +8 -8
- package/commands/pp-health.md +1 -1
- package/commands/pp-help.md +2 -2
- package/commands/pp-import.md +4 -4
- package/commands/pp-manager.md +2 -2
- package/commands/pp-mempalace-capture.md +2 -2
- package/commands/pp-mempalace-recall.md +4 -4
- package/commands/pp-mvp-phase.md +2 -2
- package/commands/pp-ns-manage.md +4 -4
- package/commands/pp-ns-workflow.md +1 -1
- package/commands/pp-plan-review-convergence.md +5 -5
- package/commands/pp-pr-branch.md +1 -1
- package/commands/pp-profile-user.md +1 -1
- package/commands/pp-progress.md +5 -5
- package/commands/pp-quick.md +5 -5
- package/commands/pp-review-backlog.md +2 -2
- package/commands/pp-settings.md +2 -2
- package/commands/pp-sketch.md +1 -1
- package/commands/pp-spike.md +1 -1
- package/commands/pp-surface.md +4 -4
- package/commands/pp-ultraplan-phase.md +1 -1
- package/commands/pp-undo.md +2 -2
- package/commands/pp-update.md +4 -4
- package/commands/pp-workspace.md +4 -4
- package/commands/pp-workstreams.md +8 -8
- package/gemini-extension.json +1 -1
- package/package.json +1 -1
- package/pp-core/references/agent-contracts.md +1 -1
- package/pp-core/references/artifact-types.md +2 -2
- package/pp-core/references/context-budget.md +2 -2
- package/pp-core/references/doc-conflict-engine.md +2 -2
- package/pp-core/references/edge-probe.md +2 -2
- package/pp-core/references/gates.md +1 -1
- package/pp-core/references/git-integration.md +3 -3
- package/pp-core/references/model-profiles.md +8 -8
- package/pp-core/references/planner-human-verify-mode.md +1 -1
- package/pp-core/references/planning-config.md +7 -7
- package/pp-core/references/prohibition-probe.md +2 -2
- package/pp-core/references/project-skills-discovery.md +1 -1
- package/pp-core/references/thinking-models-debug.md +1 -1
- package/pp-core/references/thinking-models-execution.md +1 -1
- package/pp-core/references/thinking-models-planning.md +1 -1
- package/pp-core/references/thinking-models-research.md +1 -1
- package/pp-core/references/thinking-models-verification.md +1 -1
- package/pp-core/references/ui-brand.md +3 -3
- package/pp-core/references/universal-anti-patterns.md +4 -4
- package/pp-core/references/workstream-flag.md +8 -8
- package/pp-core/templates/README.md +4 -4
- package/pp-core/templates/claude-md.md +2 -2
- package/pp-core/templates/codebase/architecture.md +2 -2
- package/pp-core/templates/codebase/structure.md +1 -1
- package/pp-core/templates/copilot-instructions.md +3 -3
- package/pp-core/templates/dev-preferences.md +1 -1
- package/pp-core/templates/research.md +1 -1
- package/pp-core/templates/summary-complex.md +1 -1
- package/pp-core/workflows/add-tests.md +2 -2
- package/pp-core/workflows/add-todo.md +1 -1
- package/pp-core/workflows/ai-integration-phase.md +3 -3
- package/pp-core/workflows/audit-milestone.md +1 -1
- package/pp-core/workflows/autonomous.md +9 -9
- package/pp-core/workflows/debug.md +1 -1
- package/pp-core/workflows/diagnose-issues.md +2 -2
- package/pp-core/workflows/discuss-phase/modes/chain.md +2 -2
- package/pp-core/workflows/discuss-phase-assumptions.md +2 -2
- package/pp-core/workflows/do.md +4 -4
- package/pp-core/workflows/docs-update.md +5 -5
- package/pp-core/workflows/eval-review.md +3 -3
- package/pp-core/workflows/execute-phase.md +5 -5
- package/pp-core/workflows/execute-plan.md +1 -1
- package/pp-core/workflows/explore.md +2 -2
- package/pp-core/workflows/extract-learnings.md +1 -1
- package/pp-core/workflows/forensics.md +1 -1
- package/pp-core/workflows/health.md +2 -2
- package/pp-core/workflows/help/modes/brief.md +2 -2
- package/pp-core/workflows/help/modes/default.md +7 -7
- package/pp-core/workflows/help/modes/full.md +16 -16
- package/pp-core/workflows/help.md +1 -1
- package/pp-core/workflows/import.md +11 -11
- package/pp-core/workflows/inbox.md +4 -4
- package/pp-core/workflows/ingest-docs.md +5 -5
- package/pp-core/workflows/list-workspaces.md +4 -4
- package/pp-core/workflows/manager.md +6 -6
- package/pp-core/workflows/map-codebase.md +2 -2
- package/pp-core/workflows/mvp-phase.md +12 -12
- package/pp-core/workflows/new-milestone.md +9 -9
- package/pp-core/workflows/new-project.md +12 -12
- package/pp-core/workflows/new-workspace.md +5 -5
- package/pp-core/workflows/next.md +4 -4
- package/pp-core/workflows/note.md +1 -1
- package/pp-core/workflows/plan-phase.md +13 -13
- package/pp-core/workflows/plan-review-convergence.md +3 -3
- package/pp-core/workflows/plant-seed.md +1 -1
- package/pp-core/workflows/pr-branch.md +2 -2
- package/pp-core/workflows/profile-user.md +2 -2
- package/pp-core/workflows/progress.md +1 -1
- package/pp-core/workflows/quick.md +15 -15
- package/pp-core/workflows/reapply-patches.md +6 -6
- package/pp-core/workflows/remove-workspace.md +1 -1
- package/pp-core/workflows/review.md +3 -3
- package/pp-core/workflows/scan.md +1 -1
- package/pp-core/workflows/secure-phase.md +4 -4
- package/pp-core/workflows/session-report.md +1 -1
- package/pp-core/workflows/settings-advanced.md +6 -6
- package/pp-core/workflows/settings-integrations.md +2 -2
- package/pp-core/workflows/settings.md +2 -2
- package/pp-core/workflows/ship.md +2 -2
- package/pp-core/workflows/sketch-wrap-up.md +2 -2
- package/pp-core/workflows/sketch.md +2 -2
- package/pp-core/workflows/spec-phase.md +4 -4
- package/pp-core/workflows/spike-wrap-up.md +2 -2
- package/pp-core/workflows/spike.md +2 -2
- package/pp-core/workflows/sync-skills.md +6 -6
- package/pp-core/workflows/thread.md +1 -1
- package/pp-core/workflows/ui-phase.md +4 -4
- package/pp-core/workflows/ui-review.md +4 -4
- package/pp-core/workflows/ultraplan-phase.md +6 -6
- package/pp-core/workflows/undo.md +6 -6
- package/pp-core/workflows/update.md +12 -12
- package/pp-core/workflows/validate-phase.md +4 -4
- package/pp-core/workflows/verify-work.md +5 -5
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
<purpose>
|
|
2
2
|
Socratic ideation workflow. Guides the developer through exploring an idea via probing questions,
|
|
3
|
-
offers mid-conversation research when useful, then routes crystallized outputs to
|
|
3
|
+
offers mid-conversation research when useful, then routes crystallized outputs to pp-core artifacts.
|
|
4
4
|
</purpose>
|
|
5
5
|
|
|
6
6
|
<required_reading>
|
|
@@ -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
|
|
14
|
+
Valid pp-core subagent types (use exact names — do not fall back to 'general-purpose'):
|
|
15
15
|
- pp-phase-researcher — Researches specific questions and returns concise findings
|
|
16
16
|
</available_agent_types>
|
|
17
17
|
|
|
@@ -96,7 +96,7 @@ Each surprise entry must include:
|
|
|
96
96
|
</step>
|
|
97
97
|
|
|
98
98
|
<step name="capture_thought_integration">
|
|
99
|
-
**What this step is:** `capture_thought` is an **optional convention**, not a bundled
|
|
99
|
+
**What this step is:** `capture_thought` is an **optional convention**, not a bundled pp-core tool. pp-core does not ship one and does not require one. The step is a hook for users who run a memory / knowledge-base MCP server (for example ExoCortex-style servers, `claude-mem`, or `mem0`-style servers) that exposes a tool with this exact name. If any MCP server in the current session provides a `capture_thought` tool with the signature below, each extracted learning is routed through it with metadata. If no such tool is present, the step is a silent no-op — `LEARNINGS.md` is always the primary output.
|
|
100
100
|
|
|
101
101
|
**Detection:** Check whether a tool named `capture_thought` is available in the current session. Do not assume any specific MCP server is connected.
|
|
102
102
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Forensics Workflow
|
|
2
2
|
|
|
3
|
-
Post-mortem investigation for failed or stuck
|
|
3
|
+
Post-mortem investigation for failed or stuck pp-core workflows. Analyzes git history,
|
|
4
4
|
`.planning/` artifacts, and file system state to detect anomalies and generate a
|
|
5
5
|
structured diagnostic report.
|
|
6
6
|
|
|
@@ -82,7 +82,7 @@ Parse JSON output:
|
|
|
82
82
|
|
|
83
83
|
```
|
|
84
84
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
85
|
-
|
|
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
|
|
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
|
-
**
|
|
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
|
|
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
|
|
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
|
-
#
|
|
6
|
+
# pp-core — The Pareto delivery framework.
|
|
7
7
|
|
|
8
|
-
Plan-driven development for solo agentic work with Claude Code.
|
|
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
|
|
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
|
|
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
|
|
45
|
+
## Update pp-core
|
|
46
46
|
|
|
47
47
|
```bash
|
|
48
|
-
npx @
|
|
48
|
+
npx @pareto4/pp-core@latest
|
|
49
49
|
```
|
|
50
50
|
</reference>
|
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
<purpose>
|
|
2
|
-
Display the complete
|
|
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
|
-
#
|
|
6
|
+
# pp-core Command Reference
|
|
7
7
|
|
|
8
|
-
**
|
|
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
|
-
|
|
18
|
+
pp-core evolves fast. Update periodically:
|
|
19
19
|
|
|
20
20
|
```bash
|
|
21
|
-
npx @
|
|
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
|
|
131
|
+
Route freeform text to the right pp-core command automatically.
|
|
132
132
|
|
|
133
|
-
- Analyzes natural language input to find the best matching
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
558
|
+
Update pp-core to latest version with changelog preview.
|
|
559
559
|
|
|
560
|
-
- `--sync` — sync managed
|
|
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 @
|
|
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
|
|
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
|
|
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
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
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
|
-
|
|
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
|
-
- **
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
-
- [ ]
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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 `
|
|
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
|
-
|
|
315
|
+
pp-core ► INGEST DOCS COMPLETE
|
|
316
316
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
317
317
|
```
|
|
318
318
|
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
<purpose>
|
|
2
|
-
List all
|
|
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
|
-
|
|
39
|
+
pp-core Workspaces (~/pp-workspaces/)
|
|
40
40
|
|
|
41
|
-
| Name | Repos | Strategy |
|
|
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
|
-
- **
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
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 `/
|
|
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: /
|
|
27
|
-
Example: /
|
|
28
|
-
Example: /
|
|
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 `/
|
|
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: /
|
|
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 `/
|
|
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 /
|
|
197
|
+
## 7. Delegate to /pp:plan-phase
|
|
198
198
|
|
|
199
|
-
Invoke `/
|
|
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
|
-
> - `/
|
|
213
|
-
> - `/
|
|
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
|
-
> `/
|
|
216
|
+
> `/pp:mvp-phase <new-phase-number>` on each to plan them as MVP slices."
|
|
217
217
|
|
|
218
218
|
## 9. Exit
|
|
219
219
|
|