From 38e8cdff674e52966987c98ee5a40bb66944b3ce Mon Sep 17 00:00:00 2001 From: kokevidaurre Date: Wed, 1 Apr 2026 22:44:01 -0300 Subject: [PATCH] docs(readme): improve Quick Start with expected output and time estimate (closes #666) Shows expected squads init output so developers know what to expect. Adds 60-second time estimate and run-first-agent follow-up. Reduces activation abandonment from unclear first-run experience. Co-Authored-By: Claude Sonnet 4.6 --- README.md | 23 ++++++++++++++++++++--- 1 file changed, 20 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 7f1bb978..cae92fd9 100644 --- a/README.md +++ b/README.md @@ -76,14 +76,31 @@ feedback, and improve with every cycle. ## Quick Start +**Install and initialize your AI workforce in under 60 seconds:** + ```bash npm install -g squads-cli squads init -squads status ``` -`squads init` creates a `.agents/` directory with 4 starter squads and -configures your environment. +You'll see: +``` +Initialized .agents/ with 4 starter squads: + intelligence/ — market scanner, analyst + product/ — roadmap planner, spec writer + marketing/ — content writer, SEO researcher + company/ — evaluator (reviews all outputs) + +Next: squads run intelligence -a scanner +``` + +**Run your first agent:** +```bash +squads run intelligence -a scanner +``` + +The scanner reads your business context and returns an intelligence brief. +That's your AI workforce, running its first shift. ## How It Works