chief-clancy 0.7.3 → 0.8.0

package/src/roles/setup/workflows/scaffold.md

@@ -396,6 +396,16 @@ MAX_ITERATIONS=5
 # CLANCY_GIT_PLATFORM=gitlab               # override auto-detection (github/gitlab/bitbucket)
 # CLANCY_GIT_API_URL=https://gitlab.example.com/api/v4  # self-hosted git API base URL
 
+# ─── Optional: Pipeline labels ────────────────────────────────────────────────
+# Labels that control ticket flow through pipeline stages.
+# CLANCY_LABEL_BRIEF marks tickets that have been briefed (awaiting approval).
+# CLANCY_LABEL_PLAN marks tickets that need planning.
+# CLANCY_LABEL_BUILD marks tickets ready for implementation.
+# Deprecated: CLANCY_LABEL (use CLANCY_LABEL_BUILD), CLANCY_PLAN_LABEL (use CLANCY_LABEL_PLAN)
+# CLANCY_LABEL_BRIEF="clancy:brief"
+# CLANCY_LABEL_PLAN="clancy:plan"
+# CLANCY_LABEL_BUILD="clancy:build"
+
 # ─── Optional: Rework loop ──────────────────────────────────────────────────
 # PR-based rework is automatic — when a reviewer leaves inline comments or
 # a conversation comment prefixed with "Rework:", Clancy picks it up on the
@@ -446,6 +456,15 @@ MAX_ITERATIONS=5
 # Prevent accidental commits to the base branch (default: true)
 # CLANCY_BRANCH_GUARD=true
 
+# ─── Optional: Quiet hours ───────────────────────────────────────────────────
+# Pause AFK runs during these hours (24h format). Handles overnight windows.
+# CLANCY_QUIET_START=22:00
+# CLANCY_QUIET_END=06:00
+
+# ─── Optional: Desktop notifications ─────────────────────────────────────────
+# Native OS notifications on ticket completion or error (default: true)
+# CLANCY_DESKTOP_NOTIFY=true
+
 # ─── Optional: Notifications ──────────────────────────────────────────────────
 # Webhook URL for Slack or Teams notifications on ticket completion
 # CLANCY_NOTIFY_WEBHOOK=https://hooks.slack.com/services/your/webhook/url
@@ -502,6 +521,16 @@ MAX_ITERATIONS=20
 # PLAYWRIGHT_STORYBOOK_PORT=6006
 # PLAYWRIGHT_STARTUP_WAIT=15
 
+# ─── Optional: Pipeline labels ────────────────────────────────────────────────
+# Labels that control ticket flow through pipeline stages.
+# CLANCY_LABEL_BRIEF marks tickets that have been briefed (awaiting approval).
+# CLANCY_LABEL_PLAN marks tickets that need planning.
+# CLANCY_LABEL_BUILD marks tickets ready for implementation.
+# Deprecated: CLANCY_LABEL (use CLANCY_LABEL_BUILD), CLANCY_PLAN_LABEL (use CLANCY_LABEL_PLAN)
+# CLANCY_LABEL_BRIEF="clancy:brief"
+# CLANCY_LABEL_PLAN="clancy:plan"
+# CLANCY_LABEL_BUILD="clancy:build"
+
 # ─── Optional: Rework loop ──────────────────────────────────────────────────
 # PR-based rework is automatic — when a reviewer leaves inline comments or
 # a conversation comment prefixed with "Rework:", Clancy picks it up on the
@@ -543,6 +572,148 @@ MAX_ITERATIONS=20
 
 # ─── Optional: Notifications ──────────────────────────────────────────────────
 # Webhook URL for Slack or Teams notifications on ticket completion
+# ─── Optional: Quiet hours ───────────────────────────────────────────────────
+# CLANCY_QUIET_START=22:00
+# CLANCY_QUIET_END=06:00
+
+# ─── Optional: Desktop notifications ─────────────────────────────────────────
+# CLANCY_DESKTOP_NOTIFY=true
+
+# ─── Optional: Notifications ──────────────────────────────────────────────────
+# CLANCY_NOTIFY_WEBHOOK=https://hooks.slack.com/services/your/webhook/url
+```
+
+### Shortcut
+
+```
+# Clancy — Shortcut configuration
+# Copy this file to .env and fill in your values.
+# Never commit .env to version control.
+
+# ─── Shortcut ────────────────────────────────────────────────────────────────
+SHORTCUT_API_TOKEN=your-api-token
+
+# Optional: workflow name (default: auto-detect first workflow)
+# SHORTCUT_WORKFLOW=Engineering
+
+# ─── Git ──────────────────────────────────────────────────────────────────────
+CLANCY_BASE_BRANCH=main
+
+# ─── Loop ─────────────────────────────────────────────────────────────────────
+MAX_ITERATIONS=5
+
+# ─── Optional: Git host (PR creation) ───────────────────────────────────────
+# GITHUB_TOKEN=ghp_your-token
+# GITLAB_TOKEN=glpat-your-token
+# BITBUCKET_USER=your-username
+# BITBUCKET_TOKEN=your-app-password
+
+# ─── Optional: Pipeline labels ────────────────────────────────────────────────
+# CLANCY_LABEL_BRIEF="clancy:brief"
+# CLANCY_LABEL_PLAN="clancy:plan"
+# CLANCY_LABEL_BUILD="clancy:build"
+
+# ─── Optional: Status transitions ────────────────────────────────────────────
+# CLANCY_STATUS_IN_PROGRESS="In Progress"
+# CLANCY_STATUS_DONE="Done"
+# CLANCY_STATUS_REVIEW="In Review"
+
+# ─── Optional: Quiet hours ───────────────────────────────────────────────────
+# CLANCY_QUIET_START=22:00
+# CLANCY_QUIET_END=06:00
+
+# ─── Optional: Desktop notifications ─────────────────────────────────────────
+# CLANCY_DESKTOP_NOTIFY=true
+
+# ─── Optional: Notifications ──────────────────────────────────────────────────
+# CLANCY_NOTIFY_WEBHOOK=https://hooks.slack.com/services/your/webhook/url
+```
+
+### Notion
+
+```
+# Clancy — Notion configuration
+# Copy this file to .env and fill in your values.
+# Never commit .env to version control.
+
+# ─── Notion ──────────────────────────────────────────────────────────────────
+NOTION_TOKEN=your-integration-token
+NOTION_DATABASE_ID=your-database-id-32-char-hex
+
+# Optional: property name overrides (defaults shown)
+# CLANCY_NOTION_STATUS=Status
+# CLANCY_NOTION_ASSIGNEE=Assignee
+
+# ─── Git ──────────────────────────────────────────────────────────────────────
+CLANCY_BASE_BRANCH=main
+
+# ─── Loop ─────────────────────────────────────────────────────────────────────
+MAX_ITERATIONS=5
+
+# ─── Optional: Git host (PR creation) ───────────────────────────────────────
+# GITHUB_TOKEN=ghp_your-token
+# GITLAB_TOKEN=glpat-your-token
+# BITBUCKET_USER=your-username
+# BITBUCKET_TOKEN=your-app-password
+
+# ─── Optional: Pipeline labels ────────────────────────────────────────────────
+# CLANCY_LABEL_BRIEF="clancy:brief"
+# CLANCY_LABEL_PLAN="clancy:plan"
+# CLANCY_LABEL_BUILD="clancy:build"
+
+# ─── Optional: Quiet hours ───────────────────────────────────────────────────
+# CLANCY_QUIET_START=22:00
+# CLANCY_QUIET_END=06:00
+
+# ─── Optional: Desktop notifications ─────────────────────────────────────────
+# CLANCY_DESKTOP_NOTIFY=true
+
+# ─── Optional: Notifications ──────────────────────────────────────────────────
+# CLANCY_NOTIFY_WEBHOOK=https://hooks.slack.com/services/your/webhook/url
+```
+
+### Azure DevOps
+
+```
+# Clancy — Azure DevOps configuration
+# Copy this file to .env and fill in your values.
+# Never commit .env to version control.
+
+# ─── Azure DevOps ────────────────────────────────────────────────────────────
+AZDO_ORG=your-organisation
+AZDO_PROJECT=your-project
+AZDO_PAT=your-personal-access-token
+
+# ─── Git ──────────────────────────────────────────────────────────────────────
+CLANCY_BASE_BRANCH=main
+
+# ─── Loop ─────────────────────────────────────────────────────────────────────
+MAX_ITERATIONS=5
+
+# ─── Optional: Git host (PR creation) ───────────────────────────────────────
+# GITHUB_TOKEN=ghp_your-token
+# GITLAB_TOKEN=glpat-your-token
+# BITBUCKET_USER=your-username
+# BITBUCKET_TOKEN=your-app-password
+
+# ─── Optional: Pipeline labels ────────────────────────────────────────────────
+# CLANCY_LABEL_BRIEF="clancy:brief"
+# CLANCY_LABEL_PLAN="clancy:plan"
+# CLANCY_LABEL_BUILD="clancy:build"
+
+# ─── Optional: Status transitions ────────────────────────────────────────────
+# CLANCY_STATUS_IN_PROGRESS="Active"
+# CLANCY_STATUS_DONE="Closed"
+# CLANCY_STATUS_REVIEW="Resolved"
+
+# ─── Optional: Quiet hours ───────────────────────────────────────────────────
+# CLANCY_QUIET_START=22:00
+# CLANCY_QUIET_END=06:00
+
+# ─── Optional: Desktop notifications ─────────────────────────────────────────
+# CLANCY_DESKTOP_NOTIFY=true
+
+# ─── Optional: Notifications ──────────────────────────────────────────────────
 # CLANCY_NOTIFY_WEBHOOK=https://hooks.slack.com/services/your/webhook/url
 ```
 
@@ -636,6 +807,16 @@ MAX_ITERATIONS=20
 # CLANCY_GIT_PLATFORM=gitlab               # override auto-detection (github/gitlab/bitbucket)
 # CLANCY_GIT_API_URL=https://gitlab.example.com/api/v4  # self-hosted git API base URL
 
+# ─── Optional: Pipeline labels ────────────────────────────────────────────────
+# Labels that control ticket flow through pipeline stages.
+# CLANCY_LABEL_BRIEF marks tickets that have been briefed (awaiting approval).
+# CLANCY_LABEL_PLAN marks tickets that need planning.
+# CLANCY_LABEL_BUILD marks tickets ready for implementation.
+# Deprecated: CLANCY_LABEL (use CLANCY_LABEL_BUILD), CLANCY_PLAN_LABEL (use CLANCY_LABEL_PLAN)
+# CLANCY_LABEL_BRIEF="clancy:brief"
+# CLANCY_LABEL_PLAN="clancy:plan"
+# CLANCY_LABEL_BUILD="clancy:build"
+
 # ─── Optional: Reliable autonomous mode ───────────────────────────────────────
 # Max self-healing attempts after verification failure (default: 2, range 0-5)
 # CLANCY_FIX_RETRIES=2
@@ -651,6 +832,13 @@ MAX_ITERATIONS=20
 # Set to "false" to disable skip comments
 # CLANCY_SKIP_COMMENTS=true
 
+# ─── Optional: Quiet hours ───────────────────────────────────────────────────
+# CLANCY_QUIET_START=22:00
+# CLANCY_QUIET_END=06:00
+
+# ─── Optional: Desktop notifications ─────────────────────────────────────────
+# CLANCY_DESKTOP_NOTIFY=true
+
 # ─── Optional: Notifications ──────────────────────────────────────────────────
 # Webhook URL for Slack or Teams notifications on ticket completion
 # CLANCY_NOTIFY_WEBHOOK=https://hooks.slack.com/services/your/webhook/url

package/src/roles/setup/workflows/settings.md

@@ -35,6 +35,9 @@ Source `.clancy/.env` silently. Detect which board is configured:
 - `JIRA_BASE_URL` set → Jira
 - `GITHUB_TOKEN` set → GitHub Issues
 - `LINEAR_API_KEY` set → Linear
+- `SHORTCUT_API_TOKEN` set → Shortcut
+- `NOTION_DATABASE_ID` set → Notion
+- `AZDO_ORG` set → Azure DevOps
 
 ---
 
@@ -58,6 +61,8 @@ General
   [G7] Fix retries        {CLANCY_FIX_RETRIES:-2}          self-healing attempts after verification failure
   [G8] Time limit         {CLANCY_TIME_LIMIT:-30}          per-ticket time limit in minutes (0 = disabled)
   [G9] Branch guard       {on if CLANCY_BRANCH_GUARD=true or unset, off if false}
+  [G10] Quiet hours       {CLANCY_QUIET_START–CLANCY_QUIET_END if set, else off}
+  [G11] Desktop notify    {on if CLANCY_DESKTOP_NOTIFY=true or unset, off if false}
 
 {If Jira:}
 Jira
@@ -86,6 +91,14 @@ Strategist
   [T2] Issue type        {CLANCY_BRIEF_ISSUE_TYPE:-Task}
   [T3] Component         {CLANCY_COMPONENT if set, else "off"}
 
+{If Planner or Strategist enabled:}
+Pipeline Labels
+  [L1] Brief label         {CLANCY_LABEL_BRIEF if set, else "clancy:brief"}    (Strategist only)
+  [L2] Plan label          {CLANCY_LABEL_PLAN if set, else "clancy:plan"}
+  [L3] Build label         {CLANCY_LABEL_BUILD if set, else "clancy:build"}
+  {If CLANCY_LABEL or CLANCY_PLAN_LABEL set:}
+  ⚠ CLANCY_LABEL and CLANCY_PLAN_LABEL are deprecated. Use CLANCY_LABEL_BUILD and CLANCY_LABEL_PLAN.
+
 {If Planner enabled:}
 Planner
 {If Jira:}
@@ -105,7 +118,7 @@ Integrations
   [I2] Playwright        {enabled if PLAYWRIGHT_ENABLED=true, else off}
   [I3] Notifications     {configured if CLANCY_NOTIFY_WEBHOOK set, else not set}
 
-  [S]  Switch board      currently: {Jira / GitHub Issues / Linear}
+  [S]  Switch board      currently: {Jira / GitHub Issues / Linear / Shortcut / Notion / Azure DevOps}
   [D]  Save as defaults  save current settings for all future projects
   [X]  Exit
 
@@ -270,6 +283,37 @@ If [2]: write `CLANCY_BRANCH_GUARD=false` to `.clancy/.env`.
 
 ---
 
+### [G10] Quiet hours
+
+```
+Quiet hours — current: {CLANCY_QUIET_START–CLANCY_QUIET_END or "off"}
+Pause AFK runs during these hours. Clancy sleeps until the end of the quiet window.
+
+[1] Set quiet hours
+[2] Off (no quiet hours)
+[3] Cancel
+```
+
+If [1]: prompt `Quiet start time (HH:MM, 24h format):` then `Quiet end time (HH:MM, 24h format):`. Validate HH:MM format (0-23:00-59). Write `CLANCY_QUIET_START` and `CLANCY_QUIET_END` to `.clancy/.env`.
+If [2]: remove `CLANCY_QUIET_START` and `CLANCY_QUIET_END` from `.clancy/.env`.
+
+---
+
+### [G11] Desktop notifications
+
+```
+Desktop notifications — current: {on/off}
+Native OS notifications when tickets complete or errors occur.
+
+[1] Enable (default)
+[2] Disable
+```
+
+If [1]: write `CLANCY_DESKTOP_NOTIFY=true` to `.clancy/.env`.
+If [2]: write `CLANCY_DESKTOP_NOTIFY=false` to `.clancy/.env`.
+
+---
+
 ### [B1] Jira status filter (Jira only)
 
 ```
@@ -539,6 +583,60 @@ If [2]: remove `CLANCY_COMPONENT` from `.clancy/.env`.
 
 ---
 
+### [L1] Brief label
+
+Only shown when Strategist is enabled.
+
+```
+Brief label — current: {value or "clancy:brief"}
+Label applied to tickets after /clancy:brief. Removed when the brief is approved.
+
+[1] clancy:brief (default)
+[2] Enter a different value
+[3] Cancel
+```
+
+If [1]: remove `CLANCY_LABEL_BRIEF` from `.clancy/.env` (uses default).
+If [2]: prompt `What label should /clancy:brief apply?` then write `CLANCY_LABEL_BRIEF=<value>` to `.clancy/.env`. Wrap in double quotes.
+
+---
+
+### [L2] Plan label
+
+Only shown when Planner or Strategist is enabled.
+
+```
+Plan label — current: {value or "clancy:plan"}
+Label applied to tickets that need planning. Removed when the plan is approved.
+
+[1] clancy:plan (default)
+[2] Enter a different value
+[3] Cancel
+```
+
+If [1]: remove `CLANCY_LABEL_PLAN` from `.clancy/.env` (uses default).
+If [2]: prompt `What label should mark tickets needing planning?` then write `CLANCY_LABEL_PLAN=<value>` to `.clancy/.env`. Wrap in double quotes.
+
+---
+
+### [L3] Build label
+
+Only shown when Planner or Strategist is enabled.
+
+```
+Build label — current: {value or "clancy:build"}
+Label applied to tickets ready for implementation. Used by /clancy:once and /clancy:run to filter the queue.
+
+[1] clancy:build (default)
+[2] Enter a different value
+[3] Cancel
+```
+
+If [1]: remove `CLANCY_LABEL_BUILD` from `.clancy/.env` (uses default).
+If [2]: prompt `What label should mark tickets ready to build?` then write `CLANCY_LABEL_BUILD=<value>` to `.clancy/.env`. Wrap in double quotes.
+
+---
+
 ### [P1] Plan queue status (Jira only)
 
 ```
@@ -677,17 +775,18 @@ If [2]: remove `CLANCY_NOTIFY_WEBHOOK` from `.clancy/.env`.
 
 ### [S] Switch board
 
-Show which board is currently active, then offer the other two:
+Show which board is currently active, then offer the others:
 
 ```
-Switch board — currently: {Jira / GitHub Issues / Linear}
+Switch board — currently: {Jira / GitHub Issues / Linear / Shortcut / Notion / Azure DevOps}
 
 [1] {board A}
 [2] {board B}
-[3] Cancel
+...
+[N] Cancel
 ```
 
-Only show the two boards that are not currently active. If the user picks Cancel, loop back to the menu without changing anything.
+Only show the boards that are not currently active. If the user picks Cancel, loop back to the menu without changing anything.
 
 **Step 1: Collect new credentials**
 
@@ -713,6 +812,21 @@ Linear — ask in this order:
 1. `Paste your Linear API key: (create one at linear.app/settings/api)`
 2. `What's your Linear team ID? (find it at linear.app/settings/teams — click your team, copy the ID from the URL)`
 
+Shortcut — ask in this order:
+1. `Paste your Shortcut API token: (create one at app.shortcut.com/settings/account/api-tokens)`
+2. `What workflow should Clancy use? (press Enter to auto-detect)`
+
+Notion — ask in this order:
+1. `Paste your Notion integration token: (create one at notion.so/my-integrations)`
+2. `What's your Notion database ID? (32-character hex string from your database URL)`
+3. `Status property name? [Status]`
+4. `Assignee property name? [Assignee]`
+
+Azure DevOps — ask in this order:
+1. `What's your Azure DevOps organisation name?`
+2. `What's your project name?`
+3. `Paste your Azure DevOps personal access token: (needs Work Items Read & Write scope)`
+
 **Step 2: Verify credentials**
 
 Verify the new credentials before making any changes — same checks as the init preflight and doctor workflow. Show the result:
