Motivation
The project's primary concept is a space — a named collection of nodes — rather than an "OST" (Opportunity Solution Tree), since the schema is already broader than a canonical OST and may diverge further over time. Using "OST node" and "OST on a page" as the primary terms ties the codebase to a specific framework name and implies a structural rigidity that isn't intended.
Proposed renames
| Current term |
Candidate replacements |
OST node |
node, space node |
OST on a page |
space on a page, on a page, single page space, single page |
The rename should be consistent across:
- Source code identifiers and type names
- Comments and JSDoc
- Test descriptions
- Documentation (
docs/concepts.md, README.md, CLAUDE.md)
- The
type: ost_on_a_page frontmatter value and schema key (breaking change — needs migration notes)
Considerations
ost_on_a_page as a frontmatter type value is user-facing and changing it is a breaking change for existing files. A migration path (or alias support) will be needed.
- The rename should be completed in a single focused PR to avoid mixed terminology.
- Update
docs/concepts.md once canonical names are decided, as it is the source of truth for naming.
Relates to the terminology discussion in docs/concepts.md and the broader space-centric framing.
Motivation
The project's primary concept is a space — a named collection of nodes — rather than an "OST" (Opportunity Solution Tree), since the schema is already broader than a canonical OST and may diverge further over time. Using "OST node" and "OST on a page" as the primary terms ties the codebase to a specific framework name and implies a structural rigidity that isn't intended.
Proposed renames
OST nodenode,space nodeOST on a pagespace on a page,on a page,single page space,single pageThe rename should be consistent across:
docs/concepts.md,README.md,CLAUDE.md)type: ost_on_a_pagefrontmatter value and schema key (breaking change — needs migration notes)Considerations
ost_on_a_pageas a frontmattertypevalue is user-facing and changing it is a breaking change for existing files. A migration path (or alias support) will be needed.docs/concepts.mdonce canonical names are decided, as it is the source of truth for naming.Relates to the terminology discussion in
docs/concepts.mdand the broader space-centric framing.