docs(skills): project-setup.md’s CLI table drops the retired objectui add row and says analyze is the bundle-size report over dist/ (objectui#11503)

[objectstack-fleet]

Fixes #11503
Clause-②: no

What changed

Two rows of the "CLI commands" table in skills/objectui/guides/project-setup.md, the guide of the shipped objectui skill.

• The objectui add row ("Add a component renderer scaffold") is deleted. On this branch's base aea682a3, packages/cli/src/cli.ts registers no add command and packages/cli/src/commands/ holds no add.ts; a grep for objectui add over packages/cli/src is empty. The pin in packages/cli/src/__tests__/cli-bin.test.ts already holds: running add is refused with unknown command 'add'.
• The objectui analyze row. Before: "Analyze bundle size / render performance". After: "Bundle-size report over the built dist/ output". That is what the command does today: .command('analyze') in cli.ts takes no option, and analyze() in packages/cli/src/commands/analyze.ts only calls analyzeBundleSize(), which reads the dist/ directory under the current working directory (its docblock: "Analyze application performance: the bundle-size report over dist/"). The same pin test holds --render-performance and --bundle-size as refused options. The new row names no flag and carries no retirement narrative: the skill teaches the current spelling only.

Both retirements are PR objectui#11499 (objectui#11496, triage ruling 5958245941), merged to main before this branch was cut; this PR only follows them.

Not touched: the create plugin, lint, test and studio rows — objectui#11500 is still queued with no PR, so the CLI still has them and the guide must not run ahead of the CLI; every other row of the table; the rest of the guide; skills/objectui/evals/** (no eval token names analyze, add, render or bundle: a grep over skills/objectui/evals/*.json for those is empty); packages/**. No test is added: the card is prose, and the code side is already pinned by cli-bin.test.ts.

An empty-frontmatter changeset, .changeset/11503-project-setup-cli-table-add-analyze.md, declares the change as unreleased (nothing under a published package's files[] moved; check-changeset-presence says no changeset is owed and counts the one added).

Line readings (lines; objectui has no token ratchet)

surface	before	after	delta
skills/objectui/guides/project-setup.md, whole file	351	350	-1
whole package: every skills/objectui/**/*.md plus every skills/*/SKILL.md, as a union (16 files; the only SKILL.md is skills/objectui/SKILL.md, already inside the first set)	4816	4815	-1

Budget for this card: net at most 0. The diff is two deletions and one insertion; the analyze row stays one line and no neighbouring line is re-wrapped. Both readings are taken from the git objects at the base aea682a3 and at head 6604f48f.

Verification (head 6604f48f; every exit code redirected to a file before being read)

Gate roster derived by hand from .github/workflows/*.yml on the base (objectui has no dispatch-gates). Each gate's own verdict line is quoted in the os-dev-report comment on objectui#11503.

• node scripts/check-skills-paths.mjs → exit 0 ("89/90 stated path(s) resolve across 20 guide file(s); 1 baselined"); the path set this guide states is unchanged and scripts/skills-path-baseline.json is untouched.
• node scripts/check-skill-examples.mjs --self-test → exit 0 (60 cases) and node scripts/check-skill-examples.mjs → exit 0 ("Every marked skill example holds up against the built types"), after the gate's own --build-filter scoped build (12 named packages plus closure, 29 turbo tasks, 3m29s under the shared verify lock, VERDICT command-exit 0). No code fence moved in this diff.
• node scripts/check-skill-eval-tokens.mjs --self-test → exit 0 (29 cases); node scripts/check-skill-eval-tokens.mjs → exit 0 ("Every must_contain token is taught by its own skill bundle").
• node scripts/check-new-cross-file-line-citations.mjs → exit 0 ("0 new citation(s)"); this body cites by content, never by line address.
• node scripts/check-control-bytes.mjs → exit 0 (10096 tracked text files).
• node scripts/check-changeset-presence.mjs → exit 0 ("1 file(s) changed, 0 of them published source … 1 changeset(s) added … no changeset is owed"); node scripts/check-changeset-no-major.mjs → exit 0; node scripts/check-changeset-overwrite.mjs → exit 0 ("1 changeset(s) added, 0 modified, 0 deleted").
• node scripts/check-governed-queue-guard.mjs --test over the two files → exit 3 GOVERNED (skills/**, the published skills catalog): this PR stays a draft until an authorized APPROVED review, then the seat lands it.
• pnpm exec vitest run --maxWorkers=2 scripts/__tests__/doc-version-claims.test.ts → exit 0 (1 file, 29 tests passed): the one test in the tree that reads this guide.
• Card pin: grep -rnE "objectui add|render.performance|--bundle-size|generate --output|generate --from" skills/ → two hits on the base (these two rows), zero after.
• Not run locally, declared to CI: the lint.yml and ci.yml jobs, whose "Decide whether this change needs a full run" step excludes **/*.md and .changeset/**, so on this diff they report a skip.

Acceptance notes

• Every other row of the table was read against cli.ts on the base: init (templates dashboard, form, simple), dev (alias for serve), build, start, studio, validate, check, lint, test, generate (resource/object, page, plugin), create plugin and doctor each match a registered command and its options. No other stale row; nothing to file.
• The container's Node (v22.22.0) is below the engines floor of a transitive jsdom, so pnpm install ran with --config.engine-strict=false, as the earlier skills cards did; nothing in this diff depends on it.

维护者速读(草稿)

改了什么

skills/objectui/guides/project-setup.md(发布给使用者的 objectui 技能)CLI 命令表里两行:删掉 objectui add 一行;objectui analyze 一行从「分析包体积 / 渲染性能」改为「对构建产物 dist/ 的包体积报告」。另加一个空 frontmatter 的 changeset,声明本次不发版。文件 351 → 350 行,整个 skills 包 4816 → 4815 行。

为什么改

PR objectui#11499(objectui#11496)已把 CLI 的 add 命令和 analyze 的渲染性能模式退役:现在 objectui add 会被 CLI 拒绝为未知命令,analyze 只剩包体积报告。技能面却还在教这两样,照着做的 AI 会敲出一条 CLI 拒收的命令、或期待一个不存在的模式。本 PR 只让技能表跟上 CLI 的现状,只教现行写法,不加「已退役」叙事。

风险与代价(含回滚)

纯散文改动:不碰代码、测试、evals,代码围栏一字未动,技能示例门禁实测无差异;行数 -1,在预算内。create plugin / lint / test / studio 四行刻意不动 —— objectui#11500 还在队列里、CLI 侧未退役,技能面不能跑在 CLI 前面。回滚 = revert 本 PR 的 squash commit。受管面(skills/**,Tier H):停在 draft,等获授权批准后由席位落地,本 PR 不自行翻 ready、不入队。

席位意见

(留空,席位定稿)

你要做的

读一遍 analyze 新行的措辞是否符合你对该命令现状的理解(只做 dist/ 的包体积报告,无其他模式);认可则留一条 APPROVED review,席位接手 ready 与入队。

Session session_01FNKm1SmPpuJASnbjxWGtsJ, seat domain:skills#1, dispatched by the PM loop on card objectui#11503.

---

Generated by Claude Code

[objectstack-fleet]

Contract review

Served-tier: CONTRACT_REVIEW_TIER
Head-sha: 6604f48f5b9560aea9997a26ed4819fdc3f995fc
Local-runs: none

Face: governed guide text (skills/objectui/guides/project-setup.md; objectui skills/**, the published catalog), reviewed in-seat by the dispatching seat at the constant's tier. Inputs: objectui#11503 (body and every comment: triage 5960472347, the claim 5960912895, the report 5961237394), this PR's body, its file list (2 files, +12 / −2) and patch against main, objectui packages/cli/src/cli.ts and packages/cli/src/commands/analyze.ts on main, git grep over skills/ on the base and on this head, and the check-runs on this head as read at this record.

① Derived judgments

1. Scope: two rows of the CLI commands table — the objectui add row deleted, the objectui analyze row reworded in place (−2 / +1) — plus an empty-frontmatter changeset (+11). Every other row, the rest of the guide, skills/objectui/evals/** and packages/** are byte-identical to main. RIGHT.
2. The add deletion: at the base aea682a3 (and at main now) packages/cli/src/commands/ has no add.ts and cli.ts registers no add command; PR objectui#11499 (objectui#11496, triage ruling 5958245941) merged ea391413 before this branch was cut. A row that teaches a command the CLI refuses as unknown is a teaching error; deleting it is the fix. RIGHT.
3. The analyze rewording 「Bundle-size report over the built dist/ output」: .command('analyze') takes no option; analyze() calls only analyzeBundleSize(), which resolves dist under the current working directory and says 「Run build first」 when it is absent; the docblock reads 「the bundle-size report over dist/」. The row names no flag and adds no retirement narrative. RIGHT.
4. The four rows triage flagged for later (create plugin, lint, test, studio) are untouched: objectui#11500 is still pm:queue with no PR, so the CLI still has them and the guide must not run ahead of the CLI. The dev read every remaining row against cli.ts and found no other stale row. RIGHT.
5. The card's pin: git grep over skills/ for objectui add, render performance, --bundle-size, generate --output / --from hit exactly these two rows on the base and is empty on this head. RIGHT.
6. Line budget: 351 → 350 (net −1, inside ≤0); bundle (skills/objectui/**/*.md ∪ skills/*/SKILL.md) 4816 → 4815; the analyze row stays one line; no neighbouring line re-wrapped (two deletions, one insertion). RIGHT.
7. The new row adds no issue reference; the changeset's references use the objectui#NNNN form. RIGHT.
8. No fence moved ⇒ skill-examples unaffected (the dev still ran it under the verify lock after a 29-task scoped build: 60 self-test cases, every marked example holds). The one test that reads this guide, doc-version-claims.test.ts, passes (29). RIGHT.
9. The fold triage proposed (one PR with objectui#11471) was not taken, for the reason on the claim: PR objectui#11480 was already ACCEPTed with its records on head 1078b79c; the two PRs touch different files and land independently. Consistent with the claim.

② Semver level

Docs-only in a governed surface; EMPTY-frontmatter changeset present; the phantom skip-changeset label correctly not applied; Clause-②: no. Consistent.

③ Boundary flags

• Base: cut at objectui aea682a3, the dispatch's base and the merge-base with main at this record; main has moved on since (behind, no conflict); the merge queue rebases. Accepted.
• pnpm install --config.engine-strict=false under the container's Node floor. Accepted (platform reading).
• One relay dry-run REFUSED by fleet-write validate (actions file packed as an object, not an array); zero writes; repacked and sent. Accepted.
• Commit trailers are the model-free pair objectui's AGENTS.md requires; PR title, body, commit, changeset and the report carry no model identifier (grepped). Accepted.
• Check-runs on 6604f48f at this record (2026-10-02T20:51Z): in_progress 9, skipped 3, success 28; 0 failure. Tier H landing: an authorized APPROVED review, then every check green on the landing head; the only other open objectui PR under skills/** is this seat's PR objectui#11480 on a different file.
• open_questions: none. out_of_scope_findings: none filed — the four objectui#11500 rows are carried by that card's landing (noted on the ACCEPT).

Implemented-by: claude/issue-11503-project-setup-cli-table-add-analyze
Reviewed-by: session_01FNKm1SmPpuJASnbjxWGtsJ

VERDICT: PASS

[objectstack-fleet]

维护者速读(终稿)

席位(skills 席 1,session_01FNKm1SmPpuJASnbjxWGtsJ)对照自读的 diff 与 objectui main 上 packages/cli 的命令注册与 analyze.ts 源码校正 dev 草稿后定稿,2026-10-02T20:53Z。

改了什么。 发布给作者的技能指南 skills/objectui/guides/project-setup.md CLI 命令表里两行:删掉 objectui add 一行;objectui analyze 一行从「Analyze bundle size / render performance」改为「Bundle-size report over the built dist/ output」。文件 351 → 350 行,整包 4816 → 4815 行;另加空 frontmatter changeset(不发版)。表内其余行、文件其余、evals、代码一字未动。

为什么改。 PR objectui#11499(objectui#11496,分诊裁决 5958245941)已把 CLI 的 add 命令和 analyze 的两个 flag 退役:objectui add 现在被 CLI 拒为未知命令,analyze 只剩对 dist/ 的包体积报告。技能面却还在教这两样 —— AI 照着敲会撞上拒收,或期待一个不存在的模式。本 PR 只让技能表跟上 CLI 现状,只教现行写法,不加「已退役」叙事。

风险与代价(含回滚)。 纯散文改动:不碰代码、测试、evals,代码围栏未动,技能示例门禁实测无差异;行数 -1,预算内。create plugin / lint / test / studio 四行刻意不动 —— objectui#11500 仍在队列、无 PR,CLI 侧未退役,技能面不能跑在 CLI 前面;那四行等 objectui#11500 落地后再过一遍。回滚 = revert 本 PR。受管面(skills/**,Tier H):停在 draft,等获授权批准后由席位落地。席内达档契约复核 PASS(见本 PR 评论)。

席位意见。 建议批准。分诊建议与 objectui#11471 合成一个 PR,席位未采纳:PR objectui#11480 已复核定稿等批,两个 PR 文件不同、各自一行级,你同一次坐下即可两个都批;理由已记在 objectui#11503 的 Claim 上。

你要做的(一个动作)。 在本 PR 上留一条 APPROVED review(os-zhuang / hotlong 任一);顺手也看一眼 PR objectui#11480。之后由席位清标、翻 ready、挂 auto-merge 入队;不需要你合并。