convoke-agents 3.2.0 → 3.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/CHANGELOG.md +68 -0
  2. package/README.md +40 -11
  3. package/_bmad/bme/README.md +36 -0
  4. package/_bmad/bme/_enhance/workflows/initiatives-backlog/SKILL.md +1 -1
  5. package/_bmad/bme/_enhance/workflows/initiatives-backlog/steps-c/step-c-01-init.md +55 -32
  6. package/_bmad/bme/_enhance/workflows/initiatives-backlog/steps-c/step-c-02-gather.md +62 -59
  7. package/_bmad/bme/_enhance/workflows/initiatives-backlog/steps-c/step-c-03-qualify.md +176 -0
  8. package/_bmad/bme/_enhance/workflows/initiatives-backlog/steps-c/step-c-04-generate.md +259 -0
  9. package/_bmad/bme/_enhance/workflows/initiatives-backlog/steps-r/step-r-01-load.md +65 -35
  10. package/_bmad/bme/_enhance/workflows/initiatives-backlog/steps-r/step-r-02-rescore.md +60 -30
  11. package/_bmad/bme/_enhance/workflows/initiatives-backlog/steps-r/step-r-03-update.md +67 -71
  12. package/_bmad/bme/_enhance/workflows/initiatives-backlog/steps-t/step-t-01-ingest.md +12 -12
  13. package/_bmad/bme/_enhance/workflows/initiatives-backlog/steps-t/step-t-02-extract.md +49 -44
  14. package/_bmad/bme/_enhance/workflows/initiatives-backlog/steps-t/step-t-03-qualify.md +192 -0
  15. package/_bmad/bme/_enhance/workflows/initiatives-backlog/steps-t/step-t-04-update.md +72 -67
  16. package/_bmad/bme/_enhance/workflows/initiatives-backlog/templates/backlog-format-spec.md +223 -112
  17. package/_bmad/bme/_enhance/workflows/initiatives-backlog/templates/lifecycle-process-spec.md +188 -0
  18. package/_bmad/bme/_enhance/workflows/initiatives-backlog/workflow.md +44 -31
  19. package/_bmad/bme/_gyre/config.yaml +3 -0
  20. package/_bmad/bme/_vortex/config.yaml +4 -1
  21. package/package.json +2 -1
  22. package/scripts/convoke-doctor.js +56 -2
  23. package/scripts/lib/artifact-utils.js +16 -3
  24. package/scripts/migrate-artifacts.js +3 -2
  25. package/scripts/portability/catalog-generator.js +1 -1
  26. package/scripts/portability/convoke-export.js +26 -5
  27. package/scripts/portability/export-engine.js +34 -9
  28. package/scripts/portability/seed-catalog-repo.js +6 -6
  29. package/scripts/portability/validate-exports.js +25 -14
  30. package/scripts/update/convoke-update.js +27 -2
  31. package/scripts/update/lib/changelog-reader.js +90 -0
  32. package/scripts/update/lib/config-merger.js +52 -1
  33. package/scripts/update/lib/refresh-installation.js +48 -9
  34. package/scripts/update/lib/taxonomy-merger.js +2 -1
  35. package/scripts/update/lib/validator.js +9 -1
  36. package/_bmad/bme/_enhance/workflows/initiatives-backlog/steps-c/step-c-03-score.md +0 -146
  37. package/_bmad/bme/_enhance/workflows/initiatives-backlog/steps-c/step-c-04-prioritize.md +0 -181
  38. package/_bmad/bme/_enhance/workflows/initiatives-backlog/steps-t/step-t-03-score.md +0 -147
@@ -1,18 +1,18 @@
1
1
  ---
2
2
  name: 'step-r-02-rescore'
3
- description: 'Walk through backlog items one at a time for rescoring with RICE adjustments'
3
+ description: 'Walk lane items one at a time for RICE rescoring, lane-aware (Bug / Fast / Initiative)'
4
4
  nextStepFile: '{project-root}/_bmad/bme/_enhance/workflows/initiatives-backlog/steps-r/step-r-03-update.md'
5
- outputFile: '{planning_artifacts}/initiatives-backlog.md'
5
+ outputFile: '{planning_artifacts}/convoke-note-initiative-lifecycle-backlog.md'
6
6
  templateFile: '{project-root}/_bmad/bme/_enhance/workflows/initiatives-backlog/templates/rice-scoring-guide.md'
7
7
  advancedElicitationTask: '{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.md'
8
8
  partyModeWorkflow: '{project-root}/_bmad/core/workflows/bmad-party-mode/workflow.md'
9
9
  ---
10
10
 
11
- # Step 2: Item Walkthrough & Rescoring
11
+ # Step 2: Lane Walkthrough & Rescoring
12
12
 
13
13
  ## STEP GOAL:
14
14
 
15
- Walk through backlog items one at a time, presenting current scores and provenance, and allow the Product Owner to rescore, confirm, or skip each item. Track all decisions for the update step.
15
+ Walk through the selected lane items one at a time, presenting current scores and lane-specific context (Bug status, Fast Lane RICE, Initiative stage + artifacts), and allow the user to rescore, confirm, or skip each item. Track all decisions for the update step.
16
16
 
17
17
  ## MANDATORY EXECUTION RULES (READ FIRST):
18
18
 
@@ -24,17 +24,17 @@ Walk through backlog items one at a time, presenting current scores and provenan
24
24
 
25
25
  ### Role Reinforcement:
26
26
  - ✅ You are a **rescoring analyst** — systematic, evidence-based, calibration-aware
27
- - ✅ Present items faithfully with all current data — do not editorialize or suggest scores unless asked via A
27
+ - ✅ Present items faithfully with all current data — do not editorialize unless user invokes A
28
28
  - ✅ The user decides what changes to make — you calculate, display, and record
29
- - ✅ Compare adjusted scores against calibration examples for consistency
29
+ - ✅ Lane-aware: bugs emphasize risk-vs-cost, Fast Lane emphasizes effort, Initiative Lane includes Stage + Artifacts context
30
30
 
31
31
  ### Step-Specific Rules:
32
32
  - 🎯 Focus on per-item presentation, score adjustment, and decision tracking
33
33
  - 🚫 FORBIDDEN to write to the backlog file (that is step-r-03's job)
34
34
  - 🚫 FORBIDDEN to add new items (that is Triage mode's job)
35
- - 🚫 FORBIDDEN to delete or remove items from the backlog
35
+ - 🚫 FORBIDDEN to delete or promote/demote items between lanes (lane changes require separate qualification — noted for future item)
36
36
  - 🚫 FORBIDDEN to auto-advance without user input — ALWAYS halt and wait
37
- - 💬 Approach: present one item, wait for decision, record result, advance
37
+ - 💬 Approach: present one item with its lane context, wait for decision, record result, advance
38
38
 
39
39
  ## EXECUTION PROTOCOLS:
40
40
  - 🎯 Follow the MANDATORY SEQUENCE exactly
@@ -42,10 +42,10 @@ Walk through backlog items one at a time, presenting current scores and provenan
42
42
  - 💾 Track each item's decision: rescored (with old/new scores), confirmed, or skipped
43
43
 
44
44
  ## CONTEXT BOUNDARIES:
45
- - Available context: Parsed backlog items from step-r-01, RICE scoring guide
45
+ - Available context: `walk_scope` from step-r-01 (ordered list of lane items), RICE scoring guide
46
46
  - Focus: Per-item walkthrough and rescoring only
47
- - Limits: Do NOT write to backlog or modify the file
48
- - Dependencies: step-r-01-load.md (loaded and parsed items)
47
+ - Limits: Do NOT write to backlog, do NOT change item lanes
48
+ - Dependencies: step-r-01-load.md (loaded items + scope)
49
49
 
50
50
  ## MANDATORY SEQUENCE
51
51
 
@@ -53,22 +53,45 @@ Walk through backlog items one at a time, presenting current scores and provenan
53
53
 
54
54
  ### 1. Initialize Walkthrough State
55
55
 
56
- Set up tracking for the walkthrough:
56
+ Set up tracking:
57
57
  - `current_index` = 1
58
- - `total_items` = count from step-r-01
59
- - `rescored_items` = [] (items with changed scores)
60
- - `confirmed_items` = [] (items explicitly confirmed or C'd without changes)
61
- - `skipped_items` = [] (items skipped)
58
+ - `total_items` = count from `walk_scope`
59
+ - `rescored_items` = [] items with changed composite score
60
+ - `confirmed_items` = [] items explicitly confirmed or C'd without changes
61
+ - `skipped_items` = [] items skipped
62
62
 
63
- ### 2. Present Current Item
63
+ ### 2. Present Current Item (Lane-Aware)
64
64
 
65
- Display the current item with all scoring data:
65
+ Display the current item with lane-specific context:
66
66
 
67
- > **Item [current_index] of [total_items] — [Category Name]**
67
+ **If Bug Lane item:**
68
+
69
+ > **Item [current_index] of [total_items] — §2.2 Bug Lane**
70
+ >
71
+ > **[ID]: [Description]** — Score: [composite]
72
+ > R:[reach] I:[impact] C:[confidence]% E:[effort]
73
+ > *Status: [Open/In Fix/In Review/Shipped]*
74
+ > *Portfolio: [portfolio]*
75
+ > *Linked Follow-up: [fastLaneID or initiativeID, if any]*
76
+
77
+ **If Fast Lane item:**
78
+
79
+ > **Item [current_index] of [total_items] — §2.3 Fast Lane**
68
80
  >
69
- > **[ID]: [Title]** — Score: [composite]
81
+ > **[ID]: [Description]** — Score: [composite]
70
82
  > R:[reach] I:[impact] C:[confidence]% E:[effort]
71
- > *Provenance: [current provenance text]*
83
+ > *Status: [Backlog/In Story/In Sprint/Shipped]*
84
+ > *Portfolio: [portfolio]*
85
+
86
+ **If Initiative Lane item:**
87
+
88
+ > **Item [current_index] of [total_items] — §2.4 Initiative Lane**
89
+ >
90
+ > **[ID]: [Description]** — Score: [composite]
91
+ > R:[reach] I:[impact] C:[confidence]% E:[effort]
92
+ > *Stage: [Qualified / In Pipeline / Ready / In Sprint / Done]*
93
+ > *Portfolio: [portfolio]*
94
+ > *Artifacts: [artifacts indicator, e.g., "D, P✓, A, IR, E" or "ADR only" or "—"]*
72
95
 
73
96
  ### 3. Present Per-Item Menu
74
97
 
@@ -90,21 +113,23 @@ Display:
90
113
  > **[A] Advanced Elicitation** — Deeper scoring analysis
91
114
  > **[P] Party Mode** — Multi-perspective discussion
92
115
  > **[C] Continue** — Apply changes and advance to next item
116
+ >
117
+ > *Note: Changing an item's lane, stage, portfolio, or status is NOT done in Review mode. If this item's lane no longer fits, raise a new intake via Triage mode.*
93
118
 
94
119
  #### Menu Handling Logic:
95
120
 
96
- - IF `R [value]`: Validate value is integer 1-10. Update Reach for current item. Recalculate composite: Score = (R x I x C) / E. Redisplay updated item scores and menu.
121
+ - IF `R [value]`: Validate value is integer 1-10. Update Reach for current item. Recalculate composite: Score = (R × I × C) / E. Redisplay updated item scores and menu.
97
122
  - IF `I [value]`: Validate value is one of 0.25, 0.5, 1, 2, or 3. Update Impact. Recalculate composite. Redisplay updated item scores and menu.
98
123
  - IF `CF [value]`: Validate value is integer 20-100. Update Confidence. Recalculate composite. Redisplay updated item scores and menu.
99
124
  - IF `E [value]`: Validate value is integer 1-10. Update Effort. Recalculate composite. Redisplay updated item scores and menu.
100
125
  - IF K: Mark item as **confirmed**. Add to `confirmed_items`. Advance to next item (go to step 4).
101
126
  - IF S: Mark item as **skipped**. Add to `skipped_items`. Advance to next item (go to step 4).
102
127
  - IF X: Exit walkthrough early. Go to step 5.
103
- - IF A: Execute `{advancedElicitationTask}` for deeper scoring analysis of this item. When finished, redisplay the current item scores and this menu.
104
- - IF P: Execute `{partyModeWorkflow}` for multi-perspective scoring discussion of this item. When finished, redisplay the current item scores and this menu.
128
+ - IF A: Execute `{advancedElicitationTask}` for deeper scoring analysis of this item. When finished, redisplay.
129
+ - IF P: Execute `{partyModeWorkflow}` for multi-perspective discussion. When finished, redisplay.
105
130
  - IF C:
106
- - **If scores were changed:** Record old and new composite scores. Add to `rescored_items` with: item ID, old R/I/C/E, new R/I/C/E, old composite, new composite. Advance to next item (go to step 4).
107
- - **If NO scores were changed:** Treat as confirmed (same as K). Add to `confirmed_items`. Advance to next item (go to step 4).
131
+ - **If scores were changed:** Record old and new composite scores. Add to `rescored_items` with lane name, item ID, old R/I/C/E, new R/I/C/E, old composite, new composite. Advance.
132
+ - **If NO scores were changed:** Treat as confirmed (same as K). Advance.
108
133
  - IF any other input: Display "Unknown command. Use `R/I/CF/E [value]`, `K`, `S`, `X`, `A`, `P`, or `C`." then redisplay menu.
109
134
 
110
135
  #### EXECUTION RULES:
@@ -130,12 +155,17 @@ Display walkthrough summary:
130
155
  > **Confirmed:** [N] items
131
156
  > **Skipped:** [N] items
132
157
  > [If early exit: **Unvisited:** [N] items]
158
+ >
159
+ > **Rescored breakdown by lane:**
160
+ > - §2.2 Bug Lane: [n]
161
+ > - §2.3 Fast Lane: [n]
162
+ > - §2.4 Initiative Lane: [n]
133
163
 
134
164
  Then load, read the entire file, and execute `{project-root}/_bmad/bme/_enhance/workflows/initiatives-backlog/steps-r/step-r-03-update.md`, passing:
135
- - The list of rescored items (with old/new R/I/C/E and composite scores)
136
- - The counts of confirmed, skipped, and unvisited items
165
+ - `rescored_items` (each with lane name, ID, old and new R/I/C/E, old and new composites)
166
+ - Counts of confirmed, skipped, and unvisited items
137
167
 
138
168
  ## 🚨 SYSTEM SUCCESS/FAILURE METRICS:
139
- ### ✅ SUCCESS: Each item presented with full scoring data and provenance, user given per-item decision, score adjustments recalculated correctly, all decisions tracked (rescored/confirmed/skipped), results passed to step-r-03
140
- ### ❌ SYSTEM FAILURE: Items auto-advanced without user input, scores not recalculated after adjustment, decisions not tracked, items modified in backlog file, walkthrough skipped items silently
169
+ ### ✅ SUCCESS: Each lane item presented with lane-specific context (status / stage / artifacts), user given per-item decision, score adjustments recalculated correctly, all decisions tracked by lane, results passed to step-r-03
170
+ ### ❌ SYSTEM FAILURE: Items auto-advanced without input, lane context missing, scores not recalculated after adjustment, decisions not tracked, lane changes attempted, items modified in backlog file
141
171
  **Master Rule:** Skipping steps is FORBIDDEN.
@@ -1,16 +1,16 @@
1
1
  ---
2
2
  name: 'step-r-03-update'
3
- description: 'Apply rescores to backlog, regenerate prioritized view, present completion summary'
4
- outputFile: '{planning_artifacts}/initiatives-backlog.md'
3
+ description: 'Apply rescores in-place to lane tables, re-sort touched lanes, update Change Log, present completion summary'
4
+ outputFile: '{planning_artifacts}/convoke-note-initiative-lifecycle-backlog.md'
5
5
  templateFile: '{project-root}/_bmad/bme/_enhance/workflows/initiatives-backlog/templates/backlog-format-spec.md'
6
6
  workflowFile: '{project-root}/_bmad/bme/_enhance/workflows/initiatives-backlog/workflow.md'
7
7
  ---
8
8
 
9
- # Step 3: Backlog Update, Safety & Completion
9
+ # Step 3: Backlog Update Apply Rescores Lane-Aware
10
10
 
11
11
  ## STEP GOAL:
12
12
 
13
- Validate backlog structure, apply rescored items in-place, regenerate the prioritized view, and present a completion summary before returning to the T/R/C menu.
13
+ Validate backlog structure, apply rescored items in-place in their lane tables (§2.2 Bug / §2.3 Fast / §2.4 Initiative), re-sort only the lanes that were touched, update the Change Log, and present a completion summary before returning to the T/R/C menu.
14
14
 
15
15
  ## MANDATORY EXECUTION RULES (READ FIRST):
16
16
 
@@ -22,17 +22,18 @@ Validate backlog structure, apply rescored items in-place, regenerate the priori
22
22
 
23
23
  ### Role Reinforcement:
24
24
  - ✅ You are a **backlog operations specialist** — precise, non-destructive, in-place updates only
25
- - ✅ Preserve all existing content never delete, overwrite, or reorder existing rows
26
- - ✅ The Prioritized View is the ONLY section regenerated from scratch
27
- - ✅ All output must be standard markdown no HTML, no proprietary syntax
25
+ - ✅ Preserve all existing content outside of the rescored rows and the sort order of their lanes
26
+ - ✅ **Part 1 (Lifecycle Process) must not be modified** it's semi-static documentation
27
+ - ✅ **§2.1 Intakes and §2.5 Absorbed must not be modified**Review does not touch them
28
+ - ✅ Re-sort only the touched lanes — untouched lanes keep their current row order
28
29
 
29
30
  ### Step-Specific Rules:
30
- - 🎯 Focus on validation, safe in-place updates, and completion reporting
31
- - 🚫 FORBIDDEN to delete or reorder existing backlog items (FR18, NFR1)
32
- - 🚫 FORBIDDEN to add new items (that is Triage mode's job)
33
- - 🚫 FORBIDDEN to modify items that were confirmed or skipped only rescored items are updated
34
- - 🚫 FORBIDDEN to modify step-r-01 or step-r-02
35
- - 💬 Approach: validate first, update safely, summarize clearly
31
+ - 🎯 Focus on validation, safe in-place updates, lane-specific re-sort, and completion reporting
32
+ - 🚫 FORBIDDEN to delete or add rows (add = Triage, remove = Absorb via separate flow)
33
+ - 🚫 FORBIDDEN to modify items that were confirmed or skipped
34
+ - 🚫 FORBIDDEN to change items' lane / portfolio / stage / status (Review only rescores RICE)
35
+ - 🚫 FORBIDDEN to modify Part 1, §2.1, or §2.5
36
+ - 💬 Approach: validate first, update rescored rows in-place, re-sort touched lanes, summarize
36
37
 
37
38
  ## EXECUTION PROTOCOLS:
38
39
  - 🎯 Follow the MANDATORY SEQUENCE exactly
@@ -40,10 +41,10 @@ Validate backlog structure, apply rescored items in-place, regenerate the priori
40
41
  - 💾 Write to `{outputFile}` only after validation passes (or user overrides)
41
42
 
42
43
  ## CONTEXT BOUNDARIES:
43
- - Available context: Rescored items from step-r-02, existing backlog file, backlog format spec template
44
- - Focus: Structural validation, safe in-place update, prioritized view regeneration, completion summary
45
- - Limits: Do NOT rescore, re-extract, or add items
46
- - Dependencies: step-r-02-rescore.md (rescored/confirmed/skipped results)
44
+ - Available context: `rescored_items` from step-r-02 (with lane, ID, old+new scores), existing backlog, format spec
45
+ - Focus: Structural validation, in-place update, per-lane re-sort, Change Log, completion summary
46
+ - Limits: Do NOT rescore, re-extract, add items, or change lane metadata
47
+ - Dependencies: step-r-02-rescore.md (rescored + confirmed + skipped results)
47
48
 
48
49
  ## MANDATORY SEQUENCE
49
50
 
@@ -51,80 +52,70 @@ Validate backlog structure, apply rescored items in-place, regenerate the priori
51
52
 
52
53
  ### 1. Pre-Write Validation
53
54
 
54
- Load `{outputFile}` (existing backlog) and validate structural integrity:
55
+ Load `{outputFile}` and validate per format spec:
55
56
 
56
- 1. **Section heading anchors** — All 7 required H2 sections exist in correct order:
57
- - `## RICE Scoring Guide`
58
- - `## Backlog`
59
- - `## Exploration Candidates`
60
- - `## Epic Groupings`
61
- - `## Prioritized View (by RICE Score)`
62
- - `## Completed`
63
- - `## Change Log`
64
- 2. **Prioritized view table** — Has exactly 6 columns (Rank, #, Initiative, Score, Track, Category)
65
- 3. **Category tables** — Each table under `## Backlog` has exactly 10 columns (#, Initiative, Source, R, I, C, E, Score, Track, Status)
66
- 4. **Change Log section** — The `## Change Log` H2 section exists with a table
57
+ 1. **Frontmatter present**
58
+ 2. **Part 1 anchor exists** (not inspected for content)
59
+ 3. **Part 2 H3 anchors** — `### 2.1` through `### 2.5` in correct order
60
+ 4. **Lane table column counts** — Bug (10), Fast (9), Initiative (10)
61
+ 5. **Change Log section** — `## Change Log` H2 exists
67
62
 
68
- If ALL checks pass, proceed directly to step 3 (Apply Rescores).
63
+ If ALL checks pass, proceed to step 3.
69
64
 
70
65
  ### 2. Mismatch Handling
71
66
 
72
- If ANY validation check fails, present the specific mismatch(es):
67
+ If ANY validation check fails:
73
68
 
74
69
  > **Pre-Write Validation — Structural Mismatch Detected**
75
70
  >
76
- > [List each failed check with details]
71
+ > [List each failed check]
77
72
  >
78
73
  > **[Y] Yes, proceed anyway**
79
74
  > **[X] Abort and return to menu**
80
75
 
81
- **ALWAYS halt and wait for user input.**
76
+ **ALWAYS halt and wait.**
82
77
 
83
- - IF Y: Continue to step 3 (Apply Rescores)
84
- - IF X: Display "Aborting backlog update." then load, read the entire file, and execute `{workflowFile}` to return to mode selection
85
- - IF any other input: Display "Please select **Y** or **X**." then redisplay the prompt
78
+ - IF Y: Continue to step 3.
79
+ - IF X: Display "Aborting backlog update." then load, read, and execute `{workflowFile}`.
80
+ - IF any other input: Display "Please select **Y** or **X**." then redisplay.
86
81
 
87
- ### 3. Apply Rescores
82
+ ### 3. Apply Rescores In-Place
88
83
 
89
- For each rescored item from step-r-02:
84
+ For each item in `rescored_items`:
90
85
 
91
- 1. **Find the item** — Locate the row in its category table under `## Backlog` by matching the item ID
92
- 2. **Update RICE scores** — Replace R, I, C, E, and composite Score values in the row
93
- 3. **Add rescore provenance** — Append to the Initiative description cell: `Rescored [old]->[new], Review, [date]` where [old] and [new] are the composite scores and [date] is the current session date (FR22)
94
- 4. **Preserve everything else** — Do not modify the item's title, source, track, status, or any other content
86
+ 1. **Find the item** — Locate the row in the correct lane table (§2.2 / 2.3 / 2.4) by matching the item ID.
87
+ 2. **Update RICE columns** — Replace R, I, C, E, and composite Score values in the row.
88
+ 3. **Preserve everything else** — Do not modify Description, Portfolio, Status, Stage, Artifacts, Linked Follow-up, or any non-RICE column.
89
+ 4. **Optional rescore provenance** — If the Description cell has capacity, append a subtle note: ` [rescored YYYY-MM-DD: X.X→Y.Y]`. Skip if the cell would exceed readable length.
95
90
 
96
91
  **Important:**
97
- - Only update items that were actually rescored (composite score changed)
98
- - Confirmed and skipped items remain completely unchanged — no provenance added
99
- - Do NOT reorder rows within category tables
92
+ - Only update items whose composite score actually changed.
93
+ - Confirmed and skipped items remain completely unchanged — no modification, no note.
94
+ - Do NOT modify rows not in `rescored_items`.
100
95
 
101
- ### 4. Regenerate Prioritized View
96
+ ### 4. Re-Sort Touched Lanes
102
97
 
103
- Rebuild the `## Prioritized View (by RICE Score)` table from scratch:
98
+ For each lane that had at least one rescored item:
104
99
 
105
- 1. Collect ALL active items from all category tables (existing + rescored)
106
- 2. Exclude items with Status "Done" or items in the `## Completed` section
107
- 3. Sort by composite RICE score descending
108
- 4. Tiebreak: (1) Higher Confidence first, (2) Newer insertion order first
109
- 5. Generate sequential rank numbers starting at 1
100
+ 1. Collect all rows in that lane's table.
101
+ 2. Sort by composite RICE score **descending**.
102
+ 3. Tiebreak: (1) Confidence higher first, (2) insertion order newer first.
103
+ 4. Rewrite the lane's table body with the sorted rows.
110
104
 
111
- Table format (6 columns):
112
- ```
113
- | Rank | # | Initiative | Score | Track | Category |
114
- |------|---|-----------|-------|-------|----------|
115
- ```
105
+ **Do NOT re-sort lanes that were not touched** — preserve their current order. This keeps `git diff` minimal for lanes the session didn't review.
116
106
 
117
- ### 5. Add Changelog Entry
107
+ ### 5. Add Change Log Entry
118
108
 
119
- Prepend a new row to the `## Change Log` table (newest first):
109
+ Prepend a new row to `## Change Log`:
120
110
 
121
111
  ```
122
- | YYYY-MM-DD | Review: Rescored [N] items, confirmed [N], skipped [N]. |
112
+ | YYYY-MM-DD | Review: Rescored [N] items — Bug: [n], Fast: [n], Initiative: [n]. Confirmed: [N], skipped: [N][, unvisited: N]. Lanes re-sorted: [list]. |
123
113
  ```
124
114
 
125
- ### 6. Update Last Updated Date
115
+ ### 6. Update Frontmatter
126
116
 
127
- Set the metadata header `Last Updated` field to the current date (YYYY-MM-DD format).
117
+ - Do NOT modify the `created` date.
118
+ - Frontmatter `status` stays as-is (typically `active`).
128
119
 
129
120
  ### 7. Completion Summary & Return to Menu
130
121
 
@@ -133,14 +124,19 @@ After successful write, display:
133
124
  > **Review Complete**
134
125
  >
135
126
  > **Items rescored:** [N]
136
- > **Items confirmed:** [N]
137
- > **Items skipped:** [N]
138
- > [If early exit: **Items unvisited:** [N]]
127
+ > - §2.2 Bug Lane: [n]
128
+ > - §2.3 Fast Lane: [n]
129
+ > - §2.4 Initiative Lane: [n]
130
+ > **Confirmed:** [N]
131
+ > **Skipped:** [N]
132
+ > [If early exit: **Unvisited:** [N]]
133
+ >
134
+ > **Lanes re-sorted:** [list, e.g., "Fast Lane, Initiative Lane"]
139
135
  >
140
- > **New Top 3 Positions:**
141
- > 1. [#ID] [title] — Score: [X.X]
142
- > 2. [#ID] [title] — Score: [X.X]
143
- > 3. [#ID] [title] — Score: [X.X]
136
+ > **Top 3 across touched lanes (post-sort):**
137
+ > 1. [#ID] [title] — Score: [X.X] — Lane: [lane]
138
+ > 2. [#ID] [title] — Score: [X.X] — Lane: [lane]
139
+ > 3. [#ID] [title] — Score: [X.X] — Lane: [lane]
144
140
 
145
141
  Then return to the T/R/C menu:
146
142
 
@@ -149,6 +145,6 @@ Then return to the T/R/C menu:
149
145
  Load, read the entire file, and execute `{workflowFile}`.
150
146
 
151
147
  ## 🚨 SYSTEM SUCCESS/FAILURE METRICS:
152
- ### ✅ SUCCESS: Pre-write validation performed, only rescored items updated in-place with correct provenance, confirmed/skipped items untouched, prioritized view regenerated with all items sorted correctly, changelog updated, completion summary displayed with top 3, T/R/C menu re-presented
153
- ### ❌ SYSTEM FAILURE: Existing backlog content deleted/overwritten/reordered, confirmed or skipped items modified, provenance added to non-rescored items, items written without validation, prioritized view not regenerated, no completion summary, no return to menu
148
+ ### ✅ SUCCESS: Validation performed, only rescored items updated in-place with RICE changes, confirmed/skipped items untouched, only touched lanes re-sorted (untouched lanes preserved), Part 1 / §2.1 / §2.5 untouched, Change Log updated with per-lane counts, completion summary displayed, menu re-presented
149
+ ### ❌ SYSTEM FAILURE: Rows added or removed, items' lane/stage/status modified, Part 1 or §2.1 or §2.5 altered, untouched lanes re-sorted unnecessarily, Change Log missing lane breakdown, provenance added to confirmed/skipped items
154
150
  **Master Rule:** Skipping steps is FORBIDDEN.
@@ -2,14 +2,14 @@
2
2
  name: 'step-t-01-ingest'
3
3
  description: 'Accept text input — review transcript, meeting notes, or any findings source'
4
4
  nextStepFile: '{project-root}/_bmad/bme/_enhance/workflows/initiatives-backlog/steps-t/step-t-02-extract.md'
5
- outputFile: '{planning_artifacts}/initiatives-backlog.md'
5
+ outputFile: '{planning_artifacts}/convoke-note-initiative-lifecycle-backlog.md'
6
6
  ---
7
7
 
8
8
  # Step 1: Ingest Review Findings
9
9
 
10
10
  ## STEP GOAL:
11
11
 
12
- Accept the Product Owner's text input (review transcript, meeting notes, audit output, or any findings source) and prepare it for extraction in the next step.
12
+ Accept the user's text input (review transcript, meeting notes, audit output, party mode output, or any findings source) and prepare it for extraction in the next step.
13
13
 
14
14
  ## MANDATORY EXECUTION RULES (READ FIRST):
15
15
 
@@ -26,19 +26,19 @@ Accept the Product Owner's text input (review transcript, meeting notes, audit o
26
26
 
27
27
  ### Step-Specific Rules:
28
28
  - 🎯 Focus ONLY on accepting and preserving input text
29
- - 🚫 FORBIDDEN to extract findings, classify, or score in this step — that is step-t-02's job
30
- - 🚫 FORBIDDEN to truncate, summarize, or skip any part of the input regardless of length (FR46)
29
+ - 🚫 FORBIDDEN to extract findings, classify, log, or qualify in this step — those are later steps' job
30
+ - 🚫 FORBIDDEN to truncate, summarize, or skip any part of the input regardless of length
31
31
  - 💬 Approach: brief prompts, minimal overhead, get to the content quickly
32
32
 
33
33
  ## EXECUTION PROTOCOLS:
34
34
  - 🎯 Follow the MANDATORY SEQUENCE exactly
35
- - 📖 Load existing backlog if present — it will be needed for overlap detection in step-t-02
35
+ - 📖 Load existing backlog if present — it will be needed for overlap detection and for appending in later steps
36
36
 
37
37
  ## CONTEXT BOUNDARIES:
38
38
  - Available context: Enhance config (loaded by workflow.md), existing backlog file (if present)
39
39
  - Focus: Accepting user input only
40
- - Limits: Do NOT analyze, classify, or score input
41
- - Dependencies: workflow.md T dispatch (completed in Story 1.3)
40
+ - Limits: Do NOT analyze, classify, or qualify input
41
+ - Dependencies: workflow.md T dispatch
42
42
 
43
43
  ## MANDATORY SEQUENCE
44
44
 
@@ -46,16 +46,16 @@ Accept the Product Owner's text input (review transcript, meeting notes, audit o
46
46
 
47
47
  ### 1. Check for Existing Backlog
48
48
 
49
- Check if an existing backlog file exists at `{planning_artifacts}/initiatives-backlog.md`.
49
+ Check if an existing backlog file exists at `{outputFile}`.
50
50
 
51
- - **If found:** Load it silently — it will be used for overlap detection in step-t-02. Briefly note to the user: "Existing backlog loaded — overlap detection will be available during extraction."
52
- - **If not found:** Note silently — step-t-02 will skip overlap detection. Briefly note: "No existing backlog found a new one will be created."
51
+ - **If found:** Load it silently — it will be used for overlap detection in step-t-02 and for writes in step-t-04. Briefly note to the user: "Existing lifecycle backlog loaded — overlap detection against current Intakes and lane items will be available during extraction."
52
+ - **If not found:** Note silently — step-t-02 will skip overlap detection. Briefly note: "No existing backlog found. Note: Triage cannot create a new backlog — use Create mode [C] for that. Triage will still extract findings but the final update step will require an existing file."
53
53
 
54
54
  ### 2. Prompt for Text Input
55
55
 
56
56
  Display:
57
57
 
58
- > **Triage Mode — Paste your review findings below.**
58
+ > **Triage Mode — Paste your findings below.**
59
59
  >
60
60
  > Accepted formats: review transcripts, meeting notes, audit outputs, party-mode outputs, code review findings, retrospective notes, or any text containing actionable observations.
61
61
  >
@@ -65,7 +65,7 @@ Display:
65
65
 
66
66
  - Accept the user's complete text input
67
67
  - Preserve it exactly as provided — do not modify, reformat, or summarize
68
- - Process the **entire** input regardless of length (FR46)
68
+ - Process the **entire** input regardless of length
69
69
  - Confirm receipt: "Received [N] lines of input. Ready to extract findings."
70
70
 
71
71
  ### 4. Present MENU OPTIONS