forge-convoy

Organize parallel tasks across workers with convoy groups and progress tracking.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Jtapias92672/OneDrive_1_1-19-2026-2 --skill forge-convoy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: forge-convoy
Source: https://github.com/Jtapias92672/OneDrive_1_1-19-2026-2/tree/main/mcp-gateway/.forge/skills/forge-convoy
Command: npx skills add https://github.com/Jtapias92672/OneDrive_1_1-19-2026-2 --skill forge-convoy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Organize and coordinate parallel tasks across multiple workers by grouping related work into convoys and tracking progress, reducing contention and retry complexity.

Core Features & Use Cases

  • Convoy data model with fields like id, name, figmaFileKey, frameId, tasks, status, created, updated, dependencies, and results to represent coordinated work bundles.
  • Support for parallel processing without direct agent-to-agent communication, using a ledger/beads-style coordination workflow.
  • Use cases include coordinating multiple Figma components, tracking progress across workers, and enabling resilient task execution across restarts.

Quick Start

Create a convoy from a Figma analysis and dispatch tasks to workers to begin parallel processing.

Frequently Asked Questions about forge-convoy

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

FAQPage Schema
How do I coordinate parallel tasks across multiple workers in a distributed system?

Parallel task coordination across multiple workers is handled by grouping related work into convoys, using a ledger-based pattern to track progress and manage dependencies without direct agent-to-agent communication. This reduces contention and retry complexity in distributed environments.

What is a convoy pattern for distributed task processing?

A convoy pattern for distributed task processing is a coordination model that groups related work bundles with fields like id, tasks, status, and dependencies. It enables parallel execution across workers while preserving audit trails and supporting failure-safe restarts.

How do I manage task dependencies and lifecycle states for parallel processing?

Task dependencies and lifecycle states are managed through a convoy data model tracking states from CREATED to IN_PROGRESS, BLOCKED, and COMPLETE. This ledger-based coordination ensures progress tracking and resilient execution across distributed worker restarts.

Can I track progress across distributed workers without direct agent-to-agent communication?

Yes, you can track progress across distributed workers without direct agent-to-agent communication by using a ledger or beads-style coordination workflow. The convoy model centralizes status updates and dependency management to avoid worker contention.

How do I enable failure-safe restarts for parallel task execution?

Failure-safe restarts for parallel task execution are enabled through ledger-based coordination patterns within the convoy model. This approach preserves audit trails and task states, allowing distributed workers to resume coordinated work without losing progress.

How do I coordinate multiple Figma components for parallel worker processing?

You can coordinate multiple Figma components by creating a convoy from a Figma analysis, using fields like figmaFileKey and frameId. This dispatches related component tasks to workers for parallel processing while tracking overall convoy progress.