@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
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Structured reasoning models for the **debugger** agent. Apply these at decision points during investigation, not continuously. Each model counters a specific documented failure mode.
|
|
4
4
|
|
|
5
|
-
Source: Curated from [thinking-partner](https://github.com/mattnowdev/thinking-partner) model catalog (150+ models). Selected for direct applicability to
|
|
5
|
+
Source: Curated from [thinking-partner](https://github.com/mattnowdev/thinking-partner) model catalog (150+ models). Selected for direct applicability to pp-core debugging workflow.
|
|
6
6
|
|
|
7
7
|
## Conflict Resolution
|
|
8
8
|
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Structured reasoning models for the **executor** agent. Apply these at decision points during task execution, not continuously. Each model counters a specific documented failure mode.
|
|
4
4
|
|
|
5
|
-
Source: Curated from [thinking-partner](https://github.com/mattnowdev/thinking-partner) model catalog (150+ models). Selected for direct applicability to
|
|
5
|
+
Source: Curated from [thinking-partner](https://github.com/mattnowdev/thinking-partner) model catalog (150+ models). Selected for direct applicability to pp-core execution workflow.
|
|
6
6
|
|
|
7
7
|
## Conflict Resolution
|
|
8
8
|
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Structured reasoning models for the **planner** and **roadmapper** agents. Apply these at decision points during plan creation, not continuously. Each model counters a specific documented failure mode.
|
|
4
4
|
|
|
5
|
-
Source: Curated from [thinking-partner](https://github.com/mattnowdev/thinking-partner) model catalog (150+ models). Selected for direct applicability to
|
|
5
|
+
Source: Curated from [thinking-partner](https://github.com/mattnowdev/thinking-partner) model catalog (150+ models). Selected for direct applicability to pp-core planning workflow.
|
|
6
6
|
|
|
7
7
|
## Conflict Resolution
|
|
8
8
|
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Structured reasoning models for the **researcher** and **synthesizer** agents. Apply these at decision points during research and synthesis, not continuously. Each model counters a specific documented failure mode.
|
|
4
4
|
|
|
5
|
-
Source: Curated from [thinking-partner](https://github.com/mattnowdev/thinking-partner) model catalog (150+ models). Selected for direct applicability to
|
|
5
|
+
Source: Curated from [thinking-partner](https://github.com/mattnowdev/thinking-partner) model catalog (150+ models). Selected for direct applicability to pp-core research workflow.
|
|
6
6
|
|
|
7
7
|
## Conflict Resolution
|
|
8
8
|
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Structured reasoning models for the **verifier** and **plan-checker** agents. Apply these during verification passes, not continuously. Each model counters a specific documented failure mode.
|
|
4
4
|
|
|
5
|
-
Source: Curated from [thinking-partner](https://github.com/mattnowdev/thinking-partner) model catalog (150+ models). Selected for direct applicability to
|
|
5
|
+
Source: Curated from [thinking-partner](https://github.com/mattnowdev/thinking-partner) model catalog (150+ models). Selected for direct applicability to pp-core verification workflow.
|
|
6
6
|
|
|
7
7
|
## Conflict Resolution
|
|
8
8
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
<ui_patterns>
|
|
2
2
|
|
|
3
|
-
Visual patterns for user-facing
|
|
3
|
+
Visual patterns for user-facing pp-core output. Orchestrators @-reference this file.
|
|
4
4
|
|
|
5
5
|
## Stage Banners
|
|
6
6
|
|
|
@@ -8,7 +8,7 @@ Use for major workflow transitions.
|
|
|
8
8
|
|
|
9
9
|
```
|
|
10
10
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
11
|
-
|
|
11
|
+
pp-core ► {STAGE NAME}
|
|
12
12
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
13
13
|
```
|
|
14
14
|
|
|
@@ -155,7 +155,7 @@ Always at end of major completions.
|
|
|
155
155
|
|
|
156
156
|
- Varying box/banner widths
|
|
157
157
|
- Mixing banner styles (`===`, `---`, `***`)
|
|
158
|
-
- Skipping `
|
|
158
|
+
- Skipping `pp-core ►` prefix in banners
|
|
159
159
|
- Random emoji (`🚀`, `✨`, `💫`)
|
|
160
160
|
- Missing Next Up block after completions
|
|
161
161
|
|
|
@@ -21,7 +21,7 @@ Rules that apply to ALL workflows and agents. Individual workflows may have addi
|
|
|
21
21
|
|
|
22
22
|
## Subagent Rules
|
|
23
23
|
|
|
24
|
-
10. **NEVER** use non-
|
|
24
|
+
10. **NEVER** use non-pp-core agent types (`general-purpose`, `Explore`, `Plan`, `Bash`, `feature-dev`, etc.) -- ALWAYS use `subagent_type: "pp-{agent}"` (e.g., `pp-phase-researcher`, `pp-executor`, `pp-planner`). pp-core agents have project-aware prompts, audit logging, and workflow context. Generic agents bypass all of this.
|
|
25
25
|
11. **Do not** re-litigate decisions that are already locked in CONTEXT.md (or PROJECT.md ## Context section) -- respect locked decisions unconditionally.
|
|
26
26
|
|
|
27
27
|
## Questioning Anti-Patterns
|
|
@@ -50,10 +50,10 @@ Reference: `references/questioning.md` for the full anti-pattern list.
|
|
|
50
50
|
22. **Config fallback awareness**: Config loading returns `null` silently on invalid JSON. If your workflow depends on config values, check for null and warn the user: "config.json is invalid or missing -- running with defaults."
|
|
51
51
|
23. **Partial state recovery**: If STATE.md references a phase directory that doesn't exist, do not proceed silently. Warn the user and suggest diagnosing the mismatch.
|
|
52
52
|
|
|
53
|
-
##
|
|
53
|
+
## pp-core-Specific Rules
|
|
54
54
|
|
|
55
|
-
24. **Do not** check for `mode === 'auto'` or `mode === 'autonomous'` --
|
|
56
|
-
25. **Prefer `pp-tools query`** for orchestration when a handler exists; when shelling out to the legacy CLI, use **`pp-tools.cjs`** (not `pp-tools.js` or any other filename) —
|
|
55
|
+
24. **Do not** check for `mode === 'auto'` or `mode === 'autonomous'` -- pp-core uses `yolo` config flag. Check `yolo: true` for autonomous mode, absence or `false` for interactive mode.
|
|
56
|
+
25. **Prefer `pp-tools query`** for orchestration when a handler exists; when shelling out to the legacy CLI, use **`pp-tools.cjs`** (not `pp-tools.js` or any other filename) — pp-core ships the programmatic API as CommonJS for Node.js CLI compatibility.
|
|
57
57
|
26. **Plan files MUST follow `{padded_phase}-{NN}-PLAN.md` pattern** (e.g., `01-01-PLAN.md`). Never use `PLAN-01.md`, `plan-01.md`, or any other variation -- pp-tools detection depends on this exact pattern.
|
|
58
58
|
27. **Do not start executing the next plan before writing the SUMMARY.md for the current plan** -- downstream plans may reference it via `@` includes.
|
|
59
59
|
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
## Overview
|
|
4
4
|
|
|
5
|
-
The `--ws <name>` flag scopes
|
|
5
|
+
The `--ws <name>` flag scopes pp-core operations to a specific workstream, enabling
|
|
6
6
|
parallel milestone work by multiple Claude Code instances on the same codebase.
|
|
7
7
|
|
|
8
8
|
## Resolution Priority
|
|
@@ -19,14 +19,14 @@ The shared `.planning/active-workstream` file is fundamentally unsafe when multi
|
|
|
19
19
|
Claude/Codex instances are active on the same repo at the same time. One session can
|
|
20
20
|
silently repoint another session's `STATE.md`, `ROADMAP.md`, and phase paths.
|
|
21
21
|
|
|
22
|
-
|
|
22
|
+
pp-core now prefers a session-scoped pointer keyed by runtime/session identity
|
|
23
23
|
(`GSD_SESSION_KEY`, `CODEX_THREAD_ID`, `CLAUDE_CODE_SSE_PORT`, terminal session IDs,
|
|
24
24
|
or the controlling TTY). This keeps concurrent sessions isolated while preserving
|
|
25
25
|
legacy compatibility for runtimes that do not expose a stable session key.
|
|
26
26
|
|
|
27
27
|
## Session Identity Resolution
|
|
28
28
|
|
|
29
|
-
When
|
|
29
|
+
When pp-core resolves the session-scoped pointer in step 3 above, it uses this order:
|
|
30
30
|
|
|
31
31
|
1. Explicit runtime/session env vars such as `GSD_SESSION_KEY`, `CODEX_THREAD_ID`,
|
|
32
32
|
`CLAUDE_SESSION_ID`, `CLAUDE_CODE_SSE_PORT`, `OPENCODE_SESSION_ID`,
|
|
@@ -35,11 +35,11 @@ When GSD resolves the session-scoped pointer in step 3 above, it uses this order
|
|
|
35
35
|
2. `TTY` or `SSH_TTY` if the shell/runtime already exposes the terminal path
|
|
36
36
|
3. A single best-effort `tty` probe, but only when stdin is interactive
|
|
37
37
|
|
|
38
|
-
If none of those produce a stable identity,
|
|
38
|
+
If none of those produce a stable identity, pp-core does not keep probing. It falls
|
|
39
39
|
back directly to the legacy shared `.planning/active-workstream` file.
|
|
40
40
|
|
|
41
41
|
This matters in headless or stripped environments: when stdin is already
|
|
42
|
-
non-interactive,
|
|
42
|
+
non-interactive, pp-core intentionally skips shelling out to `tty` because that path
|
|
43
43
|
cannot discover a stable session identity and only adds avoidable failures on the
|
|
44
44
|
routing hot path.
|
|
45
45
|
|
|
@@ -48,14 +48,14 @@ routing hot path.
|
|
|
48
48
|
Session-scoped pointers are intentionally lightweight and best-effort:
|
|
49
49
|
|
|
50
50
|
- Clearing a workstream for one session removes only that session's pointer file
|
|
51
|
-
- If that was the last pointer for the repo,
|
|
51
|
+
- If that was the last pointer for the repo, pp-core also removes the now-empty
|
|
52
52
|
per-project temp directory
|
|
53
53
|
- If sibling session pointers still exist, the temp directory is left in place
|
|
54
|
-
- When a pointer refers to a workstream directory that no longer exists,
|
|
54
|
+
- When a pointer refers to a workstream directory that no longer exists, pp-core
|
|
55
55
|
treats it as stale state: it removes that pointer file and resolves to `null`
|
|
56
56
|
until the session explicitly sets a new active workstream again
|
|
57
57
|
|
|
58
|
-
|
|
58
|
+
pp-core does not currently run a background garbage collector for historical temp
|
|
59
59
|
directories. Cleanup is opportunistic at the pointer being cleared or self-healed,
|
|
60
60
|
and broader temp hygiene is left to OS temp cleanup or future maintenance work.
|
|
61
61
|
|
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-
#
|
|
1
|
+
# pp-core Canonical Artifact Registry
|
|
2
2
|
|
|
3
|
-
This directory contains the template files for every artifact that
|
|
3
|
+
This directory contains the template files for every artifact that pp-core workflows officially produce. The table below is the authoritative index: **if a `.planning/` root file is not listed here, `pp-health` will flag it as W019** (unrecognized artifact).
|
|
4
4
|
|
|
5
|
-
Agents should query this file before treating a `.planning/` file as authoritative. If the file name does not appear below, it is not a canonical
|
|
5
|
+
Agents should query this file before treating a `.planning/` file as authoritative. If the file name does not appear below, it is not a canonical pp-core artifact.
|
|
6
6
|
|
|
7
7
|
---
|
|
8
8
|
|
|
@@ -20,7 +20,7 @@ These files live directly at `.planning/` — not inside phase subdirectories.
|
|
|
20
20
|
| `BACKLOG.md` | *(inline)* | `/pp-add-backlog` | Pending ideas and deferred work |
|
|
21
21
|
| `LEARNINGS.md` | *(inline)* | `/pp:extract-learnings`, `/pp:execute-phase` | Phase retrospective learnings for future plans |
|
|
22
22
|
| `THREADS.md` | *(inline)* | `/pp:thread` | Persistent discussion threads |
|
|
23
|
-
| `config.json` | `config.json` | `/pp:new-project`, `/pp:health --repair` | Project-specific
|
|
23
|
+
| `config.json` | `config.json` | `/pp:new-project`, `/pp:health --repair` | Project-specific pp-core configuration |
|
|
24
24
|
| `CLAUDE.md` | `claude-md.md` | `/pp-profile` | Auto-assembled Claude Code context file |
|
|
25
25
|
| `RETROSPECTIVE.md` | *(inline)* | `/pp:complete-milestone` | Living milestone retrospective updated at each milestone close |
|
|
26
26
|
|
|
@@ -85,7 +85,7 @@ No project skills found. Add skills to any of: `.claude/skills/`, `.agents/skill
|
|
|
85
85
|
**Discovery behavior:**
|
|
86
86
|
- Scans `.claude/skills/`, `.agents/skills/`, `.cursor/skills/`, `.github/skills/` for subdirectories containing `SKILL.md`
|
|
87
87
|
- Extracts `name` and `description` from YAML frontmatter (supports multi-line descriptions)
|
|
88
|
-
- Skips
|
|
88
|
+
- Skips pp-core's own installed skills (directories starting with `pp-`)
|
|
89
89
|
- Deduplicates by skill name across directories
|
|
90
90
|
|
|
91
91
|
### Workflow Enforcement Section
|
|
@@ -127,7 +127,7 @@ CLAUDE.md file and no profile section exists yet.
|
|
|
127
127
|
3. **Conventions** — Code patterns and rules (how code is written)
|
|
128
128
|
4. **Architecture** — System structure (how components fit together)
|
|
129
129
|
5. **Skills** — Discovered project skills with name and description (what domain knowledge is available)
|
|
130
|
-
6. **Workflow Enforcement** — Default
|
|
130
|
+
6. **Workflow Enforcement** — Default pp-core entry points for file-changing work
|
|
131
131
|
7. **Profile** — Developer behavioral preferences (how to interact)
|
|
132
132
|
|
|
133
133
|
## Marker Format
|
|
@@ -146,7 +146,7 @@ Template for `.planning/codebase/ARCHITECTURE.md` - captures conceptual code org
|
|
|
146
146
|
|
|
147
147
|
**CLI Command Execution:**
|
|
148
148
|
|
|
149
|
-
1. User runs: `
|
|
149
|
+
1. User runs: `pp new-project`
|
|
150
150
|
2. Commander parses args and flags
|
|
151
151
|
3. Command handler invoked (`src/commands/new-project.ts`)
|
|
152
152
|
4. Handler calls service methods (`src/services/project.ts` → `create()`)
|
|
@@ -180,7 +180,7 @@ Template for `.planning/codebase/ARCHITECTURE.md` - captures conceptual code org
|
|
|
180
180
|
|
|
181
181
|
**CLI Entry:**
|
|
182
182
|
- Location: `src/index.ts`
|
|
183
|
-
- Triggers: User runs `
|
|
183
|
+
- Triggers: User runs `pp <command>`
|
|
184
184
|
- Responsibilities: Register commands, parse args, display help
|
|
185
185
|
|
|
186
186
|
**Commands:**
|
|
@@ -126,7 +126,7 @@ Template for `.planning/codebase/STRUCTURE.md` - captures physical file organiza
|
|
|
126
126
|
pp-core/
|
|
127
127
|
├── bin/ # Executable entry points
|
|
128
128
|
├── commands/ # Slash command definitions
|
|
129
|
-
│ └──
|
|
129
|
+
│ └── pp/ # pp-core-specific commands
|
|
130
130
|
├── pp-core/ # Skill resources
|
|
131
131
|
│ ├── references/ # Principle documents
|
|
132
132
|
│ ├── templates/ # File templates
|
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
# Instructions for
|
|
1
|
+
# Instructions for pp-core
|
|
2
2
|
|
|
3
|
-
- Use the pp-core skill when the user asks for
|
|
3
|
+
- Use the pp-core skill when the user asks for pp-core or uses a `pp-*` command.
|
|
4
4
|
- Treat `/pp-...` or `pp-...` as command invocations and load the matching file from `.github/skills/pp-*`.
|
|
5
5
|
- When a command says to spawn a subagent, prefer a matching custom agent from `.github/agents`.
|
|
6
|
-
- Do not apply
|
|
6
|
+
- Do not apply pp-core workflows unless the user explicitly asks for them.
|
|
7
7
|
- After completing any `pp-*` command (or any deliverable it triggers: feature, bug fix, tests, docs, etc.), ALWAYS: (1) offer the user the next step by prompting via `ask_user`; repeat this feedback loop until the user explicitly indicates they are done.
|
|
@@ -4,7 +4,7 @@ description: Load developer preferences into this session
|
|
|
4
4
|
|
|
5
5
|
# Developer Preferences
|
|
6
6
|
|
|
7
|
-
> Generated by
|
|
7
|
+
> Generated by pp-core on {{generated_at}} from {{data_source}}.
|
|
8
8
|
> Run `/pp:profile-user --refresh` to regenerate.
|
|
9
9
|
|
|
10
10
|
## Behavioral Directives
|
|
@@ -568,7 +568,7 @@ function useVehicleControls(rigidBodyRef) {
|
|
|
568
568
|
- When "how do experts do this" matters more than "which library"
|
|
569
569
|
|
|
570
570
|
**Structure:**
|
|
571
|
-
- Use XML tags for section markers (matches
|
|
571
|
+
- Use XML tags for section markers (matches pp-core templates)
|
|
572
572
|
- Seven core sections: summary, standard_stack, architecture_patterns, dont_hand_roll, common_pitfalls, code_examples, sources
|
|
573
573
|
- All sections required (drives comprehensive research)
|
|
574
574
|
|
|
@@ -50,7 +50,7 @@ status: complete
|
|
|
50
50
|
[Key decisions with brief rationale]
|
|
51
51
|
|
|
52
52
|
## Deviations from Plan (Auto-fixed)
|
|
53
|
-
[Detailed auto-fix records per
|
|
53
|
+
[Detailed auto-fix records per pp-core deviation rules]
|
|
54
54
|
|
|
55
55
|
## Issues Encountered
|
|
56
56
|
[Problems during planned work and resolutions]
|
|
@@ -62,7 +62,7 @@ Exit.
|
|
|
62
62
|
Present banner:
|
|
63
63
|
```
|
|
64
64
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
65
|
-
|
|
65
|
+
pp-core ► ADD TESTS — Phase ${phase_number}: ${phase_name}
|
|
66
66
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
67
67
|
```
|
|
68
68
|
</step>
|
|
@@ -279,7 +279,7 @@ Create a test coverage report and present to user:
|
|
|
279
279
|
|
|
280
280
|
```
|
|
281
281
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
282
|
-
|
|
282
|
+
pp-core ► TEST GENERATION COMPLETE
|
|
283
283
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
284
284
|
|
|
285
285
|
## Results
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
<purpose>
|
|
2
|
-
Capture an idea, task, or issue that surfaces during a
|
|
2
|
+
Capture an idea, task, or issue that surfaces during a pp-core session as a structured todo for later work. Enables "thought → capture → continue" flow without losing context.
|
|
3
3
|
</purpose>
|
|
4
4
|
|
|
5
5
|
<required_reading>
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
<purpose>
|
|
2
|
-
Generate an AI design contract (AI-SPEC.md) for phases that involve building AI systems. Orchestrates pp-framework-selector → pp-ai-researcher → pp-domain-researcher → pp-eval-planner with a validation gate. Inserts between discuss-phase and plan-phase in the
|
|
2
|
+
Generate an AI design contract (AI-SPEC.md) for phases that involve building AI systems. Orchestrates pp-framework-selector → pp-ai-researcher → pp-domain-researcher → pp-eval-planner with a validation gate. Inserts between discuss-phase and plan-phase in the pp-core lifecycle.
|
|
3
3
|
|
|
4
4
|
AI-SPEC.md locks four things before the planner creates tasks:
|
|
5
5
|
1. Framework selection (with rationale and alternatives)
|
|
@@ -95,7 +95,7 @@ If "Update": continue to step 5.
|
|
|
95
95
|
Display:
|
|
96
96
|
```
|
|
97
97
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
98
|
-
|
|
98
|
+
pp-core ► AI DESIGN CONTRACT — PHASE {N}: {name}
|
|
99
99
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
100
100
|
|
|
101
101
|
◆ Step 1/4 — Framework Selection...
|
|
@@ -266,7 +266,7 @@ git commit -m "docs({phase_slug}): generate AI-SPEC.md — {primary_framework} +
|
|
|
266
266
|
|
|
267
267
|
```
|
|
268
268
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
269
|
-
|
|
269
|
+
pp-core ► AI-SPEC COMPLETE — PHASE {N}: {name}
|
|
270
270
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
271
271
|
|
|
272
272
|
◆ Framework: {primary_framework}
|
|
@@ -7,7 +7,7 @@ Read all files referenced by the invoking prompt's execution_context before star
|
|
|
7
7
|
</required_reading>
|
|
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-integration-checker — Checks cross-phase integration
|
|
12
12
|
</available_agent_types>
|
|
13
13
|
|
|
@@ -101,7 +101,7 @@ Display startup banner:
|
|
|
101
101
|
|
|
102
102
|
```
|
|
103
103
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
104
|
-
|
|
104
|
+
pp-core ► AUTONOMOUS
|
|
105
105
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
106
106
|
|
|
107
107
|
Milestone: {milestone_version} — {milestone_name}
|
|
@@ -158,7 +158,7 @@ Exit cleanly.
|
|
|
158
158
|
|
|
159
159
|
```
|
|
160
160
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
161
|
-
|
|
161
|
+
pp-core ► AUTONOMOUS ▸ COMPLETE 🎉
|
|
162
162
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
163
163
|
|
|
164
164
|
All phases complete! Nothing left to do.
|
|
@@ -197,7 +197,7 @@ For the current phase, display the progress banner:
|
|
|
197
197
|
|
|
198
198
|
```
|
|
199
199
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
200
|
-
|
|
200
|
+
pp-core ► AUTONOMOUS ▸ Phase {N}/{T}: {Name} [████░░░░] {P}%
|
|
201
201
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
202
202
|
```
|
|
203
203
|
|
|
@@ -593,7 +593,7 @@ For each entry in `activeHooks` in array order where `kind == "step"` and `ref.s
|
|
|
593
593
|
Skill(skill="gsd-${ref.skill}", args="${PHASE_NUM}")
|
|
594
594
|
```
|
|
595
595
|
|
|
596
|
-
(i.e. prepend `
|
|
596
|
+
(i.e. prepend `pp-` to `ref.skill` — so `ui-review` → `pp-ui-review`.)
|
|
597
597
|
|
|
598
598
|
Display the review result summary and score from UI-REVIEW.md if produced. Continue to iterate step regardless of result — hooks at this point are advisory, not blocking.
|
|
599
599
|
|
|
@@ -623,7 +623,7 @@ Read and execute: `$HOME/.claude/pp-core/references/autonomous-smart-discuss.md`
|
|
|
623
623
|
|
|
624
624
|
```
|
|
625
625
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
626
|
-
|
|
626
|
+
pp-core ► AUTONOMOUS ▸ --to ${TO_PHASE} REACHED
|
|
627
627
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
628
628
|
|
|
629
629
|
Completed through phase ${TO_PHASE} as requested.
|
|
@@ -675,7 +675,7 @@ If all phases complete, proceed to lifecycle step.
|
|
|
675
675
|
|
|
676
676
|
```
|
|
677
677
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
678
|
-
|
|
678
|
+
pp-core ► AUTONOMOUS ▸ PHASE ${ONLY_PHASE} COMPLETE ✓
|
|
679
679
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
680
680
|
|
|
681
681
|
Phase ${ONLY_PHASE}: ${PHASE_NAME} — Done
|
|
@@ -693,7 +693,7 @@ Display lifecycle transition banner:
|
|
|
693
693
|
|
|
694
694
|
```
|
|
695
695
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
696
|
-
|
|
696
|
+
pp-core ► AUTONOMOUS ▸ LIFECYCLE
|
|
697
697
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
698
698
|
|
|
699
699
|
All phases complete → Starting lifecycle: audit → complete → cleanup
|
|
@@ -784,7 +784,7 @@ Display final completion banner:
|
|
|
784
784
|
|
|
785
785
|
```
|
|
786
786
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
787
|
-
|
|
787
|
+
pp-core ► AUTONOMOUS ▸ COMPLETE 🎉
|
|
788
788
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
789
789
|
|
|
790
790
|
Milestone: {milestone_version} — {milestone_name}
|
|
@@ -817,7 +817,7 @@ When any phase operation fails or a blocker is detected, present 3 options via A
|
|
|
817
817
|
|
|
818
818
|
```
|
|
819
819
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
820
|
-
|
|
820
|
+
pp-core ► AUTONOMOUS ▸ STOPPED
|
|
821
821
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
822
822
|
|
|
823
823
|
Completed: {list of completed phases}
|
|
@@ -6,7 +6,7 @@ Systematic debugging using the scientific method with subagent isolation.
|
|
|
6
6
|
Orchestrates symptom gathering, session creation, and delegation to `pp-debug-session-manager`.
|
|
7
7
|
|
|
8
8
|
<available_agent_types>
|
|
9
|
-
Valid
|
|
9
|
+
Valid pp-core subagent types (use exact names — do not fall back to 'general-purpose'):
|
|
10
10
|
- pp-debug-session-manager — manages debug checkpoint/continuation loop in isolated context
|
|
11
11
|
- pp-debugger — investigates bugs using scientific method
|
|
12
12
|
</available_agent_types>
|
|
@@ -7,7 +7,7 @@ Orchestrator stays lean: parse gaps, spawn agents, collect results, update UAT.
|
|
|
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-debugger — Diagnoses and fixes issues
|
|
12
12
|
</available_agent_types>
|
|
13
13
|
|
|
@@ -194,7 +194,7 @@ pp_run query commit "docs({phase_num}): add root causes from diagnosis" --files
|
|
|
194
194
|
Display:
|
|
195
195
|
```
|
|
196
196
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
197
|
-
|
|
197
|
+
pp-core ► DIAGNOSIS COMPLETE
|
|
198
198
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
199
199
|
|
|
200
200
|
| Gap (Truth) | Root Cause | Files |
|
|
@@ -48,7 +48,7 @@ _PP_SHIM_NAME="pp-tools.cjs"; _PP_RUNTIME_ROOT="${RUNTIME_DIR:-$(git rev-parse -
|
|
|
48
48
|
Banner:
|
|
49
49
|
```
|
|
50
50
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
51
|
-
|
|
51
|
+
pp-core ► AUTO-ADVANCING TO PLAN
|
|
52
52
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
53
53
|
|
|
54
54
|
Context captured. Launching plan-phase...
|
|
@@ -69,7 +69,7 @@ _PP_SHIM_NAME="pp-tools.cjs"; _PP_RUNTIME_ROOT="${RUNTIME_DIR:-$(git rev-parse -
|
|
|
69
69
|
- **PHASE COMPLETE** → Full chain succeeded. Display:
|
|
70
70
|
```
|
|
71
71
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
72
|
-
|
|
72
|
+
pp-core ► PHASE ${PHASE} COMPLETE
|
|
73
73
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
74
74
|
|
|
75
75
|
Auto-advance pipeline finished: discuss → plan → execute
|
|
@@ -7,7 +7,7 @@ believe based on evidence, and ask the user only to correct what's wrong.
|
|
|
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-assumptions-analyzer — Analyzes codebase to surface implementation assumptions
|
|
12
12
|
</available_agent_types>
|
|
13
13
|
|
|
@@ -642,7 +642,7 @@ pp_run query config-set workflow._auto_chain_active true
|
|
|
642
642
|
Display banner:
|
|
643
643
|
```text
|
|
644
644
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
645
|
-
|
|
645
|
+
pp-core ► AUTO-ADVANCING TO PLAN
|
|
646
646
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
647
647
|
|
|
648
648
|
Context captured (assumptions mode). Launching plan-phase...
|
package/pp-core/workflows/do.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
<purpose>
|
|
2
|
-
Analyze freeform text from the user and route to the most appropriate
|
|
2
|
+
Analyze freeform text from the user and route to the most appropriate pp-core command. This is a dispatcher — it never does the work itself. Match user intent to the best command, confirm the routing, and hand off.
|
|
3
3
|
</purpose>
|
|
4
4
|
|
|
5
5
|
<required_reading>
|
|
@@ -16,7 +16,7 @@ Read all files referenced by the invoking prompt's execution_context before star
|
|
|
16
16
|
If `$ARGUMENTS` is empty, ask via AskUserQuestion:
|
|
17
17
|
|
|
18
18
|
```
|
|
19
|
-
What would you like to do? Describe the task, bug, or idea and I'll route it to the right
|
|
19
|
+
What would you like to do? Describe the task, bug, or idea and I'll route it to the right pp-core command.
|
|
20
20
|
```
|
|
21
21
|
|
|
22
22
|
Wait for response before continuing.
|
|
@@ -79,7 +79,7 @@ Which approach fits better?
|
|
|
79
79
|
|
|
80
80
|
```
|
|
81
81
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
82
|
-
|
|
82
|
+
pp-core ► ROUTING
|
|
83
83
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
84
84
|
|
|
85
85
|
**Input:** {first 80 chars of $ARGUMENTS}
|
|
@@ -102,7 +102,7 @@ After invoking the command, stop. The dispatched command handles everything from
|
|
|
102
102
|
|
|
103
103
|
<success_criteria>
|
|
104
104
|
- [ ] Input validated (not empty)
|
|
105
|
-
- [ ] Intent matched to exactly one
|
|
105
|
+
- [ ] Intent matched to exactly one pp-core command
|
|
106
106
|
- [ ] Ambiguity resolved via user question (if needed)
|
|
107
107
|
- [ ] Project existence checked for routes that require it
|
|
108
108
|
- [ ] Routing decision displayed before dispatch
|
|
@@ -3,7 +3,7 @@ Generate, update, and verify all project documentation — both canonical doc ty
|
|
|
3
3
|
</purpose>
|
|
4
4
|
|
|
5
5
|
<available_agent_types>
|
|
6
|
-
Valid
|
|
6
|
+
Valid pp-core subagent types (use exact names — do not fall back to 'general-purpose'):
|
|
7
7
|
- pp-doc-writer — Writes and updates project documentation files
|
|
8
8
|
- pp-doc-verifier — Verifies factual claims in docs against the live codebase
|
|
9
9
|
</available_agent_types>
|
|
@@ -346,12 +346,12 @@ Check for hand-written docs in the queue and gather user decisions before dispat
|
|
|
346
346
|
Present the following choice using `AskUserQuestion` if available, or inline prompt otherwise:
|
|
347
347
|
|
|
348
348
|
```
|
|
349
|
-
{filename} appears to be hand-written (no
|
|
349
|
+
{filename} appears to be hand-written (no pp-core marker found).
|
|
350
350
|
|
|
351
351
|
How should this file be handled?
|
|
352
352
|
[1] preserve -- Skip entirely. Leave unchanged.
|
|
353
353
|
[2] supplement -- Append only missing sections. Existing content untouched.
|
|
354
|
-
[3] regenerate -- Overwrite with a fresh
|
|
354
|
+
[3] regenerate -- Overwrite with a fresh pp-core-generated doc.
|
|
355
355
|
```
|
|
356
356
|
|
|
357
357
|
Record each decision. Update the doc queue:
|
|
@@ -1154,10 +1154,10 @@ End workflow.
|
|
|
1154
1154
|
- [ ] CHANGELOG.md was NOT generated or queued
|
|
1155
1155
|
- [ ] Each doc was generated in correct mode (create for new, update for existing)
|
|
1156
1156
|
- [ ] Wave 1 docs (README, ARCHITECTURE, CONFIGURATION) completed before Wave 2 started
|
|
1157
|
-
- [ ] Generated docs contain zero
|
|
1157
|
+
- [ ] Generated docs contain zero pp-core methodology content
|
|
1158
1158
|
- [ ] docs/DEPLOYMENT.md and docs/CONFIGURATION.md use VERIFY markers for undiscoverable claims (if generated)
|
|
1159
1159
|
- [ ] All generated files committed (if commit_docs is true)
|
|
1160
|
-
- [ ] Hand-written docs (no
|
|
1160
|
+
- [ ] Hand-written docs (no pp-core marker) prompted for preserve/supplement/regenerate before dispatch (unless --force)
|
|
1161
1161
|
- [ ] --force flag skipped preservation prompts and regenerated all docs
|
|
1162
1162
|
- [ ] --verify-only flag reported doc status without generating files
|
|
1163
1163
|
- [ ] Per-package READMEs generated for monorepo workspaces (if applicable)
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
<purpose>
|
|
2
|
-
Retroactive audit of an implemented AI phase's evaluation coverage. Standalone command that works on any
|
|
2
|
+
Retroactive audit of an implemented AI phase's evaluation coverage. Standalone command that works on any pp-core-managed AI phase. Produces a scored EVAL-REVIEW.md with gap analysis and remediation plan.
|
|
3
3
|
|
|
4
4
|
Use after /pp:execute-phase to verify that the evaluation strategy from AI-SPEC.md was actually implemented. Mirrors the pattern of /pp:ui-review and /pp:validate-phase.
|
|
5
5
|
</purpose>
|
|
@@ -28,7 +28,7 @@ AGENT_SKILLS_AUDITOR=$(pp_run query agent-skills pp-eval-auditor)
|
|
|
28
28
|
Display banner:
|
|
29
29
|
```
|
|
30
30
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
31
|
-
|
|
31
|
+
pp-core ► EVAL AUDIT — PHASE {N}: {name}
|
|
32
32
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
33
33
|
```
|
|
34
34
|
|
|
@@ -119,7 +119,7 @@ Read the written EVAL-REVIEW.md. Extract:
|
|
|
119
119
|
|
|
120
120
|
```
|
|
121
121
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
122
|
-
|
|
122
|
+
pp-core ► EVAL AUDIT COMPLETE — PHASE {N}: {name}
|
|
123
123
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
124
124
|
|
|
125
125
|
◆ Score: {overall_score}/100
|
|
@@ -41,7 +41,7 @@ Read STATE.md before any operation to load project context.
|
|
|
41
41
|
</required_reading>
|
|
42
42
|
|
|
43
43
|
<available_agent_types>
|
|
44
|
-
These are the valid
|
|
44
|
+
These are the valid pp-core subagent types registered in .claude/agents/ (or equivalent for your runtime).
|
|
45
45
|
Always use the exact name from this list — do not fall back to 'general-purpose' or other built-in types:
|
|
46
46
|
|
|
47
47
|
- pp-executor — Executes plan tasks, commits, creates SUMMARY.md
|
|
@@ -280,8 +280,8 @@ checkpoints between tasks. The user can review, modify, or redirect work at any
|
|
|
280
280
|
**Benefits of interactive mode:**
|
|
281
281
|
- No subagent overhead — dramatically lower token usage
|
|
282
282
|
- User catches mistakes early — saves costly verification cycles
|
|
283
|
-
- Maintains
|
|
284
|
-
- Best for: small phases, bug fixes, verification gaps, learning
|
|
283
|
+
- Maintains pp-core's planning/tracking structure
|
|
284
|
+
- Best for: small phases, bug fixes, verification gaps, learning pp-core
|
|
285
285
|
|
|
286
286
|
**Skip to handle_branching step** (interactive plans execute inline after grouping).
|
|
287
287
|
</step>
|
|
@@ -1212,7 +1212,7 @@ CHECK_EXIT=$?
|
|
|
1212
1212
|
|
|
1213
1213
|
```
|
|
1214
1214
|
Phase blocked: {N} TDD plan(s) violate the RED→GREEN gate sequence under MVP+TDD.
|
|
1215
|
-
Resolve and re-run /
|
|
1215
|
+
Resolve and re-run /pp:execute-phase, or override with /pp:execute-phase {phase} --force-mvp-gate to ship anyway.
|
|
1216
1216
|
```
|
|
1217
1217
|
|
|
1218
1218
|
(`--force-mvp-gate` is the documented, not-yet-implemented escape hatch.) Outside MVP+TDD, TDD-review violations remain advisory (table shown, execution continues).
|
|
@@ -1693,7 +1693,7 @@ For 1M+ context models, consider:
|
|
|
1693
1693
|
|
|
1694
1694
|
<failure_handling>
|
|
1695
1695
|
- **Quota / rate-limit (any runtime — #3095):** Agent return body contains a sentinel like `usage limit`, `rate limit`, `429`, `too many requests`, `RESOURCE_EXHAUSTED`, `usage_limit_reached`. Route via `pp-tools.cjs query agent.classify-failure` → `class: "quota-exceeded"`. Do not offer retry-now; the right action is wait-for-reset and resume.
|
|
1696
|
-
- **classifyHandoffIfNeeded false failure:** Agent reports "failed" but error is `classifyHandoffIfNeeded is not defined` → Claude Code bug, not
|
|
1696
|
+
- **classifyHandoffIfNeeded false failure:** Agent reports "failed" but error is `classifyHandoffIfNeeded is not defined` → Claude Code bug, not pp-core. Spot-check (SUMMARY exists, commits present) → if pass, treat as success
|
|
1697
1697
|
- **Agent fails mid-plan:** Missing SUMMARY.md → report, ask user how to proceed
|
|
1698
1698
|
- **Dependency chain breaks:** Wave 1 fails → Wave 2 dependents likely fail → user chooses attempt or skip
|
|
1699
1699
|
- **All agents in wave fail:** Systemic issue → stop, report for investigation
|
|
@@ -33,7 +33,7 @@ a capability (#1164), not core.
|
|
|
33
33
|
</atomic_close_out_invariant>
|
|
34
34
|
|
|
35
35
|
<available_agent_types>
|
|
36
|
-
Valid
|
|
36
|
+
Valid pp-core subagent types (use exact names — do not fall back to 'general-purpose'):
|
|
37
37
|
- pp-executor — Executes plan tasks, commits, creates SUMMARY.md
|
|
38
38
|
</available_agent_types>
|
|
39
39
|
|