🛰️ subagent-crews

subagent-crews is a high-performance plugin for GitHub Copilot CLI and Gemini CLI. It packages hierarchical custom agents and autonomous skills into streamlined workflows for complex engineering tasks.

Tip

Use task-execution for direct implementation of well-defined work, and parliament for solving architectural or strategic problems through multi-agent debate.

---

🚦 Choose Your Mode

Mode	Use When...	Lead Role
task-execution	The goal is clear and needs implementation	crew-task-manager
parliament	The approach itself needs discussion/alignment	crew-parliament-chairman

---

🛠️ Repository Map

Directory	Purpose
agents/	Core agent definitions (.agent.md) and registry
skills/	Autonomous workflow behavior definitions (SKILL.md)
hooks/	Deterministic validation logic and lifecycle hooks
docs/	Centralized documentation hub and examples
scripts/	Operational utilities, validation, and maintenance
dashboard/	Source for the real-time agent execution dashboard

---

⚡ Quick Start

1. GitHub Copilot Extension (Recommended)

Install the subagent-crews plugin directly into your GitHub CLI:

copilot plugin install tamara1031/subagent-crews

2. Manual Installation (CLI & Development)

If you prefer a standalone setup or are developing new agents:

# Clone and enter the repository
git clone https://github.com/tamara1031/subagent-crews.git
cd subagent-crews

# Setup virtual environment and dependencies
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

3. Initialization & Verification

Once installed, bootstrap your workspace and verify the environment:

make init      # Bootstrap .crews/ workspace from templates
make check     # Run validation and tests

4. Launch Dashboard

Monitor your agents in real-time by launching the execution dashboard:

make dashboard # Start at http://127.0.0.1:8000

---

📑 Canonical Documentation

• Documentation Hub — Entry point for standards, hooks, and examples.
• Parliament Skill — Debate-driven orchestration spec.
• Task Execution Skill — Execution-focused workflow spec.

---

🧩 Integration Surfaces

Integration	File	Description
GitHub Copilot	plugin.json	Main entry point for Copilot Extension
Gemini CLI	gemini-extension.json	Manifest for Gemini CLI Tooling

---

⌨️ Makefile Shortcuts

Command	Action
make help	List all available targets
make dashboard	Launch the local execution dashboard
make test	Run the full validation and script test suite
make check	Run all linting and validation checks

---

Last Updated: 2026-03-29