Skip to content

docs(narrative): hub foundation ≠ chat; fix counts and CTAs#1313

Merged
EmersonBraun merged 4 commits into
mainfrom
fix/ecosystem-narrative-p0
Jul 16, 2026
Merged

docs(narrative): hub foundation ≠ chat; fix counts and CTAs#1313
EmersonBraun merged 4 commits into
mainfrom
fix/ecosystem-narrative-p0

Conversation

@EmersonBraun

Copy link
Copy Markdown
Member

Summary

P0 ecosystem narrative fixes for the AgentsKit hub (parent epic #1254).

  • Foundation ≠ Chat: home/docs copy clarifies AgentsKit is the foundation toolkit; Chat is a separate experience product.
  • Canonical counts: integrations 20→50; providers/models aligned where marketing copy drifted.
  • Ask widget CTA: footer points to https://chat.agentskit.io/.
  • Related docs: quickstart, integrations, providers, cookbook, package overview ownership language.
  • Attestation: refreshed documentation-quality digests after certified path edits.
  • Types unblock: cast next/script props under TS 6 + React 19; registry Ask uses plain <style> instead of styled-jsx (pre-push lint).

Sibling PRs

Test plan

  • Home hero distinguishes foundation vs Chat
  • Integrations/docs show 50 integrations where claimed
  • Ask widget footer links to chat.agentskit.io
  • Quality gates / attestation green on CI

Align www.agentskit.io landing and docs with ecosystem roles: foundation
owns primitives, AgentsKit Chat owns product chat apps. Point Ask footer
and hero CTAs to chat.agentskit.io, separate headless useChat quickstart
from the Chat framework, and use verified counts (50 integrations, 25
adapters, 140 providers) instead of mixed floors.
Recompute content digest and promote commit after narrative P0 doc path changes so pre-push quality gates stay certified.
Cast next/script props where ScriptProps drops HTML attributes, and replace styled-jsx global styles in registry Ask with a plain style tag.
@vercel

vercel Bot commented Jul 16, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
agentskit-doc Ready Ready Preview, Comment Jul 16, 2026 9:01pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
agentskit-registry Ignored Ignored Preview Jul 16, 2026 9:01pm

Request Review

# Conflicts:
#	apps/docs-next/app/layout.tsx
#	apps/docs-next/components/docs/ask-widget.tsx
#	apps/landing/app/layout.tsx
#	apps/registry/app/layout.tsx
#	apps/registry/components/ask-widget.tsx
@github-actions

Copy link
Copy Markdown
Contributor

Lighthouse

URL Performance Accessibility Best practices SEO
http://127.0.0.1:3000/ 64 93 96 100
http://127.0.0.1:3000/docs 67 100 96 100
http://127.0.0.1:3000/docs/get-started/getting-started/quickstart 67 96 96 100
http://127.0.0.1:3000/stack 93 100 96 100
http://127.0.0.1:3000/showcase 93 100 96 100

Run by .github/workflows/lighthouse.yml.

@EmersonBraun
EmersonBraun merged commit 6466be5 into main Jul 16, 2026
17 checks passed
EmersonBraun added a commit that referenced this pull request Jul 16, 2026
…1316)

* docs(narrative): hub CLI vs chat-cli, /ecosystem product mesh

Distinguish @agentskit/cli scaffolding from product Chat, dual-section
/ecosystem (product mesh + foundation packages), and de-chat-orchestration
core package wording. Align tools integrations count to exact 50.

* chore: refresh README Standard after core description tweak

* docs(narrative): leftovers + Fase B SEO, properties v1, core KB voice

Leftovers: CLI vs chat-cli, /ecosystem product mesh, core package wording.
Fase B: foundation SEO/OG keywords, Discord Office Hours off docs index,
core v1 measured vs 10 KB budget, llms foundation framing, expand
ecosystem.json properties to all seven products.

* fix: keep properties v1 as four-product Doc Bridge shim

products[] remains the seven-product catalog. Doc Bridge still validates
properties.length === 4; document deprecation until schemas expand.

* fix: drop core package.json wording change to avoid changeset

* chore: re-attest after rebase onto main with #1313
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.

1 participant