Skip to content

copy: retire the withdrawn headline frame from the product and npm - #1226

Open
agents-squads[bot] wants to merge 1 commit into
developfrom
copy/retire-withdrawn-frame
Open

copy: retire the withdrawn headline frame from the product and npm#1226
agents-squads[bot] wants to merge 1 commit into
developfrom
copy/retire-withdrawn-frame

Conversation

@agents-squads

@agents-squads agents-squads Bot commented Aug 13, 2026

Copy link
Copy Markdown
Contributor

Closes #1225

Why

The headline frame withdrawn on 2026-07-30 was still shipping in user-facing output and, through package.json, on the public npm listing. Founder direction 2026-08-13 tightens the rule: never say the product replaces humans — the frame is booting developers, capacity added to a person rather than headcount removed. Recorded in hq CLAUDE.md §Mission and _POSITIONING.md §Direction.

What changed — two classes, deliberately separate

1. Tagline (README, package.json, squads --help) — a positioning statement:

Boot AI teammates for the work you never get around to.

This one needs your sign-off before the next publish. The npm description only refreshes on release, so nothing reaches the public listing until a release goes out — there is time to change it.

2. In-product strings — these need no frame at all, so they now state what happened rather than claiming anything:

Where Now says
squads init completion "'s squads are ready."
init seed prompt "Plant the seed for your squads"
commit message init writes into the user's repo feat: init agent squads
insights.ts ×4 "Your squads delivered…", "No squad activity…"
stats header "Squad Intelligence"

Seed templates matter most here: they are copied into the user's own repository on squads init, so the withdrawn frame was propagating into customer projects — CLAUDE.md.template, README.md.template, the demo squad, and the bundled skill.

The two tests that asserted the banned string are updated in the same commit, since they would otherwise fail the moment it was removed.

A real bug caught on the way

The README quickstart had drifted to mkdir my-workforce && cd my-squads mid-edit — the two no longer agreed, which would fail on a user's first command. Fixed and the block re-read end to end.

Verification

squads --help from the built dist now shows the new line, and grep -i "workforce" across src/, test/, templates/, docs/, README and package.json returns nothing.

Full suite: 2558 pass. The 9 failures are pre-existing and unrelated — 8 in test/commands/status.test.ts (uncommitted WIP adds byTool to getSessionSummary without updating the mock) and 1 from the #838 flaky cluster, which names a different test on each full-suite run and passes in isolation.

🤖 Generated with Claude Code

Closes #1225

Founder direction 2026-08-13: never say the product replaces humans — the
frame is "booting developers", capacity added to a person rather than headcount
removed. Recorded in hq CLAUDE.md §Mission and _POSITIONING.md §Direction.

The withdrawn frame was still shipping in user-facing output and, via
package.json, on the public npm listing. Removed from all 23 occurrences:

- Tagline (README, package.json, `squads --help`):
  "Boot AI teammates for the work you never get around to."
  PENDING founder sign-off before the next publish — the npm listing only
  refreshes on release, so nothing goes public until then.
- In-product strings (`init` output, insights, `stats` header, the commit
  message `init` writes into the USER's repo): these need no frame at all, so
  they now state what happened — "your squads are ready".
- Seed templates: these are copied into the user's own repository on
  `squads init`, so the frame was propagating into customer projects.
- The two tests that asserted the banned string.

Also fixes a real quickstart break introduced while editing: the README
`mkdir`/`cd` pair had drifted apart (`mkdir my-workforce && cd my-squads`),
which would have failed on a user's very first command.

Co-Authored-By: Claude <noreply@anthropic.com>
@codecov-commenter

Copy link
Copy Markdown

⚠️ Please install the 'codecov app svg image' to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

❌ Patch coverage is 0% with 2 lines in your changes missing coverage. Please review.

Files with missing lines Patch % Lines
src/lib/insights.ts 0.00% 2 Missing ⚠️

📢 Thoughts on this report? Let us know!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant