31 lines
1.6 KiB
Markdown
31 lines
1.6 KiB
Markdown
# 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`.
|