ptp-full-apply

Orchestrates sequential apply and review of planned change stories via a workflow script.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Applying and reviewing a large multi-story change one piece at a time is error-prone: stories can be applied out of order, reviews can be skipped, and a failed review can silently let later stories build on unreviewed code. This skill automates the per-story apply-then-review loop with a hard halt gate so every story converges before the next begins. ## Core Features & Use Cases - Sequential apply-review orchestration: Launches the ptp:ptp-full-apply workflow that runs each story's apply agent then review agent to completion, halting the whole run if any story fails to converge. - Per-story model and effort resolution: Reads each story's effort.md to derive apply and review model/effort targets, defaulting safely to opus.high when missing, with one bounded review escalation to a more capable model. - Codex second-reviewer gating and telemetry: Resolves codex.mode before launch (STOP under required without Codex) and appends per-agent telemetry ledger rows after the workflow returns. - Use Case: After planning an epic with several stories, run /ptp:full-apply to apply and dual-review every story in dependency order, then get a three-bucket terminal report with per-story review tallies and a resume command for anything unprocessed. ## Quick Start Ask Claude to run /ptp:full-apply with a change selector or explicit change ids to apply and review each planned story in order.

Frequently Asked Questions about ptp-full-apply

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

FAQPage Schema
How do I apply and review multiple planned changes in order?▼

Run /ptp:full-apply with explicit change ids, an epic: or story: selector, or no arguments to discover active changes via openspec list. The workflow applies each story fully, then runs its review, and only moves to the next story after the review converges.

What happens when a story review does not converge in full-apply?▼

The workflow halts the entire run at that story rather than continuing. The terminal report buckets stories into processed, applied (review pending), and never-started, and prints a resume command for the unprocessed tail.

Does full-apply require the Codex CLI to be installed?▼

Only when codex.mode resolves to required; then the command runs codex --version and stops without launching if Codex is missing. Under auto or off it launches normally, and each story's review skips the Codex phase non-silently as gate-success.

How does full-apply choose the model and effort for each story?▼

The command reads each story's effort.md and parses line 1 as model.effort, deriving the review target by flooring the model at sonnet and effort at high. A missing or unparseable file defaults to opus.high and is noted, never crashing the run.

Can a review escalate to a more capable model during a run?▼

Yes, exactly once per story. If a review's fix target names a more capable model, the workflow re-spawns that review at the escalated target and reads its terminal state; an escalation that cannot be honored halts the story with an explicit reason.

Why does full-apply stop for confirmation when run with no arguments?▼

With no ids it discovers all active changes, which may include unrelated or unplanned work, so it prints the resolved ordered list and stops before any apply. Re-invoking with the confirmed set or explicit ids proceeds without the gate.