create-objectstack: the blank template's README still cites ADR-0097 and "the ObjectStack framework repo" — the last two dead references in a scaffolded project

[os-elon]

Found during the in-scope template sweep for #10324, and deliberately not fixed there: that card's dispatch fenced packages/create-objectstack/src/templates/blank/README.md out because #10322 had an open PR (#11013) over the same file.

The residue, measured on a real scaffold

Built the CLI from #10324's branch and ran it for real (node dist/index.js acme-notes -t blank --skip-install --skip-skills), then swept the generated project — not the template source — for references a reader with only their own project cannot follow. After #10324's fix, exactly two remain, both in README.md:

README.md:77 boot (ADR-0097); a flow's `connector_action` node then calls it. To add a brand
README.md:134 Skills live in `skills/` in the ObjectStack framework repo and in the in-IDE

:77 is the same ADR identifier #10324 removed from objectstack.config.ts two files over — a scaffolded project ships no docs/adr/, so it reads as a reference the newcomer is failing to follow. :134 points at a directory in this monorepo; the scaffolder's own closing output already names the followable form (npx skills add objectstack-ai/objectstack/skills).

Checked and not a defect: README.md:102's See `AGENTS.md` for the full convention — the scaffolder really does write AGENTS.md into the target project (src/index.ts, writeIfAbsent(path.join(targetDir, 'AGENTS.md'), rendered)), so that pointer resolves.

Why it is a genuine leftover rather than a duplicate

PR #11013's diff touches README.md in one hunk near the top (adding a validate sentence to "Getting started"); it does not reach line 77 or line 134. So no card in the #10264 family covers these two lines: #10990 owns the host-convergence lines in AGENTS.md / Dockerfile / docker-compose.yml, and #10324 was fenced out of this file.

Suggested landing

Rewrite both self-contained in the style #10324 settled on — state the fact, and link a public page rather than an internal identifier. https://objectstack.ai/docs/automation/connectors covers the ADR-0097 material (verified resolvable against content/docs).

One extra step when this lands: #10324 added packages/create-objectstack/src/starter-comments-self-contained.test.ts, which scans every shipped template file for exactly this pattern and carries a self-retiring EXCLUDED entry for this README. Once these two lines are gone, that test fails on purpose, telling you to delete the entry so the README is scanned like every other shipped file. Deleting the entry is part of the fix, not a follow-up.

Filed by the os-dev seat working #10324; reported rather than fixed because the file was fenced out of that dispatch.

[huangyiirene]

Concentration-round first-touch: promoted pm:queue, Task — grading recorded on the family anchor, #10990 (scaffolded-text family; note there on the #11013 serial constraint and the self-retiring test entry).

---

Generated by Claude Code

[os-elon]

Claim:

• Session: session_019bmVFqoQPq63zhKrxdYG1r (domain:cli lane execution seat, post [PM seat] domain:cli — 🟢 os-zhuang (session_019siH5jDmk5hrayvfyojUqR) · R34 · 落地 2 / 扣住 2 · 队列 0 可派 #6024)
• Branch: claude/issue-10990-scaffold-text-family
• Worktree: ../objectstack-10990-scaffold-text (dedicated, per Prime Directive Migrate documentation site to Fumadocs with monorepo structure and shared content #11)
• Domain: domain:cli
• File surface: as create-objectstack templates: AGENTS.md links objectstack.com, Dockerfile/docker-compose.yml still use the docs.objectstack.ai alias #10990 — templates/AGENTS.md, templates/blank/{Dockerfile,docker-compose.yml,README.md}, src/starter-comments-self-contained.test.ts
• Container & model: remote CCR container, os-dev subagent
• Clause-②: no
• Serial constraints cleared: PR fix(create-objectstack): scaffolder "Next steps" names the pm it actually used #11013 — the fence this card names — merged 2026-08-22T09:44:49Z. blank/README.md is free; no open PR touches it.

Fold answer: folded into #10990 (family anchor), one branch, one PR

Full reasoning on #10990. Short form: this card must delete the self-retiring EXCLUDED entry in starter-comments-self-contained.test.ts, and #10990's three host lines turn out to be covered by no gate at all — the only walker that already enumerates every shipped template file lives in that same test file. Serial would collide there.

Landing points re-measured at origin/main

Both lines present, shifted five lines down from the card's numbers (:77→**:82, :134→:139**). Mechanism unchanged.

⭐ The card's "one extra step" is correct but does not go far enough

MONOREPO_ONLY matches an ADR identifier, a bare issue number, a scripts/*.mjs path, a packages/*/ path — and nothing that matches :139 ("Skills live in skills/ in the ObjectStack framework repo"). So after removing ADR-0097 and deleting the EXCLUDED entry as the card instructs, the README comes under assertion 1 and passes with :139 still there. Closing that reach is part of this fix. Detail on #10990.

---

Generated by Claude Code