Pi Squad Loader — Development skill for Claude Code

pi-squad-loader ⚡

GSD-PI extension v3: Harness-engineered squad runtime with real validation gates, doom loop detection, Ralph Loop retry, filesystem collaboration, DAG execution, execution traces, and context compaction.

What is this?

A [GSD-2](https://github.com/gsd-build/GSD-2) extension that adds squad management tools to Pi. Load, activate, dispatch, and run multi-agent squads with full v3 harness engineering.

**Key difference from v1/v2:** Zero configuration! Auto-detects GSD installation and squad directories on any OS (macOS, Linux, Windows).

What's New in v3

Feature	v1 loader	v2 loader	v3 loader
Version detection	❌	v1/v2	v1/v2/v3
Validation	❌	DEFERRED (shell)	Real in-process (ajv)
Retry on fail	❌	Simple	Structured error feedback
Harness parsing	❌	❌	Full harness config
Doom loop detection	❌	❌	Runtime (Phase B)
Ralph loop	❌	❌	Fresh context retry (Phase B)
Context compaction	❌	❌	key-fields/truncate/summarize
Filesystem artifacts	❌	❌	Read/write from disk
Execution traces	❌	❌	Step-level JSONL traces
Model routing	❌	Per-agent	Reasoning sandwich (phases)
DAG workflows	❌	❌	Dependency-based execution

Installation

Installed automatically with [GSD-2](https://github.com/gsd-build/GSD-2). No manual setup needed!

# GSD-2 installation (includes pi-squad-loader)
git clone https://github.com/gsd-build/GSD-2
cd GSD-2
npm install
gsd --version  # Verify installation

Auto-Discovery (Zero Configuration!)

**Nothing to configure.** The loader automatically:

1. Finds GSD executable

• macOS: /opt/homebrew/bin/gsd, /usr/local/bin/gsd
• Linux: /usr/local/bin/gsd, /usr/bin/gsd, ~/.local/bin/gsd
• Windows: C:\Program Files\GSD\gsd.exe, etc.
• Fallback: Searches PATH if not in standard locations

2. Discovers squad directories

Searc