prd-loop

Externalizes orchestration cycle state into LOOP-STATE.md and updates batch pointers, debt counters, fan-out registry, decisions, signatures, and summaries.

2|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/yesplease-studio/prd-please --skill prd-loop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prd-loop
Source: https://github.com/yesplease-studio/prd-please/tree/main/skills/prd-loop
Command: npx skills add https://github.com/yesplease-studio/prd-please --skill prd-loop

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill externalizes and manages the project's orchestration loop state (LOOP-STATE.md) to decouple the implement‑validate‑learn‑apply cycle from user conversations, ensuring continuity across sessions.

Core Features & Use Cases

  • Externalize loop state into LOOP-STATE.md at the project scope.
  • Read and update: Batch pointer, debt counters, fan-out registry, decision queue, and workaround signatures.
  • Support Stepwise orchestration across impl/validate/learn/apply/commit phases and provide status summaries.

Quick Start

Initialize the loop state for a project by creating LOOP-STATE.md at the project scope with the required skeleton.

Frequently Asked Questions about prd-loop

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

FAQPage Schema
How do I persist project orchestration loop state across multiple sessions?

To persist project orchestration loop state across sessions, you externalize cycle metadata into a LOOP-STATE.md file at the project scope, allowing implement-validate-learn-apply phases to decouple from individual user conversations.

What is the best way to track technical debt counters during a build process?

Tracking technical debt counters during a build process involves reading and updating a centralized loop state file, which maintains debt metrics alongside batch pointers and decision queues to ensure continuity.

How do I initialize loop state for stepwise workflow orchestration?

To initialize loop state for stepwise workflow orchestration, create a LOOP-STATE.md file at the project scope with the required skeleton, enabling the system to track impl, validate, learn, apply, and commit phases.

Can I read and update fan-out registry and decision queue state without losing session context?

You can read and update fan-out registry and decision queue state without losing context by externalizing the data into LOOP-STATE.md, which sustains the workflow orchestration loop beyond a single session.

When do I need to externalize workaround signatures and batch pointers?

You need to externalize workaround signatures and batch pointers when starting orchestration cycles or when sub-skills read and write state, ensuring that cycle metadata and work signatures persist continuously.

Does this state management approach provide a summary of the current loop position?

This state management approach produces a summary line after every state update, allowing users to quickly query and understand the current loop position across all tracked build cycle items.