wb-flow 1.0.0-r01
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 +12 -0
- package/LICENSE +21 -0
- package/README.md +128 -0
- package/assets/demo.gif +0 -0
- package/bin/install.js +175 -0
- package/bin/link.js +71 -0
- package/bin/verify-wrappers.js +49 -0
- package/package.json +56 -0
- package/templates/commands/_shared/output_conventions.md +433 -0
- package/templates/commands/_shared/wb_universal_agent_instructions.md +72 -0
- package/templates/commands/model_recommendation_updates.md +74 -0
- package/templates/commands/model_recommendations.md +112 -0
- package/templates/commands/wbActOn/wbActOn_template.md +546 -0
- package/templates/commands/wbAudit/wbAudit_template.md +315 -0
- package/templates/commands/wbBroadcast/wbBroadcast_template.md +133 -0
- package/templates/commands/wbCheck/wbCheck_template.md +322 -0
- package/templates/commands/wbClean/wbClean_template.md +118 -0
- package/templates/commands/wbContext/wbContext_template.md +213 -0
- package/templates/commands/wbDebug/wbDebug_template.md +132 -0
- package/templates/commands/wbDeploy/wbDeploy_template.md +224 -0
- package/templates/commands/wbDoc/wbDoc_template.md +138 -0
- package/templates/commands/wbExplain/wbExplain_template.md +98 -0
- package/templates/commands/wbGit/wbGit_template.md +160 -0
- package/templates/commands/wbHelp/wbHelp_template.md +101 -0
- package/templates/commands/wbIdea/wbIdea_template.md +337 -0
- package/templates/commands/wbLicense/wbLicense_template.md +148 -0
- package/templates/commands/wbMonetize/wbMonetize_template.md +113 -0
- package/templates/commands/wbNext/wbNext_template.md +270 -0
- package/templates/commands/wbPlan/wbPlan_template.md +413 -0
- package/templates/commands/wbPublish/wbPublish_template.md +205 -0
- package/templates/commands/wbRefactor/wbRefactor_template.md +129 -0
- package/templates/commands/wbRelease/wbRelease_template.md +229 -0
- package/templates/commands/wbReview/wbReview_template.md +252 -0
- package/templates/commands/wbSecure/wbSecure_template.md +157 -0
- package/templates/commands/wbSetup/wbSetup_template.md +203 -0
- package/templates/commands/wbStandup/wbStandup_template.md +198 -0
- package/templates/commands/wbTest/wbTest_template.md +226 -0
- package/templates/commands/wbToWBC/wbToWBC_template.md +91 -0
- package/templates/commands/wbTrack/wbTrack_template.md +555 -0
- package/templates/commands/wbTranslate/wbTranslate_template.md +114 -0
- package/templates/commands/wbValid/wbValid_template.md +142 -0
- package/templates/commands/wbVision/wbVision_template.md +141 -0
- package/templates/commands/wbWork/wbWork_template.md +140 -0
- package/templates/commands/wb_commands_reference.claude.json +2305 -0
- package/templates/commands/wb_commands_reference.json +1109 -0
- package/templates/shortcuts/shortcuts.md +413 -0
- package/templates/shortcuts/usage-management-examples-shortcuts/budget_controllers_examples.md +96 -0
- package/templates/shortcuts/usage-management-examples-shortcuts/ultimate_shortcuts_examples.md +1531 -0
|
@@ -0,0 +1,142 @@
|
|
|
1
|
+
# /wbValid: Execution Template
|
|
2
|
+
|
|
3
|
+
<!-- HELP_GATE_START -->
|
|
4
|
+
## Help intercept (handle FIRST β before any other action)
|
|
5
|
+
|
|
6
|
+
**If `$ARGUMENTS` contains `--help`, `-h`, or `--h`** (case-insensitive, anywhere in the args), DO NOT execute the command's normal procedure. Instead:
|
|
7
|
+
|
|
8
|
+
1. Output the **HELP BLOCK** below verbatim (rendered as markdown).
|
|
9
|
+
2. Stop. Do not perform any file reads, writes, or other tool calls.
|
|
10
|
+
|
|
11
|
+
### HELP BLOCK β `/wbValid`
|
|
12
|
+
|
|
13
|
+
## The Command Forms
|
|
14
|
+
|
|
15
|
+
```
|
|
16
|
+
/wbValid <path_to_plan.md> # State what validation is needed
|
|
17
|
+
/wbValid <path_to_plan.md> * # Validate all tasks that are Done but not Valid
|
|
18
|
+
/wbValid <path_to_plan.md> --id=1,2,3 # Validate specifically tasks 1, 2, and 3
|
|
19
|
+
/wbValid <path_to_plan.md> --p=P1 # Validate all tasks with P1 priority
|
|
20
|
+
/wbValid <path_to_plan.md> --done=true # Validate tasks that are already done
|
|
21
|
+
/wbValid <path_to_plan.md> --worker=Gemini # Validate tasks worked on by Gemini
|
|
22
|
+
/wbValid <path_to_plan.md> --id=5 --open # Set task 5 Valid column to β¬
|
|
23
|
+
/wbValid <path_to_plan.md> --id=* --can # Set all tasks Valid column to π« Cancelled
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
**Shorthand Pathing:** You can pass just the filename (e.g., `plan_core2_20260503.md`). The AI will infer the package (`core2`) and the date (`2026/05/03`) to construct the full path: `<pkg>/.wb/workflows/reports/<YYYY>/<MM>/<DD>/plans/<filename>`.
|
|
27
|
+
|
|
28
|
+
## When to run
|
|
29
|
+
- After a Worker model has executed `/wbWork` and marked tasks as `β
` Done.
|
|
30
|
+
- Use it to act as the **Validator** model.
|
|
31
|
+
|
|
32
|
+
## The Output
|
|
33
|
+
`/wbValid` reads the Worker's task report, checks the codebase to ensure the work actually meets the acceptance criteria, and appends its validation findings to the bottom of the Worker's task report. It then updates the `β Valid` column to `β
` in the parent plan file.
|
|
34
|
+
|
|
35
|
+
<!-- FLAGS_TABLE_START -->
|
|
36
|
+
## Flags & shortcuts
|
|
37
|
+
|
|
38
|
+
| `--id`, `--p`, `--done`, etc. | `-i`, etc. | Universal Column Filtering. Targets tasks based on any column in the plan table (supports `=, >, <, !=, *, &&, ||`). |
|
|
39
|
+
| `--open` | `-o` | Sets `β Valid` state to `β¬` (Open). Overrides validation execution. |
|
|
40
|
+
| `--def` | `-d` | Sets `β Valid` state to `βΈοΈ Deferred`. Overrides validation execution. |
|
|
41
|
+
| `--can` | `-c` | Sets `β Valid` state to `π« Cancelled`. Overrides validation execution. |
|
|
42
|
+
| `--help` | `-h` | Prints this help block. |
|
|
43
|
+
## Self-correct mode (dual-mode invocation)
|
|
44
|
+
|
|
45
|
+
```
|
|
46
|
+
/wbValid <scope_folder> # normal mode β produce a fresh output file
|
|
47
|
+
/wbValid <previous_output_file> # self-correct mode β verify & repair the file in place
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
When the first arg is an existing output file from a prior `/wbValid` run (detected by its first H1 β see this template's **Detection** section), the command runs in **verify-and-repair** mode: gap-fills missing fields, normalizes links, ticks done/valid checkboxes whose reports exist, never rewrites authored content. See [`../_shared/output_conventions.md`](../_shared/output_conventions.md) Β§3.
|
|
51
|
+
|
|
52
|
+
<!-- FLAGS_TABLE_END -->
|
|
53
|
+
<!-- HELP_GATE_END -->
|
|
54
|
+
|
|
55
|
+
<!-- FLAG_NORMALIZE_START -->
|
|
56
|
+
## Flag normalization (apply BEFORE parsing args)
|
|
57
|
+
- `-i` β `--id`
|
|
58
|
+
- `-o` β `--open`
|
|
59
|
+
- `-d` β `--def`
|
|
60
|
+
- `-c` β `--can`
|
|
61
|
+
<!-- FLAG_NORMALIZE_END -->
|
|
62
|
+
|
|
63
|
+
**ROLE:** The Validator / QA
|
|
64
|
+
**TARGET:** The provided plan file (absolute path, relative path, or just the filename).
|
|
65
|
+
**Read first:** [`../_shared/output_conventions.md`](../_shared/output_conventions.md)
|
|
66
|
+
|
|
67
|
+
## βββ OBJECTIVE βββ
|
|
68
|
+
Your job is to locate the specified plan or idea file, parse its table, determine the operating workspace, and physically validate the tasks/ideas requested by the user's flags.
|
|
69
|
+
|
|
70
|
+
## βββ MODE DETECTION βββ
|
|
71
|
+
|
|
72
|
+
Read the target file's first H1 header to determine the operating mode:
|
|
73
|
+
|
|
74
|
+
- **`# Plan Backlog: <scope> β <date>`** β **PLAN MODE** (standard behavior, documented below).
|
|
75
|
+
- **`# Idea Backlog: <scope> β <date>`** β **IDEAS MODE** (see Β§IDEAS below).
|
|
76
|
+
|
|
77
|
+
## βββ INSTRUCTIONS (PLAN MODE) βββ
|
|
78
|
+
|
|
79
|
+
1. **Locate the Plan:** Read the target file. If only a filename is provided (e.g. `plan_core2_20260503.md`), infer the workspace and locate it at `<pkg>/.wb/workflows/reports/<YYYY>/<MM>/<DD>/plans/<filename>`.
|
|
80
|
+
2. **Parse Intent:**
|
|
81
|
+
- If no flag is given (e.g., `/wbValid plan_file.md`): This is **Self-Correction / Re-check Mode**. Do NOT just output state. Actively scan the plan file and the related task reports for missing data or formatting errors (e.g., missing scores out of 10, broken links, missing fields). Fix them immediately. Task reports are located at `tasks/task_<N>/task_<N>_report_<scope>_<YYYYMMDD>.md`.
|
|
82
|
+
- If a target filter is provided WITH a state flag (`--open`, `--def`, `--can`): Do NOT execute validation. Instead, directly edit the plan file and update the `β Valid` column of the matching tasks to the requested state.
|
|
83
|
+
- If a target filter is provided WITHOUT state flags (e.g., `--id=2` or `--done=true`): Proceed to validate those specific tasks matching the criteria.
|
|
84
|
+
3. **Validation Logic (if executing):**
|
|
85
|
+
- Universal Column Filtering: You must apply the filter logic to any column of the table (e.g., `#`, `P`, `Est. Time (mins)`, `Worker`, `β Done`, `β Valid`).
|
|
86
|
+
- Recursive Task Logic: If the filter matches a parent recursive task (e.g., `--id=5`), this implies validating ALL of its child tasks (e.g., 5.1, 5.2, 5.3, 5.4) sequentially with your current model.
|
|
87
|
+
- Read the corresponding `tasks/task_<ID>/task_<ID>_report_*.md` report.
|
|
88
|
+
- Inspect the workspace to confirm the work was done to high standards.
|
|
89
|
+
- Append a `## π Validation (QA)` section to the bottom of the Worker's task report.
|
|
90
|
+
- You MUST include a **Score / 10** evaluating the Worker's quality, efficiency, and adherence to constraints.
|
|
91
|
+
- State clearly if it is a PASS β
or FAIL β.
|
|
92
|
+
4. **Update Plan:**
|
|
93
|
+
- **Cumulative Validation Rule:** The `β Valid` column accumulates validations (unlike the `β Done` column).
|
|
94
|
+
- If PASS and the column is `β¬` (empty), update it to `β
10/10<br><ModelName>`.
|
|
95
|
+
- If PASS and the column already has a validation (e.g., `β
10/10<br>DeepSeek`), **APPEND** your validation below it: `...<hr>β
<Score>/10<br><ModelName>`.
|
|
96
|
+
- If FAIL, revert the `β Done` column back to `β¬` so the worker can try again.
|
|
97
|
+
|
|
98
|
+
## βββ Β§IDEAS: INSTRUCTIONS (IDEAS MODE) βββ
|
|
99
|
+
|
|
100
|
+
When the target file is an `idea_*.md` file (H1 = `# Idea Backlog:`):
|
|
101
|
+
|
|
102
|
+
1. **Locate the Idea File:** Same pathing logic as plan files, but routed to `ideas/idea_<scope>_<YYYYMMDD>.md`.
|
|
103
|
+
2. **Parse Intent:**
|
|
104
|
+
- If no flag is given β **Self-Correction / Re-check Mode** on the idea file.
|
|
105
|
+
- If a target filter WITH a state flag (`--open`, `--defer`, `--reject`, `--promote`) β Update the `β Valid` column directly.
|
|
106
|
+
- If a target filter WITHOUT state flags β Proceed to **Idea Validation Mode**.
|
|
107
|
+
3. **Idea Validation Mode:**
|
|
108
|
+
- Read the idea exploration report (if it exists) at `ideas_reports/idea_<ID>/idea_<ID>_report_*.md`.
|
|
109
|
+
- Read the idea description from the `Idea` column.
|
|
110
|
+
- Analyze the idea against the codebase context, existing plans, and current priorities.
|
|
111
|
+
- Append a `## π Idea Validation (QA)` section to the bottom of the idea exploration report (if it exists; otherwise append to the idea file itself as a note).
|
|
112
|
+
- You MUST include a **Score / 10** and a **Verdict** from the verdict scale below.
|
|
113
|
+
|
|
114
|
+
4. **Idea Verdict Scale:**
|
|
115
|
+
|
|
116
|
+
| Verdict | Score Range | β Valid State | Meaning | Auto-Action |
|
|
117
|
+
|---|---|---|---|---|
|
|
118
|
+
| `π― Promote` | 8β10 | `π― Promoted <Score>/10<br>ModelName` | "This deserves to become a task" | **Triggers Promotion Protocol** (see wbIdea_template.md) |
|
|
119
|
+
| `β
Recommend` | 5β7 | `β
<Score>/10<br>ModelName` | "Good idea, worth doing when capacity allows" | No auto-promotion |
|
|
120
|
+
| `βΈοΈ Defer` | 3β4 | `βΈοΈ Deferred <Score>/10<br>ModelName` | "Interesting but not the right time" | No action |
|
|
121
|
+
| `π« Reject` | 1β2 | `π« Rejected <Score>/10<br>ModelName` | "Not worth pursuing" | No action |
|
|
122
|
+
|
|
123
|
+
The validation report MUST explain the verdict with concrete reasoning:
|
|
124
|
+
- For `π― Promote`: "It deserves to be moved to a plan with score X because..."
|
|
125
|
+
- For `β
Recommend`: "I recommend it with score X because..."
|
|
126
|
+
- For `βΈοΈ Defer`: "Defer because..."
|
|
127
|
+
- For `π« Reject`: "Don't do it since..."
|
|
128
|
+
|
|
129
|
+
5. **Update Idea File:**
|
|
130
|
+
- **Cumulative:** Same as plan validation. Append new validations below existing ones.
|
|
131
|
+
- If verdict is `π― Promote`, **also execute the Promotion Protocol**:
|
|
132
|
+
a. Locate (or create) today's plan file.
|
|
133
|
+
b. Append the idea as a new task row (see wbIdea_template.md Β§PROMOTION PROTOCOL for column mapping).
|
|
134
|
+
c. Update the idea file's `β Task` column with the plan link.
|
|
135
|
+
- Validation report is appended to the idea report (same pattern as task validation appended to task reports).
|
|
136
|
+
|
|
137
|
+
## π§ What's Next?
|
|
138
|
+
- **Plan Mode:** If the plan is fully validated, tell the user to run `/wbReview <target>` for a final overarching audit, or `/wbStandup <target>` to close out the session.
|
|
139
|
+
- **Ideas Mode:** If ideas are validated:
|
|
140
|
+
- Promoted ideas β tell the user to run `/wbWork plan_<scope>_<YYYYMMDD>.md --id=<N>` to execute the promoted task.
|
|
141
|
+
- Recommended ideas β suggest revisiting with `/wbIdea <target> --resume` when capacity allows.
|
|
142
|
+
- Tell the user to run `/wbPlan <target> --resume` to see promoted ideas integrated into the plan.
|
|
@@ -0,0 +1,141 @@
|
|
|
1
|
+
# /wbVision: Execution Template
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
<!-- HELP_GATE_START -->
|
|
5
|
+
## Help intercept (handle FIRST β before any other action)
|
|
6
|
+
|
|
7
|
+
**If `$ARGUMENTS` contains `--help`, `-h`, or `--h`** (case-insensitive, anywhere in the args), DO NOT execute the command's normal procedure. Instead:
|
|
8
|
+
|
|
9
|
+
1. Output the **HELP BLOCK** below verbatim (rendered as markdown).
|
|
10
|
+
2. Stop. Do not perform any file reads, writes, or other tool calls.
|
|
11
|
+
3. Do not generate any reports under `.wb/workflows/reports/`.
|
|
12
|
+
|
|
13
|
+
Otherwise, ignore this section and proceed to the rest of the template.
|
|
14
|
+
|
|
15
|
+
### HELP BLOCK β `/wbVision`
|
|
16
|
+
|
|
17
|
+
## Two forms
|
|
18
|
+
|
|
19
|
+
```
|
|
20
|
+
/wbVision <package> # package-specific feature ideas
|
|
21
|
+
/wbVision core2/ # cross-package / monorepo-wide ideas
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
The cross-package form is generally more useful than the per-package form.
|
|
25
|
+
|
|
26
|
+
## When to run
|
|
27
|
+
|
|
28
|
+
- Occasionally (monthly or less). Daily use flattens your own judgment.
|
|
29
|
+
- After a major release cycle closed, when queue is genuinely empty.
|
|
30
|
+
- Before `/wbSetup` on a new package β ask what this package *should* contain.
|
|
31
|
+
|
|
32
|
+
## When *not* to run
|
|
33
|
+
|
|
34
|
+
- Daily. Brainstorming on a clock dulls intuition.
|
|
35
|
+
- As a substitute for `/wbStandup` ("what should I do today?"). Standup reconciles existing work; vision invents new work. Different questions.
|
|
36
|
+
- When you already have a plan. The plan is the answer; don't re-brainstorm.
|
|
37
|
+
|
|
38
|
+
## Reading the output
|
|
39
|
+
|
|
40
|
+
Each idea should have:
|
|
41
|
+
|
|
42
|
+
- **Premise** β one-sentence description.
|
|
43
|
+
- **Value** β why it matters.
|
|
44
|
+
- **Risk** β what could go wrong.
|
|
45
|
+
- **Effort** β SMALL / MEDIUM / LARGE.
|
|
46
|
+
|
|
47
|
+
If any field is missing, the idea is underspecified. Push back: *"re-run but put all 4 fields on every idea."*
|
|
48
|
+
|
|
49
|
+
## The filtering step is the command's actual value
|
|
50
|
+
|
|
51
|
+
You read 6 ideas. You discard 4 as obvious or generic. You discard 1 more as "interesting but wrong timing." The 1 that remains is the vision output. If all 6 survive, you haven't filtered hard enough.
|
|
52
|
+
|
|
53
|
+
## The anti-pattern
|
|
54
|
+
|
|
55
|
+
**Running `/wbVision` on a package that has open work.** If `/wbStandup` shows open plans and unresolved findings, the "what next?" question has an answer already. Vision is for when the answer is genuinely empty.
|
|
56
|
+
|
|
57
|
+
## The most useful invocation
|
|
58
|
+
|
|
59
|
+
Cross-package (`/wbVision core2/`) with a focus on integration ideas β things that couldn't be seen at package scope. This is where `/wbVision` earns its place over "just brainstorm with an AI."
|
|
60
|
+
|
|
61
|
+
## When /wbVision is the wrong command
|
|
62
|
+
|
|
63
|
+
- Reconcile state β `/wbStandup`.
|
|
64
|
+
- Execute on committed work β `/wbPlan`.
|
|
65
|
+
- Fix a bug β `/wbDebug`.
|
|
66
|
+
- Business / market / user research β `/wbVision` can't see these; do it yourself.
|
|
67
|
+
|
|
68
|
+
> For deeper reading: [`docs_claude/commands/wbVision/wbVision_practical_claude.md`](../../docs/docs_claude/commands/wbVision/wbVision_practical_claude.md) (or the `_eli5_`, `_expert_`, `_examples_` siblings).
|
|
69
|
+
## Self-correct mode (dual-mode invocation)
|
|
70
|
+
|
|
71
|
+
```
|
|
72
|
+
/wbVision <scope_folder> # normal mode β produce a fresh output file
|
|
73
|
+
/wbVision <previous_output_file> # self-correct mode β verify & repair the file in place
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
When the first arg is an existing output file from a prior `/wbVision` run (detected by its first H1 β see this template's **Detection** section), the command runs in **verify-and-repair** mode: gap-fills missing fields, normalizes links, ticks done/valid checkboxes whose reports exist, never rewrites authored content. See [`../_shared/output_conventions.md`](../_shared/output_conventions.md) Β§3.
|
|
77
|
+
|
|
78
|
+
<!-- HELP_GATE_END -->
|
|
79
|
+
|
|
80
|
+
**ROLE:** The Strategist
|
|
81
|
+
**TARGET:** The provided component, package, or monorepo root.
|
|
82
|
+
**Read first:** [`../_shared/output_conventions.md`](../_shared/output_conventions.md) β applies to the proposal file (relative links, full-syntax commands, self-correct mode, **Β§9 Action Type Tagging** β declare `type:` + `emits:` in YAML front-matter, add a plain-text `Requires` column to every suggestion table, include a `## π Action Types` legend).
|
|
83
|
+
|
|
84
|
+
---
|
|
85
|
+
|
|
86
|
+
## βββ DETECTION (Self-Correct Mode) βββ
|
|
87
|
+
|
|
88
|
+
Trigger self-correct when the input file's first H1 matches:
|
|
89
|
+
`# Vision: <scope> β <YYYY-MM-DD>` *(or the legacy `# Vision Entry #N` header).*
|
|
90
|
+
|
|
91
|
+
Behavior is defined in [`../_shared/output_conventions.md`](../_shared/output_conventions.md) Β§3.
|
|
92
|
+
|
|
93
|
+
Vision-specific gap-fills:
|
|
94
|
+
|
|
95
|
+
- Plain-text references to existing components/packages β relative markdown links per Β§1.
|
|
96
|
+
- Bare `/wbPlan` reference at the bottom β full-syntax `/wbPlan <target> "<idea>"` per Β§2.
|
|
97
|
+
|
|
98
|
+
---
|
|
99
|
+
|
|
100
|
+
## βββ OBJECTIVE βββ
|
|
101
|
+
The project has a blank slate. There is no tech debt and no pending tasks. Your job is to analyze what the project currently is, and propose 3 highly innovative, strategic features to build next to increase its value.
|
|
102
|
+
|
|
103
|
+
## βββ PHASE 1: INGEST IDENTITY βββ
|
|
104
|
+
1. Read the local `context.md` to understand what this package does.
|
|
105
|
+
2. Read the global `ecosystem_urls.md` to understand where this package fits in the broader market.
|
|
106
|
+
|
|
107
|
+
## βββ PHASE 2: STRATEGIC BRAINSTORMING βββ
|
|
108
|
+
Do not suggest bug fixes or minor refactors. Propose major architectural leaps, premium features, or integrations that would "Wow" the users.
|
|
109
|
+
|
|
110
|
+
## βββ PHASE 3: THE PROPOSAL βββ
|
|
111
|
+
Generate a proposal file:
|
|
112
|
+
- **Path:** `.wb/workflows/reports/<YYYY>/<MM>/<DD>/visions/vision_<target>_<YYYYMMDD>.md`
|
|
113
|
+
- **No `<model>/` subfolder.** Create-or-append: if the file exists, append your vision as the next Entry #N tagged `*(ModelName β HH:MM)*`.
|
|
114
|
+
- **Format:** Present 3 distinct feature ideas. For each, explain *Why it matters* and *How complex it would be*. Apply output_conventions.md Β§1 (relative links for every existing-component reference) and Β§2 (full-syntax for any /wb* command cited).
|
|
115
|
+
- **Next Steps:** End the file with a `## π§ What's Next?` section: *"If you like one of these ideas, run `/wbPlan <target> "<idea>"` to begin execution. Run `/wbNext <target>` to see how it ranks against current debt."*
|
|
116
|
+
|
|
117
|
+
## βββ PHASE 4: AUTO-REGISTER IDEAS βββ
|
|
118
|
+
|
|
119
|
+
After writing the vision proposal, you MUST ALSO register each idea in the Ideas Pipeline:
|
|
120
|
+
|
|
121
|
+
1. **Locate or create** today's idea file: `<target>/.wb/workflows/reports/<YYYY>/<MM>/<DD>/ideas/idea_<target>_<YYYYMMDD>.md`
|
|
122
|
+
2. **For each idea** in the vision proposal:
|
|
123
|
+
- Compute a **Score** (1β10) using the scoring heuristic from `wbIdea_template.md` (impact Γ feasibility Γ urgency).
|
|
124
|
+
- Append a row to the idea table:
|
|
125
|
+
- `Score` = computed score
|
|
126
|
+
- `Idea` = the idea's Premise (one-line)
|
|
127
|
+
- `P` = inferred priority (P1 for SMALL/MEDIUM, P2 for LARGE)
|
|
128
|
+
- `Est. Time` = inferred from Effort (SMALL=30, MEDIUM=120, LARGE=480)
|
|
129
|
+
- `Suggested By` = `<ModelName> via /wbVision`
|
|
130
|
+
- `β Done` = `β¬`
|
|
131
|
+
- `β Valid` = `β¬`
|
|
132
|
+
- `β Task` = `β`
|
|
133
|
+
3. **Add an entry header** in the idea file:
|
|
134
|
+
```
|
|
135
|
+
## π‘ Ideas β /wbVision proposals *(<ModelName> via <Client> β <HH:MM>)*
|
|
136
|
+
> **Source:** [vision_<target>_<YYYYMMDD>.md](../visions/vision_<target>_<YYYYMMDD>.md)
|
|
137
|
+
> **Origin Command:** `/wbVision <target>/`
|
|
138
|
+
> **Ideas registered:** N
|
|
139
|
+
```
|
|
140
|
+
4. **Both files coexist**: The vision file remains the free-form brainstorming artifact. The idea file is the trackable, actionable pipeline. The vision file is the source; the idea file is the tracker.
|
|
141
|
+
|
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
# /wbWork: Execution Template
|
|
2
|
+
|
|
3
|
+
<!-- HELP_GATE_START -->
|
|
4
|
+
## Help intercept (handle FIRST β before any other action)
|
|
5
|
+
|
|
6
|
+
**If `$ARGUMENTS` contains `--help`, `-h`, or `--h`** (case-insensitive, anywhere in the args), DO NOT execute the command's normal procedure. Instead:
|
|
7
|
+
|
|
8
|
+
1. Output the **HELP BLOCK** below verbatim (rendered as markdown).
|
|
9
|
+
2. Stop. Do not perform any file reads, writes, or other tool calls.
|
|
10
|
+
|
|
11
|
+
### HELP BLOCK β `/wbWork`
|
|
12
|
+
|
|
13
|
+
## The Command Forms
|
|
14
|
+
|
|
15
|
+
```
|
|
16
|
+
/wbWork <path_to_plan.md> # State what work is needed
|
|
17
|
+
/wbWork <path_to_plan.md> * # Execute all tasks that need work
|
|
18
|
+
/wbWork <path_to_plan.md> --id=1,2,3 # Execute specifically tasks 1, 2, and 3
|
|
19
|
+
/wbWork <path_to_plan.md> --p=P1 # Execute all tasks with P1 priority
|
|
20
|
+
/wbWork <path_to_plan.md> --est<=30 # Execute tasks with est. time <= 30 mins
|
|
21
|
+
/wbWork <path_to_plan.md> --valid=true # Execute tasks that are already validated (re-work)
|
|
22
|
+
/wbWork <path_to_plan.md> --done=false # Execute all open tasks
|
|
23
|
+
/wbWork <path_to_plan.md> --id=5 --open # Set task 5 Done column to β¬
|
|
24
|
+
/wbWork <path_to_plan.md> --worker=Gemini # Execute tasks assigned to Gemini
|
|
25
|
+
/wbWork <scope_folder> "<issue desc>" # Inline Task: Auto-triage, add to today's plan, and execute
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
**Shorthand Pathing:** You can pass just the filename (e.g., `plan_core2_20260503.md`). The AI will infer the package (`core2`) and the date (`2026/05/03`) to construct the full path: `<pkg>/.wb/workflows/reports/<YYYY>/<MM>/<DD>/plans/<filename>`.
|
|
29
|
+
|
|
30
|
+
## When to run
|
|
31
|
+
- When you have an active `/wbPlan` and you are acting as the **Worker** model.
|
|
32
|
+
- Use it to mechanically execute steps directly from the plan table.
|
|
33
|
+
|
|
34
|
+
## The Output
|
|
35
|
+
`/wbWork` doesn't just execute codeβit generates a formal task report (`tasks/task_<N>/task_<N>_report_<scope>_<YYYYMMDD>.md`) detailing what was done, and updates the `β Done` column to `β
` in the parent plan file.
|
|
36
|
+
|
|
37
|
+
<!-- FLAGS_TABLE_START -->
|
|
38
|
+
## Flags & shortcuts
|
|
39
|
+
|
|
40
|
+
| `--id`, `--p`, `--est`, etc. | `-i`, etc. | Universal Column Filtering. Targets tasks based on any column in the plan table (supports `=, >, <, !=, *, &&, ||`). |
|
|
41
|
+
| `--open` | `-o` | Sets `β Done` state to `β¬` (Open). Overrides execution. |
|
|
42
|
+
| `--def` | `-d` | Sets `β Done` state to `βΈοΈ Deferred`. Overrides execution. |
|
|
43
|
+
| `--can` | `-c` | Sets `β Done` state to `π« Cancelled`. Overrides execution. |
|
|
44
|
+
| `--help` | `-h` | Prints this help block. |
|
|
45
|
+
## Self-correct mode (dual-mode invocation)
|
|
46
|
+
|
|
47
|
+
```
|
|
48
|
+
/wbWork <scope_folder> # normal mode β produce a fresh output file
|
|
49
|
+
/wbWork <previous_output_file> # self-correct mode β verify & repair the file in place
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
When the first arg is an existing output file from a prior `/wbWork` run (detected by its first H1 β see this template's **Detection** section), the command runs in **verify-and-repair** mode: gap-fills missing fields, normalizes links, ticks done/valid checkboxes whose reports exist, never rewrites authored content. See [`../_shared/output_conventions.md`](../_shared/output_conventions.md) Β§3.
|
|
53
|
+
|
|
54
|
+
<!-- FLAGS_TABLE_END -->
|
|
55
|
+
<!-- HELP_GATE_END -->
|
|
56
|
+
|
|
57
|
+
<!-- FLAG_NORMALIZE_START -->
|
|
58
|
+
## Flag normalization (apply BEFORE parsing args)
|
|
59
|
+
- `-i` β `--id`
|
|
60
|
+
- `-o` β `--open`
|
|
61
|
+
- `-d` β `--def`
|
|
62
|
+
- `-c` β `--can`
|
|
63
|
+
<!-- FLAG_NORMALIZE_END -->
|
|
64
|
+
|
|
65
|
+
**ROLE:** The Worker / Executor
|
|
66
|
+
**TARGET:** The provided plan file (absolute path, relative path, or just the filename).
|
|
67
|
+
**Read first:** [`../_shared/output_conventions.md`](../_shared/output_conventions.md)
|
|
68
|
+
|
|
69
|
+
## βββ OBJECTIVE βββ
|
|
70
|
+
Your job is to locate the specified plan or idea file, parse its table, determine the operating workspace, and physically execute the tasks/ideas requested by the user's flags.
|
|
71
|
+
|
|
72
|
+
## βββ MODE DETECTION βββ
|
|
73
|
+
|
|
74
|
+
Read the target file's first H1 header to determine the operating mode:
|
|
75
|
+
|
|
76
|
+
- **`# Plan Backlog: <scope> β <date>`** β **PLAN MODE** (standard behavior, documented below).
|
|
77
|
+
- **`# Idea Backlog: <scope> β <date>`** β **IDEAS MODE** (see Β§IDEAS below).
|
|
78
|
+
- **Inline task with `idea:` prefix** (e.g., `/wbWork <scope> "idea: add CSV export"`) β **IDEA REGISTRATION MODE** (routes to idea file instead of plan file).
|
|
79
|
+
|
|
80
|
+
## βββ INSTRUCTIONS (PLAN MODE) βββ
|
|
81
|
+
|
|
82
|
+
1. **Locate the Plan:** Read the target file. If only a filename is provided (e.g. `plan_core2_20260503.md`), infer the workspace and locate it at `<pkg>/.wb/workflows/reports/<YYYY>/<MM>/<DD>/plans/<filename>`. If an inline task is provided (`/wbWork <scope_folder> "<issue>"`), find or create today's plan file for that scope.
|
|
83
|
+
2. **Pre-Flight Triage (Inline Tasks):** If an issue description is provided instead of an ID:
|
|
84
|
+
- **`idea:` prefix detection:** If the description starts with `idea:` or `π‘`, route to **IDEA REGISTRATION MODE** (see below) instead of the plan file.
|
|
85
|
+
- **Assess Complexity:** Assign a priority (P0-P3).
|
|
86
|
+
- **Simple (P2/P3):** Append a row to the plan's task table (Origin: "Manual", Task: "<desc>"). Proceed to Execution Mode.
|
|
87
|
+
- **Complex (P0/P1):** Append a parent row. Spawn a `/wbPlan` sub-process logically to break it into sub-tasks (e.g., `#N.1`, `#N.2`). Append the sub-plan table. Proceed to sequentially execute the sub-tasks.
|
|
88
|
+
3. **Parse Intent:**
|
|
89
|
+
- If no flag is given (e.g., `/wbWork plan_file.md`): This is **Self-Correction / Re-check Mode**. Do NOT just output state. Actively scan the plan file and the related task reports for missing data or formatting errors. Fix them immediately.
|
|
90
|
+
- If a target filter is provided WITH a state flag (`--open`, `--def`, `--can`): Do NOT execute the task. Instead, directly edit the plan file and update the `β Done` column of the matching tasks to the requested state.
|
|
91
|
+
- If a target filter is provided WITHOUT state flags (e.g., `--id=2` or `--p=P1`): Proceed to execute those specific tasks matching the criteria.
|
|
92
|
+
3. **Execution Mode:**
|
|
93
|
+
- Universal Column Filtering: You must apply the filter logic to any column of the table (e.g., `#`, `P`, `Est. Time (mins)`, `Worker`, `β Done`, `β Valid`).
|
|
94
|
+
- Recursive Task Logic: If the filter matches a parent recursive task (e.g., `--id=5`), this implies executing ALL of its child tasks (e.g., 5.1, 5.2, 5.3, 5.4) sequentially with your current model.
|
|
95
|
+
- Follow the `Task` description in the plan exactly.
|
|
96
|
+
- Perform the file edits, script executions, or tool calls needed.
|
|
97
|
+
4. **Report Generation:**
|
|
98
|
+
- For EACH task executed, create a report at: `.wb/workflows/reports/<YYYY>/<MM>/<DD>/plans/tasks/task_<ID>/task_<ID>_report_<TARGET>_<YYYYMMDD>.md`
|
|
99
|
+
- Create the `task_<ID>/` folder if it does not exist.
|
|
100
|
+
- Use the standard `# Task <ID>: <Title>` header format.
|
|
101
|
+
5. **Plan Update:**
|
|
102
|
+
- Edit the original plan file. Change the `#` column to a markdown link pointing to your new task report (e.g., `[<ID>](tasks/task_<ID>/task_<ID>_report_<TARGET>_<YYYYMMDD>.md)`).
|
|
103
|
+
- Change `β Done` to `β
<br>__YOUR_MODEL_NAME__`. **OVERWRITE rule:** The Done column is NOT cumulative. If another model's name is already there, completely overwrite it with yours. Only the final executor is tracked.
|
|
104
|
+
|
|
105
|
+
## βββ Β§IDEAS: INSTRUCTIONS (IDEAS MODE) βββ
|
|
106
|
+
|
|
107
|
+
When the target file is an `idea_*.md` file (H1 = `# Idea Backlog:`):
|
|
108
|
+
|
|
109
|
+
1. **Locate the Idea File:** Same pathing logic as plan files, but routed to `ideas/idea_<scope>_<YYYYMMDD>.md`.
|
|
110
|
+
2. **Parse Intent:**
|
|
111
|
+
- If no flag is given β **Self-Correction / Re-check Mode** on the idea file.
|
|
112
|
+
- If a target filter is provided WITH a state flag (`--open`, `--def`, `--can`) β Update the `β Done` column of matching ideas.
|
|
113
|
+
- If a target filter is provided WITHOUT state flags β Proceed to **Idea Exploration Mode**.
|
|
114
|
+
3. **Idea Exploration Mode:**
|
|
115
|
+
- Read the idea description from the `Idea` column.
|
|
116
|
+
- **Explore the idea in depth**: feasibility analysis, impact assessment, implementation sketch, risks, estimated cost if promoted.
|
|
117
|
+
- Do NOT implement the idea. Only analyze and document.
|
|
118
|
+
4. **Report Generation (Ideas):**
|
|
119
|
+
- For EACH idea explored, create a report at: `.wb/workflows/reports/<YYYY>/<MM>/<DD>/ideas/ideas_reports/idea_<ID>/idea_<ID>_report_<TARGET>_<YYYYMMDD>.md`
|
|
120
|
+
- Create the `idea_<ID>/` folder if it does not exist.
|
|
121
|
+
- Use the header format: `# Idea <ID>: <Title> β Exploration Report`
|
|
122
|
+
- Include: High-Level Summary, Feasibility Analysis, Impact Assessment, Implementation Sketch, Risks & Mitigations, Estimated Cost if Promoted, Recommendation (promote / defer / reject with reasoning).
|
|
123
|
+
5. **Idea File Update:**
|
|
124
|
+
- Change the `#` column to a link: `[<ID>](ideas_reports/idea_<ID>/idea_<ID>_report_<TARGET>_<YYYYMMDD>.md)`.
|
|
125
|
+
- Change `β Done` to `β
<br>__YOUR_MODEL_NAME__`.
|
|
126
|
+
|
|
127
|
+
## βββ Β§IDEA_REG: IDEA REGISTRATION MODE βββ
|
|
128
|
+
|
|
129
|
+
When an inline description starts with `idea:` or `π‘` (e.g., `/wbWork <scope> "idea: add CSV export"`):
|
|
130
|
+
|
|
131
|
+
1. Strip the `idea:` or `π‘` prefix to get the idea description.
|
|
132
|
+
2. Locate (or create) today's idea file: `<scope>/.wb/workflows/reports/<YYYY>/<MM>/<DD>/ideas/idea_<scope>_<YYYYMMDD>.md`.
|
|
133
|
+
3. Compute a Score (1β10) using the scoring heuristic from `wbIdea_template.md`.
|
|
134
|
+
4. Append a new row to the idea table with: Score, Idea description, Priority, Est. Time, `Suggested By: Manual`, `β Done: β¬`, `β Valid: β¬`, `β Task: β`.
|
|
135
|
+
5. Do NOT execute the idea. Output: "Idea registered as #N in idea_<scope>_<YYYYMMDD>.md."
|
|
136
|
+
|
|
137
|
+
## π§ What's Next?
|
|
138
|
+
- **Plan Mode:** End your response by telling the user to run `/wbValid <target> --id=<ID>` to formally validate the work you just completed.
|
|
139
|
+
- **Ideas Mode:** End your response by telling the user to run `/wbValid idea_<scope>_<YYYYMMDD>.md --id=<ID>` to validate the exploration and potentially promote the idea to a plan.
|
|
140
|
+
- **Idea Registration Mode:** End your response by suggesting `/wbWork idea_<scope>_<YYYYMMDD>.md --id=<N>` to explore the newly registered idea.
|