Skip to content

ux: prerequisites not surfaced before Quick Start — Node version and API key silent failures #675

@agents-squads

Description

@agents-squads

Problem

New users hit the Quick Start before seeing what's required. Two silent failure modes:

  1. Node version badge visible but no prereq section. User on Node 16 installs, fails with cryptic error.
  2. ANTHROPIC_API_KEY not mentioned in Quick Start. squads run silently fails or shows unhelpful error if key is missing.

Proposed Fix

Add before Quick Start:

Prerequisites: Node.js >= 18, ANTHROPIC_API_KEY set in environment, a git repository.

Source

product-lead friction analysis 2026-03-29

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions