run-execute

Execute FIRE work items by mode with YAML state and artifact updates.

201|19|Updated Dec 24, 2025
One-click install
npx skills add https://github.com/fabriqaai/specs.md --skill run-execute-fabriqaai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: run-execute
Source: https://github.com/fabriqaai/specs.md/tree/main/src/flows/fire/agents/builder/skills/run-execute
Command: npx skills add https://github.com/fabriqaai/specs.md --skill run-execute-fabriqaai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yaml, and includes scripts (resource) components.

What problem does it solve?

This skill automates the execution of work items by their assigned mode (autopilot, confirm, validate), enabling deterministic runs across single-item and batch/wide scenarios in the FIRE workflow.

Core Features & Use Cases

  • Deterministic run orchestration: initializes runs, tracks state, updates frontmatter and run.md as work items progress.
  • Batch and single-item support: coordinates planning, execution, testing, and review for multiple items in a run, ensuring consistent artifact generation.
  • Artifact synchronization: creates plan.md, test-report.md, review-report.md, and updates item statuses and intents to reflect progress across the run.

Quick Start

  • Start a single-item run: node scripts/init-run.cjs <rootPath> <workItemId> <intentId> <mode>
  • Start a batch run: node scripts/init-run.cjs <rootPath> --batch '[{"id":"wi-1","intent":"int-1","mode":"autopilot"}]'
  • Complete the current item: node scripts/complete-run.cjs <rootPath> <runId> --complete-item
  • Complete the entire run: node scripts/complete-run.cjs <rootPath> <runId> --complete-run

Frequently Asked Questions about run-execute

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

FAQPage Schema
How do I execute work items in batch mode within the FIRE framework?

Deterministic run orchestration coordinates batch execution by initializing a run with a JSON array of work items, tracking state via YAML frontmatter, and updating run logs to ensure consistent artifact generation across all items.

What are the differences between autopilot, confirm, and validate execution modes?

Autopilot, confirm, and validate execution modes control run determinism by dictating whether work items process autonomously, require manual approval at specific stages, or need explicit validation before progressing.

Can I use YAML frontmatter for state management during work item execution?

Yes, YAML frontmatter manages execution state by tracking work item progress; the skill uses the 'yaml' library to parse and manipulate state files, updating statuses and intents as items move through planning, testing, and review.

How do I generate and synchronize artifacts like test reports and plan files?

Artifact synchronization occurs during the execution lifecycle by automatically generating plan.md, test-report.md, and review-report.md files while updating YAML frontmatter to reflect current item statuses and intents across the run.

Does this skill support single-item runs alongside batch wide execution?

Yes, the skill supports both single-item and batch wide execution, allowing you to initialize individual runs by specifying a single work item ID and intent, or coordinate wide batch runs containing multiple items simultaneously.