Rustelo/templates/_ontoref-skeleton/README.md
2026-07-18 19:57:03 +01:00

1.6 KiB

ontoref onboarding skeleton

Stamped into a generated site by scripts/generator/onto-onboard.nu. Governs the site's own project (not the rustelo domain). Three levels:

Level What gets written
none nothing — the site is not governed by ontoref.
minimal .ontoref/{config.ncl, card.ncl} + local schemas + .rustelo.ontoref domain pointer. Owner runs ontoref setup later to scaffold ontology/reflection/adrs.
full minimal, then delegates to ontoref setup (the tool's own onboarding) to scaffold ontology/reflection/adrs from ontoref's bundled templates.

Why delegate to ontoref setup

ontoref ships its own onboarding templates (config, project, ontology/{core,state,gate,manifest,connections}) under its app-support dir. We do NOT re-author or vendor the full ontology here — that would drift from the tool and overstep the rustelo domain layer, which is authored separately (referenced via .rustelo.ontoref). This skeleton only provides the minimal floor (config.ncl + card.ncl + the schemas their imports need locally — see the post-0023 layout requirement) and a domain pointer.

Local schemas

Per the post-0023 layout, reflection/ontology NCL import schemas as schemas/<x>.ncl resolved against the project. minimal/schemas/ carries project-card.ncl (for card.ncl) and backlog.ncl, copied into the site so imports resolve without relying on a global schema path. Re-copy from ontoref's app-support schemas when ontoref updates.

Placeholders

{{ project_name }}, {{ languages }}, {{ render_profile }} — substituted by onto-onboard.nu.