inter-squad-signals

Coordinate cross-squad work using JSON files in inbox and outbox directories.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/lygav/vladi-plugins-marketplace --skill inter-squad-signals
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: inter-squad-signals
Source: https://github.com/lygav/vladi-plugins-marketplace/tree/main/plugins/squad-federation-core/skills/inter-squad-signals
Command: npx skills add https://github.com/lygav/vladi-plugins-marketplace --skill inter-squad-signals

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coordinating cross-squad work through a reliable, file-based signaling protocol that eliminates the need for shared memory or network calls, while keeping signals auditable and version-controlled.

Core Features & Use Cases

  • File-based signaling stores JSON messages on disk under {worktree}/.squad/signals/inbox and /outbox for directives, questions, and reports.
  • Inbox/outbox semantics with status.json and acknowledgments to synchronize processing between meta-squad and domain squads.
  • Optional telemetry integration and strict state lifecycle definitions to enable observability and guardrails.

Quick Start

Start by initializing a domain worktree and monitoring the signals directory to begin exchanging directives and reports.

Frequently Asked Questions about inter-squad-signals

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

FAQPage Schema
How do I coordinate cross-squad communication without network services?

You can coordinate cross-squad communication by using a file-based signaling protocol that stores JSON messages in local inbox and outbox directories. This enables reliable directive and report exchange without any network dependencies.

What is file-based signaling for cross-squad workflows?

File-based signaling is a coordination mechanism that uses JSON files stored on disk to orchestrate directives, questions, and reports. It eliminates the need for shared memory or network calls while keeping signals auditable and version-controlled.

How do I track signal status and acknowledgments across multiple squads?

You can track signal status and acknowledgments using a status.json file combined with structured SignalMessage interfaces. These synchronize processing between meta-squads and domain squads within each worktree's signals directory.

Can I use JSON file signals for offline and auditable squad coordination?

Yes, file-based JSON signals are designed specifically for offline operation and auditability. Storing structured messages in local directories enables version-controlled tracking of cross-squad directives and reports without requiring network services.

How do I set up local inbox and outbox directories for squad signal exchange?

You set up signal exchange by initializing a domain worktree and creating inbox and outbox directories under the .squad/signals path. Domain squads then write structured JSON messages to these directories to respond to directives.

Does file-based cross-squad signaling support telemetry and state machine definitions?

Yes, the protocol supports optional telemetry integration for observability and rigorous state lifecycle definitions through archetype plugins. These features provide monitoring capabilities and processing guardrails for signal messages.