@@ -752,6 +866,9 @@ If no: print `Cancelled. No changes made.` and loop back to the menu.
    - Jira: `JIRA_BASE_URL`, `JIRA_USER`, `JIRA_API_TOKEN`, `JIRA_PROJECT_KEY`, `CLANCY_JQL_STATUS`, `CLANCY_JQL_SPRINT`
    - GitHub: `GITHUB_TOKEN`, `GITHUB_REPO`
    - Linear: `LINEAR_API_KEY`, `LINEAR_TEAM_ID`
+   - Shortcut: `SHORTCUT_API_TOKEN`, `SHORTCUT_WORKFLOW`
+   - Notion: `NOTION_TOKEN`, `NOTION_DATABASE_ID`, `CLANCY_NOTION_STATUS`, `CLANCY_NOTION_ASSIGNEE`, `CLANCY_NOTION_LABELS`, `CLANCY_NOTION_PARENT`
+   - Azure DevOps: `AZDO_ORG`, `AZDO_PROJECT`, `AZDO_PAT`
    - Git host (all boards): `GITLAB_TOKEN`, `BITBUCKET_USER`, `BITBUCKET_TOKEN`, `CLANCY_GIT_PLATFORM`, `CLANCY_GIT_API_URL`, `CLANCY_STATUS_REVIEW`
 2. Write the new board credentials to `.clancy/.env`
 3. If switching to Jira: also ask the status filter question (same as init Q3) and write `CLANCY_JQL_STATUS` to `.clancy/.env`

package/src/roles/setup/workflows/update.md

