[[categories]]
name = "Projects, epics and roadmap"
tips = [
"A project is a first-class delivery container keyed by a stable id; the name is only a display label.",
"tix project create allocates the id, and every association stores that id, so renaming a project never re-keys anything.",
"An issue may belong to several projects at once, and a project's members are derived on read, never stored.",
"tix edit 3 --add-project p-7b1e04 associates; --remove-project drops one; --projects '' clears them all.",
"An epic is a cross-cutting container that may have one parent epic and many member issues.",
"Tasks are ordinary issues: a task-labelled issue that references an epic is a member like any other.",
"tix epic navigate e-7c4a91 walks an epic's parent, children, ancestors and depth.",
"An initiative is the strategic outcome a project, epic or milestone delivers; tix initiative create records it.",
"Initiatives associate a project by id, an epic by id and a milestone by name — that asymmetry is deliberate.",
"tix roadmap list --owner alice --label reliability --from 2026-01-01 filters one normalized plan shared by the CLI, the TUI and MCP.",
"The roadmap shows each source's own progress beside the health policy's risk state — a join, not a blended score.",
"A dangling project or epic reference is never dropped: the id stays on the issue and tix lint reports it.",
"The F10 Portfolio page has Projects, Epics and Roadmap tabs over the same services the CLI uses.",
"tix export --target roadmap writes the portable, versioned roadmap document.",
]