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.
- package/CHANGELOG.md +68 -0
- package/README.md +40 -11
- package/_bmad/bme/README.md +36 -0
- package/_bmad/bme/_enhance/workflows/initiatives-backlog/SKILL.md +1 -1
- package/_bmad/bme/_enhance/workflows/initiatives-backlog/steps-c/step-c-01-init.md +55 -32
- package/_bmad/bme/_enhance/workflows/initiatives-backlog/steps-c/step-c-02-gather.md +62 -59
- package/_bmad/bme/_enhance/workflows/initiatives-backlog/steps-c/step-c-03-qualify.md +176 -0
- package/_bmad/bme/_enhance/workflows/initiatives-backlog/steps-c/step-c-04-generate.md +259 -0
- package/_bmad/bme/_enhance/workflows/initiatives-backlog/steps-r/step-r-01-load.md +65 -35
- package/_bmad/bme/_enhance/workflows/initiatives-backlog/steps-r/step-r-02-rescore.md +60 -30
- package/_bmad/bme/_enhance/workflows/initiatives-backlog/steps-r/step-r-03-update.md +67 -71
- package/_bmad/bme/_enhance/workflows/initiatives-backlog/steps-t/step-t-01-ingest.md +12 -12
- package/_bmad/bme/_enhance/workflows/initiatives-backlog/steps-t/step-t-02-extract.md +49 -44
- package/_bmad/bme/_enhance/workflows/initiatives-backlog/steps-t/step-t-03-qualify.md +192 -0
- package/_bmad/bme/_enhance/workflows/initiatives-backlog/steps-t/step-t-04-update.md +72 -67
- package/_bmad/bme/_enhance/workflows/initiatives-backlog/templates/backlog-format-spec.md +223 -112
- package/_bmad/bme/_enhance/workflows/initiatives-backlog/templates/lifecycle-process-spec.md +188 -0
- package/_bmad/bme/_enhance/workflows/initiatives-backlog/workflow.md +44 -31
- package/_bmad/bme/_gyre/config.yaml +3 -0
- package/_bmad/bme/_vortex/config.yaml +4 -1
- package/package.json +2 -1
- package/scripts/convoke-doctor.js +56 -2
- package/scripts/lib/artifact-utils.js +16 -3
- package/scripts/migrate-artifacts.js +3 -2
- package/scripts/portability/catalog-generator.js +1 -1
- package/scripts/portability/convoke-export.js +26 -5
- package/scripts/portability/export-engine.js +34 -9
- package/scripts/portability/seed-catalog-repo.js +6 -6
- package/scripts/portability/validate-exports.js +25 -14
- package/scripts/update/convoke-update.js +27 -2
- package/scripts/update/lib/changelog-reader.js +90 -0
- package/scripts/update/lib/config-merger.js +52 -1
- package/scripts/update/lib/refresh-installation.js +48 -9
- package/scripts/update/lib/taxonomy-merger.js +2 -1
- package/scripts/update/lib/validator.js +9 -1
- package/_bmad/bme/_enhance/workflows/initiatives-backlog/steps-c/step-c-03-score.md +0 -146
- package/_bmad/bme/_enhance/workflows/initiatives-backlog/steps-c/step-c-04-prioritize.md +0 -181
- 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
|
|
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}/
|
|
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:
|
|
11
|
+
# Step 2: Lane Walkthrough & Rescoring
|
|
12
12
|
|
|
13
13
|
## STEP GOAL:
|
|
14
14
|
|
|
15
|
-
Walk through
|
|
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
|
|
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
|
-
- ✅
|
|
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
|
|
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:
|
|
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
|
|
48
|
-
- Dependencies: step-r-01-load.md (loaded
|
|
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
|
|
56
|
+
Set up tracking:
|
|
57
57
|
- `current_index` = 1
|
|
58
|
-
- `total_items` = count from
|
|
59
|
-
- `rescored_items` = []
|
|
60
|
-
- `confirmed_items` = []
|
|
61
|
-
- `skipped_items` = []
|
|
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
|
|
65
|
+
Display the current item with lane-specific context:
|
|
66
66
|
|
|
67
|
-
|
|
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]: [
|
|
81
|
+
> **[ID]: [Description]** — Score: [composite]
|
|
70
82
|
> R:[reach] I:[impact] C:[confidence]% E:[effort]
|
|
71
|
-
> *
|
|
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
|
|
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
|
|
104
|
-
- IF P: Execute `{partyModeWorkflow}` for multi-perspective
|
|
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
|
|
107
|
-
- **If NO scores were changed:** Treat as confirmed (same as K).
|
|
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
|
-
-
|
|
136
|
-
-
|
|
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
|
|
140
|
-
### ❌ SYSTEM FAILURE: Items auto-advanced without
|
|
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
|
|
4
|
-
outputFile: '{planning_artifacts}/
|
|
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
|
|
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,
|
|
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
|
|
26
|
-
- ✅
|
|
27
|
-
- ✅
|
|
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
|
|
32
|
-
- 🚫 FORBIDDEN to
|
|
33
|
-
- 🚫 FORBIDDEN to
|
|
34
|
-
- 🚫 FORBIDDEN to modify
|
|
35
|
-
- 💬 Approach: validate first, update
|
|
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:
|
|
44
|
-
- Focus: Structural validation,
|
|
45
|
-
- Limits: Do NOT rescore, re-extract, or
|
|
46
|
-
- Dependencies: step-r-02-rescore.md (rescored
|
|
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}`
|
|
55
|
+
Load `{outputFile}` and validate per format spec:
|
|
55
56
|
|
|
56
|
-
1. **
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
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
|
|
63
|
+
If ALL checks pass, proceed to step 3.
|
|
69
64
|
|
|
70
65
|
### 2. Mismatch Handling
|
|
71
66
|
|
|
72
|
-
If ANY validation check fails
|
|
67
|
+
If ANY validation check fails:
|
|
73
68
|
|
|
74
69
|
> **Pre-Write Validation — Structural Mismatch Detected**
|
|
75
70
|
>
|
|
76
|
-
> [List each failed check
|
|
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
|
|
76
|
+
**ALWAYS halt and wait.**
|
|
82
77
|
|
|
83
|
-
- IF Y: Continue to step 3
|
|
84
|
-
- IF X: Display "Aborting backlog update." then load, read
|
|
85
|
-
- IF any other input: Display "Please select **Y** or **X**." then redisplay
|
|
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
|
|
84
|
+
For each item in `rescored_items`:
|
|
90
85
|
|
|
91
|
-
1. **Find the item** — Locate the row in
|
|
92
|
-
2. **Update RICE
|
|
93
|
-
3. **
|
|
94
|
-
4. **
|
|
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
|
|
98
|
-
- Confirmed and skipped items remain completely unchanged — no
|
|
99
|
-
- Do NOT
|
|
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.
|
|
96
|
+
### 4. Re-Sort Touched Lanes
|
|
102
97
|
|
|
103
|
-
|
|
98
|
+
For each lane that had at least one rescored item:
|
|
104
99
|
|
|
105
|
-
1. Collect
|
|
106
|
-
2.
|
|
107
|
-
3.
|
|
108
|
-
4.
|
|
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
|
-
|
|
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
|
|
107
|
+
### 5. Add Change Log Entry
|
|
118
108
|
|
|
119
|
-
Prepend a new row to
|
|
109
|
+
Prepend a new row to `## Change Log`:
|
|
120
110
|
|
|
121
111
|
```
|
|
122
|
-
| YYYY-MM-DD | Review: Rescored [N] items,
|
|
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
|
|
115
|
+
### 6. Update Frontmatter
|
|
126
116
|
|
|
127
|
-
|
|
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
|
-
>
|
|
137
|
-
>
|
|
138
|
-
>
|
|
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
|
-
> **
|
|
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:
|
|
153
|
-
### ❌ SYSTEM FAILURE:
|
|
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}/
|
|
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
|
|
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
|
|
30
|
-
- 🚫 FORBIDDEN to truncate, summarize, or skip any part of the input regardless of length
|
|
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
|
|
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
|
|
41
|
-
- Dependencies: workflow.md T dispatch
|
|
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 `{
|
|
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
|
|
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
|
|
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
|
|
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
|