Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,15 @@ All notable changes to this project will be documented in this file.

## [Unreleased]

## [1.0.0] - 2026-10-02

Squad CLI and SDK (the `@bradygaster/squad-cli` and `@bradygaster/squad-sdk` npm packages) graduate to 1.0.0. This is a stabilization release: there are no breaking API or command changes from 0.13.1. It marks the npm packages as stable per the project's independent per-package versioning policy (distinct from the already-stable `Squad.Agents.AI` NuGet package, which reached 1.0.0 separately in #2143).

### Changed

- Removed the blanket "Experimental — Squad is alpha software" disclaimer banner from 87 documentation pages under `docs/src/content/docs/**`. Genuine preview-channel and feature-specific warnings (SDK-first mode, GitLab Issues Mode, the plugin security MVP gate, and preview/insider release channels) are unchanged and still documented.
- `@bradygaster/squad-cli`'s declared dependency floor on `@bradygaster/squad-sdk` is now `>=1.0.0` (previously `>=0.11.0`), reflecting the SDK's own stabilization.

## [0.13.1] - 2026-08-26

### Fixed
Expand Down
3 changes: 0 additions & 3 deletions docs/src/content/docs/concepts/what-is-squad.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
# What is Squad?

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.

Squad is an AI multi-agent orchestration framework that lives inside your repository. It coordinates a team of specialist AI agents, each with a defined role, persistent memory, and a charter that governs what it can and cannot do. Squad extends your team at agentic speed while keeping a human in charge of every meaningful decision.

## What is Squad?
Expand Down Expand Up @@ -126,4 +124,3 @@ Squad is built on the principle that agentic systems must remain under human con

Agents in Squad propose, draft, and record. Humans review, approve, and are accountable for final output. The governance features built into Squad, including reviewer lockout, escalation points, and auditable decision logs, are not optional settings. They are part of the framework's design contract. Squad extends human teams at scale; it doesn't remove the human from the loop.


3 changes: 0 additions & 3 deletions docs/src/content/docs/cookbook/recipes.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
# Recipes & Advanced Scenarios

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.


A compact cookbook of prompts, patterns, and power moves. Each recipe is a prompt you can paste straight into Squad.

---
Expand Down
2 changes: 0 additions & 2 deletions docs/src/content/docs/features/capability-routing.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,6 @@ order: 35

# Capability Routing

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.

**Try this to declare machine capabilities:**
```
This machine has a GPU — tag it for GPU-required work
Expand Down
3 changes: 0 additions & 3 deletions docs/src/content/docs/features/ceremonies.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
# Ceremonies

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.


**Try this to schedule team ceremonies:**
```
Schedule a daily standup at 9am and a sprint retro every Friday
Expand Down
3 changes: 0 additions & 3 deletions docs/src/content/docs/features/cleanup.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
# Cleanup Watch

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.


**Try this to trigger a cleanup cycle:**
```
squad watch --execute
Expand Down
3 changes: 0 additions & 3 deletions docs/src/content/docs/features/consult-mode.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
# Consult Mode

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.


Consult mode lets you bring your personal squad to projects you don't own — OSS contributions, client work, temporary collaborations — without leaving any trace. Your team consults, does the work, learns things, and returns home with only the generic learnings you approve.

---
Expand Down
3 changes: 0 additions & 3 deletions docs/src/content/docs/features/context-hygiene.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
# Context Hygiene: Nap, Reskill, and Compact

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.


**Try this to compact your team's memory:**
```
Team, take a nap
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,6 @@ description: Compile your squad's coordinator into a repo-native Copilot custom

# Coordinator-as-Agent Export

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.

**Try this to generate a coordinator agent:**
```bash
squad export agent
Expand Down
3 changes: 0 additions & 3 deletions docs/src/content/docs/features/copilot-coding-agent.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
# Copilot Coding Agent (@copilot)

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.


Add the GitHub Copilot coding agent to your Squad as an autonomous team member. It picks up issues, creates branches, and opens PRs — all without a Copilot chat session.

---
Expand Down
2 changes: 0 additions & 2 deletions docs/src/content/docs/features/copilot-mcp-trust.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
# Copilot CLI Non-Interactive MCP Trust Gate

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.

When `squad watch` or another Squad automation spawns `copilot -p` (non-interactive mode), it automatically injects `--yolo --additional-mcp-config @.mcp.json` into every Copilot sub-invocation. This page explains why that injection is mandatory and what to do if `squad_state_*` tools are silently unavailable.

---
Expand Down
2 changes: 0 additions & 2 deletions docs/src/content/docs/features/cost-tracking.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
# Token Usage & Cost Tracking

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.

Squad can track token usage and estimated cost for each agent spawn, roll that data up by session, and expose it through orchestration logs, terminal summaries, and telemetry backends.

---
Expand Down
2 changes: 0 additions & 2 deletions docs/src/content/docs/features/cross-squad-discover.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,6 @@ description: Discover other squads across repository boundaries and delegate wor

# Cross-Squad Discover & Delegate

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.

**Try this to see what squads you can reach:**
```bash
squad discover
Expand Down
3 changes: 0 additions & 3 deletions docs/src/content/docs/features/directives.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
# Directives

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.


