Skip to content

v0.9.0 — npx sam-agents demo: scaffold a working app in 90 seconds

Choose a tag to compare

View all tags
@santoshrout santoshrout released this 16 May 10:28
· 2 commits to main since this release
v0.9.0
a02ccdc

This release adds a zero-friction first-success command and a major README rewrite that leads with proof instead of feature lists.

What's new

npx sam-agents demo

npx sam-agents demo               # → ./sam-demo
npx sam-agents demo ./my-demo     # → ./my-demo
npx sam-agents demo --force ./x   # overwrite an existing directory

Clones sam-agents/example-todo into a target directory, strips .git, and prints next-step instructions. No LLM provider required — newcomers can see exactly what SAM produces in under 2 minutes, then npm install && npm run dev to see the app work.

Verified end-to-end: clone → install → both dev servers up → full CRUD against http://localhost:3001 → frontend on http://localhost:5174 returns HTML. All in under 2 minutes (mostly npm install).

README rewrite

  • New hero screenshot embedded from the example-todo Lens evidence
  • Replaced "Why SAM?" strawman table with "What makes SAM different" — three named differentiators (contracts-first, TDD-as-boundary, Lens evidence) with deep links into the example repo
  • New "How does it compare?" table naming actual alternatives (Cursor agents, Cline/Continue, Aider, Claude Code skills, Copilot Workspace, Devin) instead of comparing to a vague strawman
  • Compacted the per-agent table — 13 agents × 2 columns (was 12 × 6), per-platform paths consolidated into the existing invocation grid
  • Added extend workflow to the workflows table and invocation grid (was missing since 0.8.0)
  • Clarified that Lens runs after the integration story, not in the per-story TDD loop

Companion repo: sam-agents/example-todo

The end-to-end output of one SAM run, fully committed: PRD, contracts, stories, source, tests, and Lens evidence (screenshots, network log, console, video). Linked from the README as the proof artifact.

Discoverability

Repository topics added to both sam-agents/sam and sam-agents/example-todo. GitHub description updated to reflect the 5-platform support.

Internal

  • CLAUDE.md now documents the npm release process (GitHub Release triggers publish.yml).
  • Zero new runtime dependencies. The demo command uses only Node built-ins.

Known gaps

Replan is not yet supported. Today's workflows handle linear builds (plan → build-tdd) and additive iteration after v1 (extend), but mid-build requirement changes, feature removal, and tech-stack pivots have no formal workflow. This is the headline of the next release.

For mid-build changes today: edit the affected story or contract file directly and re-run build-tdd on the affected story. SAM does not yet detect impact across stories.

Upgrade

npx sam-agents@latest demo

No breaking changes for existing users.

Validated end-to-end

  • npx sam-agents demo → clone, install, dev, full CRUD, frontend serving — all green
  • npm test (4 verifiers) — all green
Assets 2
Loading