paw-transition

Validate PAW workflow state and queue the next activity with a TRANSITION RESULT payload.

39|6|Updated Oct 8, 2025
One-click install
npx skills add https://github.com/lossyrob/phased-agent-workflow --skill paw-transition
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: paw-transition
Source: https://github.com/lossyrob/phased-agent-workflow/tree/main/skills/paw-transition
Command: npx skills add https://github.com/lossyrob/phased-agent-workflow --skill paw-transition

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

PAW requires safe, auditable transitions between workflow activities. The paw-transition skill acts as a gate to validate the current state, enforce session policies at stage boundaries, verify required artifacts exist, and decide the next activity to enqueue.

Core Features & Use Cases

  • Enforces session policy per stage or continuous flow during transitions.
  • Validates target branches and required artifacts (e.g., WorkflowContext.md, ImplementationPlan.md) before progression.
  • Determines and queues the next activity using the Mandatory Transitions table.
  • Performs Candidate Promotion checks for final PR and reports unresolved candidates for human review.
  • Produces a structured TRANSITION RESULT payload for the orchestrator, including session_action, pause_at_milestone, preflight, and next_activity details.

Quick Start

Trigger the paw-transition TODO to advance the PAW workflow. Ensure the current session and required artifacts are in place before activation.

Frequently Asked Questions about paw-transition

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

FAQPage Schema
How do I enforce session policy during workflow orchestration stage boundaries?

To enforce session policy at stage boundaries, a gated transition mechanism validates the current state and checks preflight requirements before progressing. This ensures continuous flow or per-stage policies are applied before moving to the next activity.

How do workflow orchestration systems validate required artifacts before advancing stages?

Workflow orchestration validates required artifacts by performing preflight checks that verify files like WorkflowContext.md and ImplementationPlan.md exist. This artifact readiness validation ensures safe, auditable transitions between activities before queuing the next task.

What is a gated workflow transition and when do I need it for activity orchestration?

A gated workflow transition is an automated validation step that decides the next activity to enqueue by checking current state, session policies, and artifact readiness. You need it when orchestrating multi-stage activities requiring safe, auditable progression.

How do I queue the next task in a workflow using the Mandatory Transitions table?

You queue the next task by triggering the transition TODO within a subagent session. The system uses the Mandatory Transitions table to determine the next activity, validates preflight conditions, and outputs a structured payload for the orchestrator.

Can I perform Candidate Promotion checks for final PRs during workflow transitions?

Yes, you can perform Candidate Promotion checks for final PRs during transitions. The system executes these checks and reports unresolved candidates for human review, outputting the results in a structured transition payload for the orchestrator.

What does a structured transition result payload include for workflow orchestrators?

A structured transition result payload includes session_action, pause_at_milestone, preflight status, and next_activity details. This payload provides the orchestrator with all necessary data to execute the validated workflow progression.