Skip to content

Adopt the semantic model across Ghost starter packages - #264

Merged
awinther1 merged 5 commits into
mainfrom
feat/semantic-model-adoption
Aug 20, 2026
Merged

Adopt the semantic model across Ghost starter packages#264
awinther1 merged 5 commits into
mainfrom
feat/semantic-model-adoption

Conversation

@awinther1

Copy link
Copy Markdown
Collaborator

Why

ghost init should give authors a coherent semantic starting point rather than requiring every package to invent its own placement vocabulary and node-body structure. The same model should hold across Ghost's first-party reference packages without making their brand-local kinds runtime-special.

What

  • Make the starter use standard, foundation, and context, with Usage / Rules / Never bodies and optional final Skeleton guidance.
  • Rename the measured median floor to standard.model-defaults, frame its rules as overridable Defaults, and keep ghost checks init compatible with legacy cliche.median packages.
  • Converge vessel-light on the same model, including its glossary, checks, demo asks, release payload, and all node bodies.
  • Align both vessel-react packages, preserving defensible local kinds while adopting context/default semantics and the common body shape.
  • Teach the vocabulary and body model in the installed skill bundle; include a minor changeset.

Risk Assessment

Medium. This intentionally changes the files and node IDs emitted by fresh ghost init and the vessel-light body. Legacy median check scaffolding remains supported, and all first-party packages validate with zero warnings.

Verification

  • pnpm test — 212 passed
  • pnpm check — passed
  • Fresh ghost init + ghost checks init + ghost validate — zero errors/warnings
  • vessel-light, vessel-react workspace package, and vessel-react shipped package — zero errors/warnings

References

  • ~/Briefs/2026-08-19_default-node-schema.md
  • thoughts/shared/research/2026-08-19-semantic-model-adoption.md (local research artifact; intentionally not committed)

Generated with Goose

Kinds become standard/foundation/context; cliche.median becomes
standard.model-defaults (a shared Default, reject->replace preserved);
foundation and context bodies restructure to Usage/Rules/Never with
known-gap open questions; checks init pairs the median check with the
new node id and rewrites references for legacy cliche.median packages.
grammar.*/signature.* become foundation.*, register.* become context.*,
anti-goal.median becomes standard.model-defaults, anti-goal.tells becomes
foundation.tells; all bodies restructure to Usage/Rules/Never; glossary,
checks, demo asks, README, and release scripts follow the renames.
Workspace package: manifest to ghost.package/v1 with a declared cover,
condition.* renamed to context.*, bodies restructured to Usage/Rules/Never.
Fingerprint package: anti-goal.median becomes standard.model-defaults with
Default framing, glossary declares standard, cover declared, bodies
restructured; checks updated in the same change.
@nahiyankhan

Copy link
Copy Markdown
Collaborator

directionally right and almost there! I'll leave some comments and nits

@nahiyankhan

nahiyankhan commented Aug 20, 2026

Copy link
Copy Markdown
Collaborator

the vessel-light index.md did not show up in the diffs because it didn't get touched, but it has stale guidance now due to the renames. rewrite with new vocab would be right. would suggest to do as a followup. (likely on me)

@nahiyankhan

Copy link
Copy Markdown
Collaborator

the rephrases missed skill-bundle/references/steering-audit.md: the file mentions "anti-goals" and anti-goal.* nodes. but with this PR no package this repo ships declares an anti-goal kind. an installed skill would send agents looking for nodes that won't exist anymore. ask the agent to do a pass on this!

nahiyankhan
nahiyankhan previously approved these changes Aug 20, 2026
@awinther1

Copy link
Copy Markdown
Collaborator Author

rewrite with new vocab would be right

Good catch, let's do this next!

@awinther1

Copy link
Copy Markdown
Collaborator Author

an installed skill would send agents looking for nodes that won't exist anymore.

I found stale conceptual guidance in nodes.md and ground.md, a stale signature.shape reference in the median check, plus the separately noted vessel-light cover and README. I’m updating the whole live authoring surface so the installed skill teaches the new model consistently. Update incoming!

@awinther1

Copy link
Copy Markdown
Collaborator Author

🤖 Addressed the semantic-vocabulary follow-up in the latest commit. The pass covered more than steering-audit.md: it replaced stale anti-goal guidance in steering-audit.md, nodes.md, and ground.md; fixed the lingering signature.shape example in the median check; rewrote the vessel-light cover and README for foundation / context / standard.model-defaults; and removed the stale anti-goals wording from the vessel-react shipped cover. A repository-wide scan of live shipped guidance now finds no anti-goal.*, grammar.*, signature.*, register.*, or cliche.* references. pnpm test (212 passed) and pnpm check both pass.

@awinther1
awinther1 marked this pull request as ready for review August 20, 2026 18:23
@awinther1
awinther1 merged commit 5ef9ab5 into main Aug 20, 2026
4 checks passed
@awinther1
awinther1 deleted the feat/semantic-model-adoption branch August 20, 2026 18:32
@github-actions github-actions Bot mentioned this pull request Aug 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants