docs(site): landing v2 — narrative redesign (loop · gates · vocabulary)#3090
Merged
Conversation
… 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>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
github-actions
Bot
added
documentation
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-zhuang
changed the title
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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
背景
两轮迭代合一:① hero 文案从类目词换成与 www.objectos.ai 镜像的叙事;② 按维护者定的开源核心叙事(创建项目 → 描述需求、Claude Code 自动开发、浏览器预览 → 元数据能力清单)整页重设计,并解决"首页有点丑"。
页面结构(spec-sheet 美学:蓝图网格、mono 编号小节、Bricolage Grotesque 标题、品牌渐变第二拍)
os validate ✓→os devConsole 预览)+ proof strip(~1% · Typed, validated, governed · Self-host)npx create-objectstack创建 → 描述需求(agent 写元数据、validation gate 拦静默错误)→ 浏览器预览;需求变更同循环<title>模板去掉 "Protocol" 类目词验证
types:check✅;本地 dev 浏览器逐区块实测(亮/暗色、1280 视口),hero/loop/gates/vocabulary/closing 截图确认npx create-objectstack(README:111)、os devConsole(README:75)、1,600+ schemas(README:36)、视图类型与能力清单与 spec/README 一致🤖 Generated with Claude Code