@@ -161,9 +161,45 @@ This touches:
 It never modifies:
 - `.clancy/docs/` — codebase documentation
 - `.clancy/progress.txt` — progress log
-- `.clancy/.env` — credentials
 - `CLAUDE.md`
 
+It may **append** to:
+- `.clancy/.env` — adds missing env var defaults (see Step 4a)
+
+---
+
+## Step 4a — Backfill missing env var defaults
+
+After the installer finishes, read `.clancy/.env` and check for missing pipeline label variables. These were introduced in v0.7.4 and won't exist in `.env` files from earlier installs.
+
+**Check for and append if missing:**
+
+```
+# Pipeline labels (added in v0.7.4)
+CLANCY_LABEL_BRIEF=clancy:brief
+CLANCY_LABEL_PLAN=clancy:plan
+CLANCY_LABEL_BUILD=clancy:build
+```
+
+For each variable:
+1. Read `.clancy/.env` content
+2. If the variable name does NOT appear anywhere in the file (not even commented out), append it with its default value
+3. If the variable already exists (even with a different value), leave it untouched
+
+Add a blank line and a `# Pipeline labels (added in v0.7.4)` comment header before the new variables, but only if at least one variable was added.
+
+**Display what was added (if any):**
+```
+📋 Added missing env var defaults to .clancy/.env:
+   CLANCY_LABEL_BRIEF=clancy:brief
+   CLANCY_LABEL_PLAN=clancy:plan
+   CLANCY_LABEL_BUILD=clancy:build
+
+   Customise these via /clancy:settings → L1/L2/L3
+```
+
+If nothing was added, display nothing.
+
 ---
 
 ## Step 5 — Check for local patches

package/src/roles/strategist/workflows/approve-brief.md

@@ -218,13 +218,20 @@ Platform-specific pre-creation lookups.
 
 ### GitHub
 
+**Pipeline label for children — this is mandatory, always apply a pipeline label to every child ticket.** Determine which label to use:
+- `--skip-plan` flag → use `CLANCY_LABEL_BUILD` from `.clancy/.env` if set, otherwise `clancy:build`
+- Planner role enabled (`CLANCY_ROLES` includes `planner`) → use `CLANCY_LABEL_PLAN` from `.clancy/.env` if set, otherwise `clancy:plan`
+- Planner role NOT enabled → use `CLANCY_LABEL_BUILD` from `.clancy/.env` if set, otherwise `clancy:build`
+Ensure the label exists on the board (create it if missing), then add it to each child ticket.
+
 **Labels to apply per ticket:**
-- `CLANCY_PLAN_LABEL` (default: `needs-refinement`) — planning queue
-- `CLANCY_LABEL` (if set) — Clancy identifier
+- The pipeline label determined above (`CLANCY_LABEL_PLAN` or `CLANCY_LABEL_BUILD`) — replaces `CLANCY_LABEL` on children
 - `component:{CLANCY_COMPONENT}` (if `CLANCY_COMPONENT` set)
 - `size:{S|M|L}` — from decomposition table
 - `clancy:afk` or `clancy:hitl` — from Mode column
 
+Note: `CLANCY_LABEL` is NOT applied to child tickets when pipeline labels are active. The pipeline label (`clancy:plan` or `clancy:build`) serves as the queue identifier.
+
 **Label pre-creation:** For each unique label, attempt to create it on the repo. If it already exists, GitHub returns 422 — ignore that error. If 403 (no admin access), note the label as unavailable.
 
 ```bash
@@ -266,7 +273,9 @@ Set CLANCY_BRIEF_ISSUE_TYPE in .clancy/.env.
 ```
 Stop.
 
-**Labels:** Jira auto-creates labels — no pre-creation needed. Apply: `CLANCY_LABEL` (if set), `clancy:afk` or `clancy:hitl`.
+**Pipeline label for children — mandatory, same logic as GitHub.** Use `CLANCY_LABEL_PLAN` or `CLANCY_LABEL_BUILD` from `.clancy/.env` (defaults: `clancy:plan` / `clancy:build`). Always apply to every child ticket.
+
+**Labels:** Jira auto-creates labels — no pre-creation needed. Apply: the pipeline label determined above, `clancy:afk` or `clancy:hitl`. `CLANCY_LABEL` is NOT applied to children when pipeline labels are active.
 
 **Components:** If `CLANCY_COMPONENT` is set, it maps to the Jira `components` field.
 
