Skip to content

Emphasize human-led productivity in docs#989

Merged
bradygaster merged 4 commits intobradygaster:devfrom
IEvangelist:dapine/986-responsible-ai-landing-page
Apr 17, 2026
Merged

Emphasize human-led productivity in docs#989
bradygaster merged 4 commits intobradygaster:devfrom
IEvangelist:dapine/986-responsible-ai-landing-page

Conversation

@IEvangelist
Copy link
Copy Markdown
Collaborator

@IEvangelist IEvangelist commented Apr 16, 2026

Summary

  • reframe the homepage and README around human-led productivity and responsible AI
  • refine the landing page hero, callout, parallel-work copy, and visual emphasis
  • fix garbled search UI text and keep the docs build regression aligned
image

Validation

  • npx vitest run test\docs-build.test.ts

Notes

  • npm run build currently fails on the base branch with an unrelated TypeScript error in packages/squad-sdk/src/platform/comms-teams.ts (TOKEN_PATH vs tokenPath); this PR does not touch that area.

Closes #986

cc @diberry @bradygaster @tamirdresher

Reframe the docs landing page and README around human-led productivity, strengthen the responsible AI callouts and feature messaging, and fix the garbled docs search UI text.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@IEvangelist IEvangelist marked this pull request as ready for review April 16, 2026 17:40
Copilot AI review requested due to automatic review settings April 16, 2026 17:40
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Reframes the docs homepage and README to emphasize human-led productivity and responsible AI, while fixing garbled search UI strings and keeping the docs build regression test aligned with the new homepage copy.

Changes:

  • Update docs landing page hero/trust strip and add explicit “humans stay in charge” messaging.
  • Fix garbled Pagefind search UI text/keyboard shortcut labels.
  • Extend docs build test coverage to assert the new homepage messaging is present.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.

File Description
test/docs-build.test.ts Adds an assertion that the built landing page contains the new “Humans stay in charge” copy.
docs/src/pages/index.astro Rewrites homepage headline/sections to emphasize human-led productivity and responsible AI.
docs/src/components/Search.astro Replaces garbled characters in search UI strings and shortcut modifier label.
README.md Reframes product positioning and watch mode language toward human oversight and accountability.

Comment thread docs/src/pages/index.astro Outdated
Comment thread test/docs-build.test.ts
bradygaster and others added 3 commits April 16, 2026 11:25
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Replace hero headline with "Your agents bring your ideas to life" and
subhead emphasizing that Squad helps you spend less time prompting,
more time deciding.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@bradygaster bradygaster merged commit 5f9ccb9 into bradygaster:dev Apr 17, 2026
tamirdresher pushed a commit that referenced this pull request Apr 21, 2026
* Closes #986: emphasize human-led productivity in docs

Reframe the docs landing page and README around human-led productivity, strengthen the responsible AI callouts and feature messaging, and fix the garbled docs search UI text.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Potential fix for pull request finding

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

* docs(landing): revise hero copy per feedback

Replace hero headline with "Your agents bring your ideas to life" and
subhead emphasizing that Squad helps you spend less time prompting,
more time deciding.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs(landing): reword Responsible AI callout

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Brady Gaster <41929050+bradygaster@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
sabbour added a commit to sabbour/squad that referenced this pull request Apr 21, 2026
)

* fix(identity): cover all gh write commands and map reviewer roles to lead

- Template GIT IDENTITY block now uses session-level export GH_TOKEN pattern
  so every gh write command (review, comment, merge, edit, issue comment)
  uses the bot identity instead of falling through to the authenticated user.
- Added code review, reviewer, watchdog patterns to role-slug resolution
  so compound roles like 'Code Reviewer & Watchdog' route to lead tier.
- Compact template mention updated to reference expanded block.
- Fixes identity inconsistency seen on kickstart PRs bradygaster#986/bradygaster#989/bradygaster#990.

Closes bradygaster#986

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* test(identity): adversarial compound-role coverage

Add describe('compound and edge-case roles') block to role-slugs.test.ts
covering the class of bug where compound role strings (e.g.
"Code Reviewer & Watchdog") fell through to the 'backend' default.

Tests added:
- Production regression: "Code Reviewer & Watchdog" → lead
- "Lead, Architect" → lead
- "Security Architect" → lead (architect wins over security)
- "Code Reviewer" alone → lead
- "Reviewer" alone → lead
- "Watchdog" alone → lead
- "Senior Code Review Engineer" → lead
- "Backend & Reviewer" → lead (first-match: reviewer pos 4 beats backend pos 11)
- "Frontend Reviewer" → lead (first-match: reviewer pos 4 beats frontend pos 6)
- Case variants: CODE REVIEWER, code reviewer, Code Reviewer → all lead
- Whitespace: "  Code Reviewer  " → lead (substring match handles padding)
- Empty string → backend (DEFAULT_SLUG)
- "Quantum Bard" (unknown) → backend (DEFAULT_SLUG)

Two it.todo items flagged for Flight ruling:
- "Backend & Reviewer" ordering concern
- "Frontend Reviewer" ordering concern

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* chore(fido): append compound-role adversarial session to history

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: eecom[bot] <eecom[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs lean more on productivity and enablement

3 participants