long-running-agent

Translate SPEC.md into phase-based tasks with claude-task.json and claude-prompt.md.

10|1|Updated Feb 5, 2026
One-click install
npx skills add https://github.com/pbc-os/smb-starter-kit --skill long-running-agent-pbc-os
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: long-running-agent
Source: https://github.com/pbc-os/smb-starter-kit/tree/main/skills/tier-5-automation/long-running-agent
Command: npx skills add https://github.com/pbc-os/smb-starter-kit --skill long-running-agent-pbc-os

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Translate planning documents or specs into a phase-based task structure for autonomous multi-session execution, enabling AI agents to operate across multiple phases with explicit verification checkpoints and mode selection.

Core Features & Use Cases

  • Convert a planning document into a ready-to-run long-running agent setup, including claude-task.json, claude-prompt.md, and a preserved SPEC.md.
  • Support both orchestrator mode (autonomous operation across phase boundaries) and phase-checkpoint mode (human verification at phase boundaries).
  • Uses standardized templates and a structured workflow to decompose plans into phases and tasks with machine-checkable verifications.

Quick Start

Set up a long-running agent from a planning spec to run phase-based tasks autonomously.

Frequently Asked Questions about long-running-agent

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

FAQPage Schema
How do I convert a planning spec into an autonomous agent workflow?

To convert a planning spec into an autonomous agent workflow, this Skill reads your SPEC.md file and translates it into a structured phase-based task setup. It generates a claude-task.json and claude-prompt.md in your project root for multi-session execution.

Can an AI agent run autonomously across multiple phases without human verification?

Yes, an AI agent can run autonomously across multiple phases using the orchestrator mode. This mode allows the agent to operate continuously across phase boundaries without requiring human verification at each step.

How do I set up phase-based tasks with human verification checkpoints?

To set up phase-based tasks with human verification checkpoints, use the phase-checkpoint mode. This mode decomposes your spec into structured phases, pausing the autonomous workflow for explicit human verification at each phase boundary before proceeding.

What files do I need to generate a long-running agent from a planning document?

To generate a long-running agent from a planning document, you need a SPEC.md file in your repository. The workflow uses this input to output a claude-task.json, a claude-prompt.md, and the preserved SPEC.md in your project root.

What is the best way to structure multi-session execution for an autonomous agent?

The best way to structure multi-session execution for an autonomous agent is using a phase-based task structure with standardized templates. This approach decomposes plans into distinct phases and tasks equipped with machine-checkable verifications.

When should I use a long-running agent for phase-based work instead of a standard prompt?

You should use a long-running agent for phase-based work when your project requires multi-session execution with explicit verification checkpoints. It is designed for complex specs that need autonomous operation across multiple phases rather than single-prompt tasks.