ontoref/reflection/forms/backlog_item.ncl
Jesús Pérez 0396e4037b
Some checks failed
Nickel Type Check / Nickel Type Checking (push) Has been cancelled
Rust CI / Security Audit (push) Has been cancelled
Rust CI / Check + Test + Lint (nightly) (push) Has been cancelled
Rust CI / Check + Test + Lint (stable) (push) Has been cancelled
chore: add ontology and reflection
2026-03-13 00:21:04 +00:00

93 lines
3.7 KiB
Plaintext

{
name = "Backlog Item",
description = "Add a new item to reflection/backlog.ncl. Captures intent, priority, and graduation path.",
display_mode = "complete",
elements = [
{ type = "section_header", name = "identity_header",
title = "Item", border_top = true, border_bottom = true },
{ type = "text", name = "title",
prompt = "Title",
required = true,
placeholder = "Migrate examples/ to reflection/forms/",
help = "Imperative present tense. What needs to happen.",
nickel_path = ["title"] },
{ type = "select", name = "kind",
prompt = "Kind",
default = "Todo",
options = [
{ value = "Todo", label = "Todo — concrete task with clear done state" },
{ value = "Wish", label = "Wish — desirable but not yet decided" },
{ value = "Idea", label = "Idea — worth exploring, not committed" },
{ value = "Bug", label = "Bug — known defect to fix" },
{ value = "Debt", label = "Debt — technical debt to address" },
],
nickel_path = ["kind"] },
{ type = "select", name = "priority",
prompt = "Priority",
default = "Medium",
options = [
{ value = "Critical", label = "Critical — blocks other work" },
{ value = "High", label = "High — important, do soon" },
{ value = "Medium", label = "Medium — normal queue" },
{ value = "Low", label = "Low — nice to have" },
],
nickel_path = ["priority"] },
{ type = "editor", name = "detail",
prompt = "Detail",
required = false,
file_extension = "md",
prefix_text = "# What needs to happen and why?\n# How will done be verified?\n\n",
nickel_path = ["detail"] },
{ type = "section_header", name = "links_header",
title = "Links to existing artifacts", border_top = true, border_bottom = true },
{ type = "text", name = "related_adrs",
prompt = "Related ADRs (comma-separated)",
required = false,
placeholder = "adr-001,adr-005",
nickel_path = ["related_adrs"] },
{ type = "text", name = "related_dim",
prompt = "Related ontology dimension ID",
required = false,
placeholder = "reflection-modes-coverage",
help = "Query: nickel export .ontology/state.ncl | jq '.dimensions[].id'",
nickel_path = ["related_dim"] },
{ type = "text", name = "related_config",
prompt = "Related config seal ID (if this item tracks a config state)",
required = false,
placeholder = "cfg-001",
help = "The cfg-NNN seal this item is linked to. Query: ontoref config history <profile>",
nickel_path = ["related_config"] },
{ type = "section_header", name = "graduation_header",
title = "Graduation path", border_top = true, border_bottom = true },
{ type = "section", name = "graduation_note",
content = "When this item is ready, what does it become? This determines what 'ontoref backlog promote' will do." },
{ type = "select", name = "graduates_to",
prompt = "Graduates to",
options = [
{ value = "Adr", label = "ADR — becomes an architectural decision record" },
{ value = "Mode", label = "Mode — becomes a reflection mode with verifiable steps" },
{ value = "StateTransition", label = "StateTransition — moves an ontology dimension forward" },
{ value = "PrItem", label = "PrItem — becomes a PR checklist entry" },
],
nickel_path = ["graduates_to"] },
{ type = "confirm", name = "ready",
prompt = "Add this item to backlog.ncl?",
default = true,
nickel_path = ["ready"] },
],
}