**Try this to establish team coding standards:**
```
From now on, all tests must use Jest instead of Mocha
Expand Down
2 changes: 0 additions & 2 deletions docs/src/content/docs/features/distributed-mesh.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
# Distributed Mesh

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.

**Try this to coordinate squads across machines:**
```
Set up a distributed mesh so my local squad can see the state of our CI squad
Expand Down
2 changes: 0 additions & 2 deletions docs/src/content/docs/features/dual-mode-deployment.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,6 @@ description: Run Squad in either agent-per-node or squad-per-pod deployment mode

# Dual-Mode Deployment — Pod-Aware Capabilities

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.

Dual-mode deployment extends [Capability Routing](/squad/docs/features/capability-routing/) to support both classic single-machine setups and modern containerized/Kubernetes deployments where multiple Squad pods may share an organization's workload — each with potentially different machine capabilities.

It introduces two environment variables and a pod-specific manifest lookup pattern so the same Squad config can run identically in either deployment shape.
Expand Down
2 changes: 0 additions & 2 deletions docs/src/content/docs/features/error-recovery.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,6 @@ description: Built-in skill teaching agents to adapt when things fail — retry

# Error Recovery — Standard Failure Patterns

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.

The `error-recovery` skill teaches every squad agent to **adapt** when something fails, not just report the failure. It ships as a built-in skill at `.copilot/skills/error-recovery/SKILL.md` and is available to every spawned agent.

Without this skill, agents tend to encounter a failure (CI test red, API timeout, missing dependency) and stop. With it, they apply standard patterns to diagnose, retry, or escalate the right way.
Expand Down
3 changes: 0 additions & 3 deletions docs/src/content/docs/features/export-import.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
# Export & Import

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.


**Try this to make your team portable:**
```
Export my team to a file — I want to use them on another project
Expand Down
3 changes: 0 additions & 3 deletions docs/src/content/docs/features/external-state.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
# External State Storage

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.


**Try this to move state outside the working tree:**
```bash
squad externalize
Expand Down
2 changes: 0 additions & 2 deletions docs/src/content/docs/features/fleet-dispatch.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,6 @@ description: Hybrid dispatch mode for squad watch that batches read-heavy issues

# Fleet Dispatch — Parallel Issue Triage

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.

**Try this for parallel read-heavy issue triage:**
```bash
squad watch --execute --dispatch-mode fleet
Expand Down
3 changes: 0 additions & 3 deletions docs/src/content/docs/features/github-issues.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
# GitHub Issues Mode

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.


**Try this to connect to your backlog:**
```
Show me the open issues for this repo
Expand Down
3 changes: 0 additions & 3 deletions docs/src/content/docs/features/human-team-members.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
# Human Team Members

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.


**Try this to add a human specialist:**
```
Add Sarah (sarah@example.com) as a frontend developer to the team
Expand Down
3 changes: 0 additions & 3 deletions docs/src/content/docs/features/issue-templates.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
# Issue Templates for Squad

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.


**Try this after setting up templates:**
```
Ralph, show me untriaged issues
Expand Down
2 changes: 0 additions & 2 deletions docs/src/content/docs/features/keda-scaling.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,6 @@ order: 38

# KEDA Autoscaling

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.

**Try this to understand your scaling needs:**
```
How many issues are currently queued for Squad agents?
Expand Down
3 changes: 0 additions & 3 deletions docs/src/content/docs/features/labels.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
# Label Taxonomy

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.


**Try this to apply workflow labels:**
```
Apply the go:yes label to issue #42 and target it for v0.5.0
Expand Down
2 changes: 0 additions & 2 deletions docs/src/content/docs/features/loop.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
# Loop — Prompt-driven work loop

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.

