Skip to content

Commit 9189956

Browse files
docs(north-star): make the road paragraph's promise count match its list (#29276)
domain:skills#1 · huangyiirene · session_01J8VVAnMUWA9rufXzFaEh4J <!-- claude-projects-attribution: {"github_login":"huangyiirene"} --> _Requested by **Irene** · [project thread](https://claude.ai/code/project/chan_01TJXtQ1tVD26ecLDZxFS67x?thread=cmsg_01TJXtQ1tVD26ecLDZxFS67xWTjfLFUhA6mfd14H3HWxbx)_ Fixes #29185 Clause-②: no Metadata-protocol: none ## 维护者速读 - **改了什么**:北极星「道路」段里那句「四个承诺各由一步兑现」,清单原本列了五项;现在清单只列四个承诺(①、②③、④、⑤),第六步「闭环」单独说明,数字和清单对上了。 - **为什么改**:`docs/NORTH-STAR.md` 是每个 Agent 动手前逐字读的文件,说「四」列「五」会被照抄,也让读者怀疑整份文件。 - **风险与回滚**:纯文案一行,不涉及代码和协议;回滚即还原这一行。 - **先看**:`docs/NORTH-STAR.md` 第 11 行(唯一一处改动)。 - **两分钟验证**:看 diff,数冒号后的承诺项,应为四项,然后读到「the sixth step, ⑥, closes the loop」。 - **需要你做的**:批准这个 PR(Tier H 路径,需维护者亲手点)。 ## What changes `docs/NORTH-STAR.md:11`, the road paragraph's last sentence, one hunk: - before: "The four promises are each kept by a step: ① AI can write it · ②③ it executes · ④ you own it · ⑤ agents can operate it · ⑥ it closes the loop." - after: "The four promises are each kept by a step: ① AI can write it · ②③ it executes · ④ you own it · ⑤ agents can operate it; the sixth step, ⑥, closes the loop." The four promises keep the step mapping #22172 wrote; "closes the loop" is the road's sixth step (iterate on a customer request), not a promise, so it is named apart. A reader now counts four entries after "four promises". Nothing else in the file moves. ## Tests Prose only; no test exercises this sentence. No changeset: `docs/NORTH-STAR.md` is in no package's `files[]` (labelled `skip-changeset`). ## Acceptance notes None. ## Verification Local derived gate subset on head `9d18bca6`, from `node scripts/pm/dispatch-gates.mjs --commands` (16 families): <details><summary>16 derived, 16 run, all exit 0</summary> - node scripts/check-adr-links.mjs (and --self-test) :: exit 0 - node scripts/check-closing-keyword-parity.mjs (and --self-test) :: exit 0 - node scripts/check-comment-mask-corpus.mjs :: exit 0 - node scripts/ci/plan-test-core-shards.mjs --self-test :: exit 0 - pnpm --filter @objectstack/lint run check:doc-formula-expressions :: exit 0 (after building @objectstack/formula and @objectstack/lint; first run exit 3 PREREQUISITE NOT MET) - pnpm check:ci-filter-parity, check:cross-package-test-inputs, check:doc-authoring, check:driver-memory-census, check:gitlink-declared, check:nul-bytes, check:pm-governed-merges, check:refd-timer-probe, check:watch-hint-literal :: exit 0 each - `dispatch-gates --ran`: "16 derived famil(ies) accounted for — 16 run, 0 NOT-MEASURED" </details> Families CI runs beyond that subset are read from this PR's check runs. --- _Generated by [Claude Code](https://claude.ai/code/session_01J8VVAoRqxDWbaTEjSC2cHV)_ 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01J8VVAoRqxDWbaTEjSC2cHV Co-authored-by: Claude <noreply@anthropic.com>
1 parent ad224b7 commit 9189956

1 file changed

Lines changed: 1 addition & 1 deletion

File tree

‎docs/NORTH-STAR.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88

99
**What counts as done**: an application built on the protocol is done only once it has passed verification — the checklist items its metadata maps to pass in one run, and `objectstack verify` is green on it. A delivery that has not passed verification does not count as done.
1010

11-
**The one measure: the road**: a new AI developer (a human accepting alongside) starts from `npm create objectstack`: write metadata → run it locally and see it → verification loudly rejects what is wrong and lets through what is right → publish and install into an environment → connect an agent (MCP in the community edition) and have it complete one real business operation in the application → iterate once on a one-sentence customer request. Walk it for real every week, and the result lands as a run record. The first step that breaks is the current P0; one that runs through but gives a wrong result is P2. The four promises are each kept by a step: ① AI can write it · ②③ it executes · ④ you own it · ⑤ agents can operate it · ⑥ it closes the loop.
11+
**The one measure: the road**: a new AI developer (a human accepting alongside) starts from `npm create objectstack`: write metadata → run it locally and see it → verification loudly rejects what is wrong and lets through what is right → publish and install into an environment → connect an agent (MCP in the community edition) and have it complete one real business operation in the application → iterate once on a one-sentence customer request. Walk it for real every week, and the result lands as a run record. The first step that breaks is the current P0; one that runs through but gives a wrong result is P2. The four promises are each kept by a step: ① AI can write it · ②③ it executes · ④ you own it · ⑤ agents can operate it; the sixth step, ⑥, closes the loop.
1212

1313
**Features on the road**: the features the platform has to deliver, one per line, arranged by the steps of that road; top to bottom is the order — this table is the roadmap, and editing it is editing priority. Each row reads `axis · feature (in business language) · checklist area · item ids`, and one feature is a whole strip from protocol through runtime to the frontend; every item in `docs/qa/platform-checklist/` belongs to exactly one row here (an item not yet written is marked "checklist item to be written"). An id without a prefix belongs to the checklist area before it; one from another area is written in full.
1414

0 commit comments

Comments
 (0)