skills.rest
indigoai-us
indigoai-usOFFICIAL
Explore all skills by this author →
WebsiteGitHub

run-project

Dispatch per-story Task sub-agents to execute PRD projects inline.

Updated Aug 27, 2026
Search Tags:#workflow#claude#prd#orchestrator#inline-execution#run-project#task-subagents
One-click install
npx skills add https://github.com/indigoai-us/hq --skill run-project
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: run-project
Source: https://github.com/indigoai-us/hq/tree/main/template/.claude/skills/run-project
Command: npx skills add https://github.com/indigoai-us/hq --skill run-project

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Inline execution of PRD stories across multiple stories by dispatching per-story Task sub-agents, enabling controlled, per-story orchestration.

Core Features & Use Cases

  • Inline execution by default with per-story Task sub-agents
  • Optional Ralph mode for background orchestration using nohup scripts/run-project.sh + state-file polling
  • Session-mode execution for plan-file anchored workflows

Quick Start

Invoke run-project with a project name to start inline execution of its PRD stories.

Frequently Asked Questions about run-project

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

FAQPage Schema
How do I automate inline execution of PRD stories using per-story agents?▼

Inline execution of PRD stories is automated by dispatching per-story Task sub-agents, which individually handle each story's lifecycle. This enables controlled, per-story orchestration across multiple PRD cycles without manual intervention.

What is Ralph-mode background orchestration for PRD project workflows?▼

Ralph-mode background orchestration runs PRD projects using nohup scripts and state-file polling. This mode initializes an orchestrator to route execution in the background, allowing continuous processing without keeping the main session active.

Do I need a PRD file present before starting per-story task orchestration?▼

Yes, a PRD file must be present before starting. The workflow validates PRD presence as a preflight step before initializing the orchestrator and routing any execution modes or planning steps.

How does session-mode execution handle plan-file anchored workflows?▼

Session-mode execution anchors workflows to a plan file across PRD cycles. It routes execution using specific flags to maintain session continuity, ensuring preflight, planning, and completion steps remain aligned with the plan file.

What is the best way to manage multiple PRD stories concurrently?▼

Managing multiple PRD stories concurrently is best handled by dispatching per-story Task sub-agents. This approach provides controlled orchestration for each story independently, allowing parallel processing while maintaining individual execution integrity.

Why does my PRD project execution fail before planning starts?▼

PRD project execution fails before planning if the preflight validation does not detect a PRD file. The orchestrator requires valid PRD presence to initialize and route execution modes, preventing progression without the necessary input.

Related Skills

Explore More Software Engineering Skills→
vladm3105vladm3105
16

doc-validator

Validate cross-document traceability and integrity across SDD framework documents.

Community
Intermediate
keugenekkeugenek
12

shark-status

Check Shark background job status, completed results, and recent logs.

Community
Basic
YellowDusk04YellowDusk04
29

eino-agent

Design Eino agent workflows with Skills, middleware, sub-agents, and model routing.

Community
Advanced
IT-HUSETIT-HUSET
3

exec-plan

Execute plan pipelines by running exec-spec and quick-review per story.

Official
Advanced