@lumenflow/cli 3.16.1 → 3.17.1

package/templates/core/ai/onboarding/starting-prompt.md.template

@@ -520,8 +520,8 @@ extra project commands, or client-specific overrides.
 
 - New installs get the current defaults automatically.
 - Existing installs get the runtime defaults after `pnpm lumenflow:upgrade --latest`.
-- Run `pnpm docs:sync --force` when you also want refreshed core docs, onboarding docs, and
-  supported vendor assets.
+- `pnpm lumenflow:upgrade --latest` already refreshes managed docs, onboarding docs, and configured
+  vendor assets. Use `pnpm docs:sync --vendor <type>` only for an extra targeted refresh.
 
 Default profiles:
 
@@ -556,7 +556,7 @@ Domain-specific commands must come from local configuration, not core framework
 | `pnpm wu:claim --id WU-XXX --lane "Lane"`      | Claim WU and create worktree (default)           | Start working (local)       |
 | `pnpm wu:claim --id WU-XXX --lane "L" --cloud` | Claim WU in branch-pr mode (no worktree)         | Start working (cloud)       |
 | `pnpm wu:edit --id WU-XXX --field value`       | Edit WU spec fields                              | Update notes/desc           |
-| `pnpm wu:brief --id WU-XXX --client <client>`  | Generate handoff prompt + record evidence        | Delegation or self-impl     |
+| `pnpm wu:brief --id WU-XXX --client <client>`  | **MANDATORY after wu:claim.** Generate prompt + evidence | Delegation or self-impl     |
 | `pnpm wu:delegate --id WU-XXX --parent-wu P`   | Generate prompt + record delegation              | Auditable delegation flows  |
 | `pnpm wu:prep --id WU-XXX`                     | Run gates in claimed workspace, prep completion  | Before wu:done              |
 | `pnpm wu:done --id WU-XXX`                     | Complete WU (merge or PR, cleanup)               | After gates pass            |

package/templates/vendors/claude/.claude/CLAUDE.md.template

@@ -3,6 +3,7 @@
 **Last updated:** {{DATE}}
 
 This project uses LumenFlow workflow. For workflow documentation, see [LUMENFLOW.md](../LUMENFLOW.md).
+If `LUMENFLOW.local.md` exists, read it after LUMENFLOW.md for project-specific additions.
 
 ---
 
@@ -48,7 +49,7 @@ Essential commands for multi-agent coordination and context management:
 | `pnpm mem:inbox --since 30m`               | Check coordination signals        |
 | `pnpm mem:signal "msg" --wu WU-XXX`        | Broadcast signal to other agents  |
 | `pnpm mem:create "msg" --wu WU-XXX`        | Create memory node (bug capture)  |
-| `pnpm wu:brief --id WU-XXX --client claude-code` | Generate handoff prompt + record evidence |
+| `pnpm wu:brief --id WU-XXX --client claude-code` | **MANDATORY after wu:claim.** Generate prompt + evidence |
 
 **When to checkpoint:**
 - After each acceptance criterion completed

package/templates/vendors/cursor/.cursor/rules/lumenflow.md.template

@@ -1,6 +1,7 @@
 # Cursor LumenFlow Rules
 
 **Read first:** [AGENTS.md](../../AGENTS.md) for universal startup rules, then [LUMENFLOW.md](../../LUMENFLOW.md) for the canonical workflow, commands, and safety rules.
+If `LUMENFLOW.local.md` exists, read it after LUMENFLOW.md for project-specific additions.
 
 This file contains Cursor-specific overrides only. Do not duplicate workflow rules from LUMENFLOW.md here.
 
@@ -51,7 +52,7 @@ pnpm wu:done --id WU-XXX
 | `pnpm wu:claim --id WU-XXX --lane <Lane>`      | Claim WU and create worktree                |
 | `pnpm wu:prep --id WU-XXX`                     | Run gates in worktree                       |
 | `pnpm wu:done --id WU-XXX`                     | Complete WU (from main)                     |
-| `pnpm wu:brief --id WU-XXX --client <client>`  | Generate handoff prompt + record evidence   |
+| `pnpm wu:brief --id WU-XXX --client <client>`  | **MANDATORY after wu:claim.** Generate prompt + evidence |
 | `pnpm wu:delegate --id WU-XXX --parent-wu <P>` | Generate prompt + record delegation lineage |
 | `pnpm wu:recover --id WU-XXX`                  | Fix WU state inconsistencies                |
 | `pnpm wu:escalate --id WU-XXX`                 | Show or resolve WU escalation status        |

package/templates/vendors/windsurf/.windsurf/rules/lumenflow.md.template

@@ -1,6 +1,7 @@
 # Windsurf LumenFlow Rules
 
 **Read first:** [AGENTS.md](../../AGENTS.md) for universal startup rules, then [LUMENFLOW.md](../../LUMENFLOW.md) for the canonical workflow, commands, and safety rules.
+If `LUMENFLOW.local.md` exists, read it after LUMENFLOW.md for project-specific additions.
 
 This file contains Windsurf-specific overrides only. Do not duplicate workflow rules from LUMENFLOW.md here.
 
@@ -51,7 +52,7 @@ pnpm wu:done --id WU-XXX
 | `pnpm wu:claim --id WU-XXX --lane <Lane>`      | Claim WU and create worktree                |
 | `pnpm wu:prep --id WU-XXX`                     | Run gates in worktree                       |
 | `pnpm wu:done --id WU-XXX`                     | Complete WU (from main)                     |
-| `pnpm wu:brief --id WU-XXX --client <client>`  | Generate handoff prompt + record evidence   |
+| `pnpm wu:brief --id WU-XXX --client <client>`  | **MANDATORY after wu:claim.** Generate prompt + evidence |
 | `pnpm wu:delegate --id WU-XXX --parent-wu <P>` | Generate prompt + record delegation lineage |
 | `pnpm wu:recover --id WU-XXX`                  | Fix WU state inconsistencies                |
 | `pnpm wu:escalate --id WU-XXX`                 | Show or resolve WU escalation status        |