diff --git a/.claude/rules/ticket-cli.md b/.claude/rules/ticket-cli.md index 3a498798e..f0d2072a8 100644 --- a/.claude/rules/ticket-cli.md +++ b/.claude/rules/ticket-cli.md @@ -45,9 +45,9 @@ pql ticket show T-440 --with-blockers # what blocks this pql ticket block T-7 --by T-440 # T-440 blocks T-7 pql ticket unblock T-7 --from T-440 # remove that edge -# Labels (also used as milestones — see below) -pql ticket label T-440 add phase:4 -pql ticket label T-440 remove phase:4 +# Labels (action is add | rm) +pql ticket label T-440 add needs-refinement +pql ticket label T-440 rm needs-refinement # Refinement (tickets with no description are "unrefined") pql ticket refine list @@ -80,14 +80,18 @@ pql decisions sync # parse governance/*.md -> pql.db pql decisions validate # malformed-record gate (pre-commit) ``` -## Milestones → labels +## Phases → the cascade hierarchy (no milestone entity) -pql has **no milestone entity** (the legacy milestone subsystem was vestigial). Phase -gating is expressed with **labels**: the active phase is `phase:4`. +pql has **no milestone entity** (the legacy one was vestigial). Phase gating is the +**ticket hierarchy**: the initiative `T-745` (Development Cascade) holds the six phases +as epics; a ticket is in a phase by being parented under that phase epic — self-maintaining, +no label to apply or forget. The active phase is the phase epic with status `in_progress` +(sequential per D-166 → the lowest-numbered non-`done` phase epic; currently `T-750`, Phase 4). ```bash -pql ticket list --label phase:4 --unblocked # the kanban "what's ready in this phase" -pql ticket label T-950 add phase:4 # put a ticket in the phase +pql ticket list --under T-750 --unblocked # the kanban "what's ready in this phase" +pql ticket setparent T-990 T-750 # put a ticket in the phase (re-parent) +pql ticket show T-745 --tree # the whole cascade ``` ## Key rules diff --git a/.claude/skills/ticket/SKILL.md b/.claude/skills/ticket/SKILL.md index 3be1b7d8c..ff2998fb6 100644 --- a/.claude/skills/ticket/SKILL.md +++ b/.claude/skills/ticket/SKILL.md @@ -40,7 +40,7 @@ pql ticket assign T-440 dudley pql ticket team T-440 server # comma teams allowed: server,client pql ticket setparent T-9 T-2 pql ticket append T-440 "extra context" # --file PATH / --stdin -pql ticket label T-440 add|remove