v0.2.1 — First-Run Experience

What's in this release

v0.2.1 is a complete reset of the first-run experience. A new user with no existing project can install, init, and run a real AI agent in under 5 minutes:

```bash
npm install -g squads-cli
mkdir my-project && cd my-project && git init
squads init --yes
squads run research/lead
```

---

What squads init now creates

Every new project gets 4 core squads out of the box:

Squad	Purpose
research	Market and competitive intelligence
company	Internal knowledge and documentation
intelligence	Signal monitoring and synthesis
product	Product feedback and roadmap tracking

Each squad ships with a lead agent, a default brief, and working priorities — ready to run without additional configuration. The scaffolding is auto-committed so agents can immediately use git worktrees for parallel execution.

---

Context Cascade

Agents resolve context in a defined order, from most stable to most volatile:

SYSTEM.md → SQUAD.md → priorities.md → directives.md → state.md

Earlier files set constraints; later files override specifics. Update priorities.md and agents pick it up on the next run — no need to touch squad definitions.

---

Role-Based Context Injection

Each agent role receives a different context slice, keeping agents fast and appropriately scoped:

Role	Context received
Scanner	System + squad definition + current state
Worker	+ priorities, directives, feedback
Lead / COO	Full chain including cross-squad learnings

---

Phase-Ordered Execution

SQUAD.md frontmatter now supports depends_on — declare which squads must finish before this one starts. The org cycle respects these dependencies when scheduling execution waves.

---

Other Changes

• squads run is now the single entry point, replacing the old squads auto start
• gh CLI is optional — missing GitHub CLI shows a warning instead of a hard error
• Platform-agnostic install hints (no more macOS-specific suggestions on Linux)

---

Install

```bash
npm install -g squads-cli
```

Full changelog: v0.6.2...v0.2.1