@@ -297,7 +306,9 @@ query {
 }
 ```
 
-For each required label (`CLANCY_LABEL`, `component:{CLANCY_COMPONENT}`, `clancy:afk`, `clancy:hitl`): search by exact name. If not found in team labels, check workspace labels:
+**Pipeline label for children — mandatory, same logic as GitHub/Jira.** Use `CLANCY_LABEL_PLAN` or `CLANCY_LABEL_BUILD` from `.clancy/.env` (defaults: `clancy:plan` / `clancy:build`). Always apply to every child ticket.
+
+For each required label (the pipeline label, `component:{CLANCY_COMPONENT}`, `clancy:afk`, `clancy:hitl`): search by exact name. `CLANCY_LABEL` is NOT applied to children when pipeline labels are active. If not found in team labels, check workspace labels:
 
 ```graphql
 query {
@@ -370,7 +381,7 @@ curl -s \
   -d '{
     "title": "{ticket title}",
     "body": "Epic: #{parent_number}\n\n## {Title}\n\n{Description}\n\n---\n\n**Parent:** #{parent_number}\n**Brief:** {slug}\n**Size:** {S|M|L}\n\n### Dependencies\n\n{Depends on #NN lines or None}\n\n---\n\n*Created by Clancy from strategic brief.*",
-    "labels": ["{CLANCY_PLAN_LABEL}", "size:{size}", "clancy:{mode}", ...],
+    "labels": ["{PIPELINE_LABEL}", "size:{size}", "clancy:{mode}", ...],
     "assignees": ["{resolved_username}"]
   }'
 ```
@@ -412,7 +423,7 @@ curl -s \
       },
       "issuetype": { "name": "{CLANCY_BRIEF_ISSUE_TYPE or Task}" },
       "parent": { "key": "{PARENT_KEY}" },
-      "labels": ["{CLANCY_LABEL}", "clancy:{mode}"]
+      "labels": ["{PIPELINE_LABEL}", "clancy:{mode}"]
     }
   }'
 ```
@@ -631,6 +642,60 @@ Created by Clancy on {YYYY-MM-DD}.
 
 ---
 
+## Step 11a — Remove brief label from parent
+
+Only if a parent ticket exists AND all tickets were created successfully. Remove the brief label from the parent ticket. Best-effort — warn on failure, never stop.
+
+Use `CLANCY_LABEL_BRIEF` from `.clancy/.env` if set, otherwise `clancy:brief`.
+
+### GitHub
+
+```bash
+curl -s \
+  -H "Authorization: Bearer $GITHUB_TOKEN" \
+  -H "Accept: application/vnd.github+json" \
+  -H "X-GitHub-Api-Version: 2022-11-28" \
+  -X DELETE \
+  "https://api.github.com/repos/$GITHUB_REPO/issues/$PARENT_NUMBER/labels/$(echo $CLANCY_LABEL_BRIEF | jq -Rr @uri)"
+```
+
+Ignore 404 (label may not be present on the parent).
+
+### Jira
+
+```bash
+CURRENT_LABELS=$(curl -s \
+  -u "$JIRA_USER:$JIRA_API_TOKEN" \
+  -H "Accept: application/json" \
+  "$JIRA_BASE_URL/rest/api/3/issue/$PARENT_KEY?fields=labels" | jq -r '.fields.labels')
+
+UPDATED_LABELS=$(echo "$CURRENT_LABELS" | jq --arg brief "$CLANCY_LABEL_BRIEF" '[.[] | select(. != $brief)]')
+
+curl -s \
+  -u "$JIRA_USER:$JIRA_API_TOKEN" \
+  -X PUT \
+  -H "Content-Type: application/json" \
+  "$JIRA_BASE_URL/rest/api/3/issue/$PARENT_KEY" \
+  -d "{\"fields\": {\"labels\": $UPDATED_LABELS}}"
+```
+
+### Linear
+
+```bash
+# Fetch current label IDs on the parent, remove the brief label ID, issueUpdate
+# Use the same pattern as brief.md Step 10a — query labels, filter, update
+```
+
+### On failure
+
+```
+⚠️  Could not remove brief label from {PARENT_KEY}. Remove it manually if needed.
+```
+
+Continue — do not stop.
+
+---
+
 ## Step 12 — Display summary
 
 Show the final result: