ptp-full

Orchestrates end-to-end plan-then-apply execution of oversized changes decomposed into reviewed slices.

Updated Jun 8, 2026
One-click install
npx skills add https://github.com/AlmogMaayan/ptp --skill ptp-full-almogmaayan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ptp-full
Source: https://github.com/AlmogMaayan/ptp/tree/main/skills/ptp-full
Command: npx skills add https://github.com/AlmogMaayan/ptp --skill ptp-full-almogmaayan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large feature or bug requests are too big to plan and implement in one pass, and manually chaining decomposition, plan review, code application, and code review across many slices is error-prone. This skill runs the entire pipeline in a single invocation with an automatic handoff between the planning and apply phases. ## Core Features & Use Cases - Plan-then-apply orchestration: Decomposes an oversized change into OpenSpec slices via plan-multiple, plan-reviews each slice, then applies and code-reviews them in dependency order without a second user invocation. - Dual convergence gates: A plan-convergence gate blocks the apply phase unless every slice's plan review converged, and an apply-convergence gate halts the run on any failed apply or review. - Auto re-cut on budget exceeded: Optionally re-cuts slices whose plan review halted on the artifact budget, with per-lineage depth and total-growth recursion caps. - Use Case: Hand a one-line oversized feature request to /ptp:full and receive implemented, dual-reviewed code across all decomposed slices, with Codex as an independent second reviewer when configured. ## Quick Start Run /ptp:full with a description of your oversized change or an existing OpenSpec change id to plan, review, and implement it end to end.

Frequently Asked Questions about ptp-full

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I plan and implement a large feature in one command?▼

Run /ptp:full with a one-line change description or an existing openspec/changes/<id> folder. It decomposes the work into slices via plan-multiple, plan-reviews each slice, then applies and code-reviews them in order without requiring a second invocation.

What is the difference between /ptp:full, /ptp:full-plan, and /ptp:full-apply?▼

/ptp:full is the union of the other two: full-plan decomposes and plan-reviews slices, full-apply applies and code-reviews them. /ptp:full runs both phases back to back, passing the planned slice ids explicitly so the apply phase skips its scope-confirmation stop.

Does ptp-full require the Codex CLI to run?▼

Codex is required only when codex.mode is set to required; if it is missing the command stops immediately with an install-or-change-mode message. Under auto or off modes the run proceeds, and each phase skips the Codex reviewer non-silently while the Claude reviewer always runs.

What happens when a slice's plan review does not converge?▼

Any slice ending in a non-green terminal state such as ITERATION CAP REACHED or ARTIFACT BUDGET EXCEEDED fails the plan-convergence gate, and the apply phase is never entered. With review.autoRecutOnBudgetExceeded enabled, budget-halted slices are automatically re-cut into smaller children subject to depth and growth caps.

Can ptp-full run slice reviews in parallel?▼

Yes, when the parallel posture resolves to on and all four ptp-parallel-fanout safety conditions hold, one review-plan-full member is fanned out per slice, capped by parallel.maxConcurrency. After joining, a cross-slice dependency recheck runs before the convergence gate is applied.

When should I not use /ptp:full for a change?▼

Avoid it for small, single-unit changes where the full decomposition and dual-gate orchestration adds overhead; a plain /ptp:plan and apply flow fits better. It is also unsuitable when you want to inspect plans before any code is applied, since the handoff to the apply phase is automatic once planning converges.