Skip to content

docs(site): landing v2 — narrative redesign (loop · gates · vocabulary) - #3090

Merged
os-zhuang merged 2 commits into
mainfrom
docs/hero-copy
Jul 17, 2026
Merged

docs(site): landing v2 — narrative redesign (loop · gates · vocabulary)#3090
os-zhuang merged 2 commits into
mainfrom
docs/hero-copy

Conversation

@os-zhuang

@os-zhuangos-zhuang commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

背景

两轮迭代合一:① hero 文案从类目词换成与 www.objectos.ai 镜像的叙事;② 按维护者定的开源核心叙事(创建项目 → 描述需求、Claude Code 自动开发、浏览器预览 → 元数据能力清单)整页重设计,并解决"首页有点丑"。

页面结构(spec-sheet 美学:蓝图网格、mono 编号小节、Bricolage Grotesque 标题、品牌渐变第二拍)

  • Hero:"AI writes the app. ObjectStack is what it writes." + 防错链 lead + 右侧「故事卡」一图讲完闭环(需求一句话 → Claude Code 写 typed metadata diff → os validate ✓os dev Console 预览)+ proof strip(~1% · Typed, validated, governed · Self-host)
  • 01 The loop:npx create-objectstack 创建 → 描述需求(agent 写元数据、validation gate 拦静默错误)→ 浏览器预览;需求变更同循环
  • 02 The gates:Typed(tsc+Zod)/ Validated(os validate)/ Reviewed(Console 小 diff 人审)/ Governed(运行时权限+审计)
  • 03 The vocabulary:12 项企业软件元数据能力(objects/permissions/flows/approvals/views/dashboards/actions/api/mcp/i18n/seed/drivers)+ 与"AI 裸写一次性代码库"的对比段 + 数据条(1,600+ schemas · 5 drivers · 7 adapters · MCP)
  • Closing:ontology 开放协议一句话(链 objectos.ai 长文)+ ObjectOS 互链
  • 站点 <title> 模板去掉 "Protocol" 类目词

验证

  • types:check ✅;本地 dev 浏览器逐区块实测(亮/暗色、1280 视口),hero/loop/gates/vocabulary/closing 截图确认
  • 事实核对:npx create-objectstack(README:111)、os dev Console(README:75)、1,600+ schemas(README:36)、视图类型与能力清单与 spec/README 一致

🤖 Generated with Claude Code

… ontology link
Replace the category-label hero ("a metadata protocol and TypeScript
toolkit") with the two-beat claim the objectos.ai homepage sets up
("AI writes the app. ObjectOS keeps it governable." → "AI writes the
app. ObjectStack is what it writes."):
- lead carries the mistake-catching chain (strict TypeScript + Zod +
validation gate at authoring time; runtime enforces permissions/audit)
- proof strip: ~1% code surface · Typed, validated, governed · Self-host
- one-line ontology positioning linking to the objectos.ai essay
("the definition layer should be an open protocol you own")
- site <title> template drops the "Protocol" category word
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@vercel

vercelBot commented Jul 17, 2026

Copy link
Copy Markdown

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

ProjectDeploymentActionsUpdated (UTC)
specErrorErrorJul 17, 2026 6:12am

Request Review

Full landing redesign in an engineering spec-sheet aesthetic (blueprint
grid, mono kickers, Bricolage Grotesque display, gradient second beat):
- hero artifact card tells the whole loop in one visual: requirement →
Claude Code writes typed metadata (diff) → os validate ✓ → os dev preview
- 01 The loop: create-objectstack → describe (agent writes, gate rejects)
→ preview in browser; requirement changes run the same loop
- 02 The gates: typed / validated / reviewed / governed
- 03 The vocabulary: 12 metadata capabilities for enterprise software +
the one-off-codebase contrast + stats strip (1,600+ schemas, 5 drivers,
7 adapters, MCP)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@os-zhuangos-zhuang changed the title docs(site): hero copy — AI-written apps narrative + correctness chain + ontology linkdocs(site): landing v2 — narrative redesign (loop · gates · vocabulary)Jul 17, 2026
@os-zhuang
os-zhuang merged commit 709f97e into mainJul 17, 2026
13 of 15 checks passed
@os-zhuang
os-zhuang deleted the docs/hero-copy branch July 17, 2026 06:15
xuyushun441-sys pushed a commit that referenced this pull request Jul 17, 2026
The README opened with a category label ("A metadata protocol and
TypeScript toolkit") and spent its first 100 lines on architecture layers
and protocol theory — none of it the point a visitor is here for. It now
mirrors the landing page (objectstack.ai, #3090) and tells the story the
project is actually about:
- hero: "AI writes the app. ObjectStack is what it writes." + the
correctness chain (typed → validated → reviewed → governed)
- The loop: create → describe to Claude Code → preview in the browser;
requirement changes run the same loop
- What can it actually build? — the 12 metadata capabilities, framed
against the alternative (an agent on an empty repo writes a one-off
codebase; here it composes from a vocabulary the runtime already runs)
- Why the mistakes don't ship — the four gates, why TypeScript was the
right host language (errors become corrective text the agent fixes
itself), and the context-window argument
- Your app is AI-operable, for free — MCP in three lines
- This repo / architecture / ObjectOS cross-link, compressed to the tail
Reference sections (packages, CLI, scripts) are kept as-is. Drops the
stale v4.0.1 version badge (CLI is 15.x — the badge had drifted three
majors). Quick Start's duplicate scaffold snippet folds into the loop.
Also fixes a third missing-braces decision expression in flows.mdx:155
(same class as the two fixed in #3113 — without braces the comparison
degrades to a string compare that never matches as intended).
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
os-zhuang added a commit that referenced this pull request Jul 17, 2026
The README opened with a category label ("A metadata protocol and
TypeScript toolkit") and spent its first 100 lines on architecture layers
and protocol theory — none of it the point a visitor is here for. It now
mirrors the landing page (objectstack.ai, #3090) and tells the story the
project is actually about:
- hero: "AI writes the app. ObjectStack is what it writes." + the
correctness chain (typed → validated → reviewed → governed)
- The loop: create → describe to Claude Code → preview in the browser;
requirement changes run the same loop
- What can it actually build? — the 12 metadata capabilities, framed
against the alternative (an agent on an empty repo writes a one-off
codebase; here it composes from a vocabulary the runtime already runs)
- Why the mistakes don't ship — the four gates, why TypeScript was the
right host language (errors become corrective text the agent fixes
itself), and the context-window argument
- Your app is AI-operable, for free — MCP in three lines
- This repo / architecture / ObjectOS cross-link, compressed to the tail
Reference sections (packages, CLI, scripts) are kept as-is. Drops the
stale v4.0.1 version badge (CLI is 15.x — the badge had drifted three
majors). Quick Start's duplicate scaffold snippet folds into the loop.
Also fixes a third missing-braces decision expression in flows.mdx:155
(same class as the two fixed in #3113 — without braces the comparison
degrades to a string compare that never matches as intended).
Co-authored-by: Jack Zhuang <277994282+os-zhuang@users.noreply.github.com>
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentationImprovements or additions to documentationsize/m

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@os-zhuang