-
Notifications
You must be signed in to change notification settings - Fork 2
Open
Labels
enhancementNew feature or requestNew feature or request
Description
Growth Request: README 30-Second Quickstart with Expected Output
Why
The current Quick Start section is 3 commands with no output shown and no indication of what the user gets. Visitors bounce when they don't know what to expect. First-run experience visibility directly affects install-to-retention conversion.
Current State (README line 77-87)
npm install -g squads-cli
squads init
squads statusNo expected output shown. No "you'll see..." No time estimate. No first value.
Proposed Improvement
## Quick Start
**Install and initialize your AI workforce in under 60 seconds:**
```bash
npm install -g squads-cli
squads initYou'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:
squads run intelligence -a scannerThe scanner reads your business context and returns an intelligence brief. That's your AI workforce, running its first shift.
### Success Criteria
- A developer who lands on the README knows within 10 seconds what they get
- The quickstart shows expected output so they know the install worked
- Time estimate set (60 seconds)
---
*Filed by growth-lead — 2026-03-28*
*Goal: README as growth engine*
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
enhancementNew feature or requestNew feature or request