**Try this to initialize a loop:**
```
squad loop --init
Expand Down
3 changes: 0 additions & 3 deletions docs/src/content/docs/features/marketplace.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
# Marketplace Guide

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.


**Issue:** #39 (M5-16)

---
Expand Down
2 changes: 0 additions & 2 deletions docs/src/content/docs/features/mcp-frontmatter.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,6 @@ description: Write MCP server configuration directly into the Squad agent file's

# MCP Frontmatter — `squad init --mcp-frontmatter`

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.

**Try this when your agent harness reads frontmatter-level MCP config:**
```bash
squad init --mcp-frontmatter
Expand Down
3 changes: 0 additions & 3 deletions docs/src/content/docs/features/mcp.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
# MCP Setup Guide for Squad

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.


**Try this to discover available integrations:**
```
Show me which MCP servers are available
Expand Down
3 changes: 0 additions & 3 deletions docs/src/content/docs/features/memory.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
# Memory System

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.


**Try this to query team decisions:**
```
What decisions has the team made about testing strategy?
Expand Down
3 changes: 0 additions & 3 deletions docs/src/content/docs/features/model-selection.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,6 @@ order: 34

# Per-Agent Model Selection

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.


**Try this to set a persistent preference (survives across sessions):**
```
Always use Opus
Expand Down
2 changes: 0 additions & 2 deletions docs/src/content/docs/features/notification-level.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
# Notification Level

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.

**Try this to silence empty rounds:**
```
squad watch --notify-level important
Expand Down
3 changes: 0 additions & 3 deletions docs/src/content/docs/features/notifications.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
# Squad pings you

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.


**Try this to get notified on completion:**
```
Notify me when the build finishes
Expand Down
3 changes: 0 additions & 3 deletions docs/src/content/docs/features/parallel-execution.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
# Parallel Execution

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.


**Try this to launch concurrent work streams:**
```
Have three agents work on this in parallel: UI mockups, API spec, and database schema
Expand Down
2 changes: 0 additions & 2 deletions docs/src/content/docs/features/plugins.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
# Plugin Marketplace Guide

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.

Plugins package reusable Squad capabilities: agents, knowledge packs, workflows, ceremonies, memory providers, routing guidance, decisions, hook metadata, adapter metadata, typed provider contracts, and generated knowledge artifacts.

The everyday flow is simple:
Expand Down
2 changes: 0 additions & 2 deletions docs/src/content/docs/features/preset.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,6 @@ description: Save, share, and apply pre-configured agent rosters across projects

# Presets — Curated Agent Collections

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.

**Try this to see available presets:**
```bash
squad preset list
Expand Down
3 changes: 0 additions & 3 deletions docs/src/content/docs/features/project-boards.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
# Project Boards

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.


**Try this to visualize workflow tracking:**
```
Create a project board for v0.5.0 with columns for each workflow stage
Expand Down
2 changes: 0 additions & 2 deletions docs/src/content/docs/features/rate-limiting.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,6 @@ order: 36

# Rate Limiting

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.

**Try this to check rate limit status:**
```
What's our current API rate limit headroom?
Expand Down
2 changes: 0 additions & 2 deletions docs/src/content/docs/features/reflect.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,6 @@ description: Built-in skill that extracts HIGH/MED/LOW confidence patterns from

# Reflect — In-Session Learning Capture

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.

The `reflect` skill is a built-in capability that turns every user correction into a learning opportunity. Agents invoke `reflect` after critical conversation moments — corrections, praise, edge-case discoveries — to capture patterns that prevent repeating mistakes across sessions.

It ships at `.copilot/skills/reflect/SKILL.md` and is automatically available to every spawned agent. The skill complements the existing knowledge layers (`history.md`, `decisions.md`) by capturing **in-flight** learnings that may later graduate to permanent memory.
Expand Down
3 changes: 0 additions & 3 deletions docs/src/content/docs/features/remote-control.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
# Squad Remote Control

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.


Control Copilot CLI from your phone via a secure WebSocket tunnel. Perfect for demos, pairing on mobile, or monitoring runs from anywhere.

```bash
Expand Down
3 changes: 0 additions & 3 deletions docs/src/content/docs/features/response-modes.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
# Response Modes

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.


**Try this to get concise answers:**
```
Respond in terse mode — just the facts
Expand Down
3 changes: 0 additions & 3 deletions docs/src/content/docs/features/reviewer-protocol.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
# Reviewer Rejection Protocol

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.


**Try this to request a code review:**
```
Review the changes in src/auth/ and check for security issues
Expand Down
3 changes: 0 additions & 3 deletions docs/src/content/docs/features/routing.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
# Work Routing

> ⚠️ **Experimental** — Squad is alpha software. APIs, commands, and behavior may change between releases.


**Try this to set domain-specific routing:**
```
Route all database-related work to Basher
Expand Down
Loading
Loading