@lumenflow/cli 4.24.0 → 5.0.0

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

@@ -2,77 +2,52 @@
 
 **Last updated:** {{DATE}}
 
-This project uses LumenFlow workflow. For workflow documentation, see [LUMENFLOW.md](../LUMENFLOW.md).
+Read [AGENTS.md](AGENTS.md) first, then [LUMENFLOW.md](LUMENFLOW.md) for the canonical workflow.
 If `LUMENFLOW.local.md` exists, read it after LUMENFLOW.md for project-specific additions.
 
----
+This file contains Claude-specific reminders only. Do not duplicate workflow rules from
+LUMENFLOW.md here.
 
-## Quick Start
+## Command Discovery (MANDATORY)
 
-```bash
-# 1. Read workflow documentation
-# See LUMENFLOW.md for complete workflow
+1. Run `pnpm lumenflow:commands` to discover available commands
+2. Run `<command> --help` before first use of any command
+3. Never truncate command output while checking commands, help, or remediation text
+
+## Workflow Summary
 
-# 2. Claim a WU
+```bash
+# Claim the WU from the main checkout
 pnpm wu:claim --id WU-XXXX --lane <Lane>
 cd worktrees/<lane>-wu-xxxx
 
-# 3. Work in worktree, run gates
-pnpm gates
+# Record the mandatory handoff artifact before coding
+pnpm wu:brief --id WU-XXXX --client claude-code
+
+# Work in the claimed worktree, capture shared memory as needed
+pnpm wu:prep --id WU-XXXX
 
-# 4. Complete (ALWAYS run this!)
+# Complete from the main checkout
 cd {{PROJECT_ROOT}}
 pnpm wu:done --id WU-XXXX
 ```
 
-> **Complete CLI reference:** See [quick-ref-commands.md](../ai/onboarding/quick-ref-commands.md)
-
----
-
-## Critical: Always wu:done
-
-After completing work, ALWAYS run `pnpm wu:done --id WU-XXXX`.
-
-See [LUMENFLOW.md](../LUMENFLOW.md) and [ai/onboarding/troubleshooting-wu-done.md](../ai/onboarding/troubleshooting-wu-done.md).
-
----
-
-## Orchestration & Memory Commands
-
-Essential commands for multi-agent coordination and context management:
-
-| Command                                    | Description                       |
-| ------------------------------------------ | --------------------------------- |
-| `pnpm orchestrate:init-status -i INIT-XXX` | View initiative progress          |
-| `pnpm orchestrate:monitor`                 | Monitor spawn/agent activity      |
-| `pnpm mem:checkpoint --wu WU-XXX`          | Save progress checkpoint          |
-| `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` | **MANDATORY after wu:claim.** Generate prompt + evidence |
-
-**When to checkpoint:**
-- After each acceptance criterion completed
-- Before running gates
-- Every 30+ tool calls
-
-**When to check inbox:**
-- Before starting complex work (parallel agents may have signals)
-- When blocked (other agents may have completed dependencies)
-
----
+Completion is `wu:prep` in the worktree, then `wu:done` from the main checkout.
 
-## Claude-Specific Settings
+## Shared Memory
 
-This directory contains Claude Code-specific configuration:
+- Use `pnpm mem:create --type discovery --wu WU-XXXX --title '<note>'` for repo facts another agent would need
+- Use `pnpm mem:signal '<status>' --wu WU-XXXX` for short coordination updates
+- Use `pnpm mem:checkpoint --wu WU-XXXX --note '<progress>' --next-steps '<next>'` before long operations
 
-- `settings.json` - Permissions and hooks
-- `hooks/` - Pre-tool validation hooks
+## Claude-Specific Notes
 
----
+- Claude-specific config lives under `.claude/`
+- When the public CLI surface changes, update `LUMENFLOW.md` and rerun `pnpm docs:sync`
 
 ## References
 
-- [LUMENFLOW.md](../LUMENFLOW.md) - Main workflow documentation
-- [.lumenflow/constraints.md](../.lumenflow/constraints.md) - Non-negotiable rules
-- [ai/onboarding/](../ai/onboarding/) - Agent onboarding docs
+- [AGENTS.md](AGENTS.md)
+- [LUMENFLOW.md](LUMENFLOW.md)
+- [.lumenflow/constraints.md](.lumenflow/constraints.md)
+- [quick-ref-commands.md](docs/operations/_frameworks/lumenflow/agent/onboarding/quick-ref-commands.md)

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

@@ -11,75 +11,47 @@ This file contains Cursor-specific overrides only. Do not duplicate workflow rul
 2. Run `<command> --help` before first use of any command — do not guess flags or subcommands
 3. **Never truncate** CLI output (`| head`, `| tail`, `| head -n`) — read the full output
 
-## Critical Rules
-
-1. **Always run wu:done** - After gates pass, run `pnpm wu:done --id WU-XXX`
-2. **Work in worktrees** - After `wu:claim`, work only in the worktree
-3. **Never bypass hooks** - No `--no-verify`
-4. **TDD** - Write tests first
-
-## Forbidden Commands
-
-- `git reset --hard`
-- `git push --force`
-- `git stash` (on main)
-- `--no-verify`
-
-## Quick Reference
+## Workflow Summary
 
 ```bash
-# Claim WU
+# Claim the WU from the main checkout
 pnpm wu:claim --id WU-XXX --lane <Lane>
 cd worktrees/<lane>-wu-xxx
 
-# Run gates
-pnpm gates
+# Record the mandatory handoff artifact before coding
+pnpm wu:brief --id WU-XXX --client cursor
+
+# Work in the claimed worktree, then prep before completion
+pnpm wu:prep --id WU-XXX
 
 # Complete (from main)
 cd {{PROJECT_ROOT}}
 pnpm wu:done --id WU-XXX
 ```
 
-> **Complete CLI reference (100+ commands):** See [quick-ref-commands.md](../../ai/onboarding/quick-ref-commands.md)
-
-## CLI Commands
+Completion is `wu:prep` in the worktree, then `wu:done` from the main checkout.
 
-### WU Lifecycle
+## Shared Memory
 
-| Command                                        | Description                                 |
-| ---------------------------------------------- | ------------------------------------------- |
-| `pnpm wu:status --id WU-XXX`                   | Show WU status, location, valid commands    |
-| `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>`  | **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        |
-| `pnpm wu:verify --id WU-XXX`                   | Verify WU completion (stamp, commit, clean tree) |
-| `pnpm wu:delete --id WU-XXX`                   | Delete WU spec and cleanup                  |
+- Use `pnpm mem:create --type discovery --wu WU-XXXX --title '<note>'` for reusable repo facts
+- Use `pnpm mem:signal '<status>' --wu WU-XXXX` for coordination updates
+- Use `pnpm mem:checkpoint --wu WU-XXXX --note '<progress>' --next-steps '<next>'` before long operations
 
-### Gates & Orchestration
+## Critical Rules
 
-| Command                                    | Description                                        |
-| ------------------------------------------ | -------------------------------------------------- |
-| `pnpm gates`                               | Run all quality gates                              |
-| `pnpm lumenflow:commands`                  | List all public commands (primary + alias + legacy) |
-| `pnpm mem:checkpoint --wu WU-XXX`          | Save progress checkpoint                           |
-| `pnpm mem:recover --wu WU-XXX`             | Generate recovery context                          |
+1. **Work in worktrees** - After `wu:claim`, work only in the worktree
+2. **Never bypass hooks** - No `--no-verify`
+3. **TDD** - Write tests first when policy requires it
+4. **Docs parity matters** - When the public CLI surface changes, update `LUMENFLOW.md` and rerun `pnpm docs:sync`
 
----
+## Forbidden Commands
 
-## Workflow Summary
+- `git reset --hard`
+- `git push --force`
+- `git stash` (on main)
+- `--no-verify`
 
-| Step         | Command                                                          |
-| ------------ | ---------------------------------------------------------------- |
-| 1. Create WU | `pnpm wu:create --lane <Lane> --title "..."` (ID auto-generated) |
-| 2. Claim     | `pnpm wu:claim --id WU-XXX --lane <Lane>`                        |
-| 3. Work      | `cd worktrees/<lane>-wu-xxx`                                     |
-| 4. Gates     | `pnpm gates`                                                     |
-| 5. Prep      | `pnpm wu:prep --id WU-XXX`                                       |
-| 6. Complete  | `pnpm wu:done --id WU-XXX`                                       |
+> **Complete CLI reference (100+ commands):** See [quick-ref-commands.md](../../docs/operations/_frameworks/lumenflow/agent/onboarding/quick-ref-commands.md)
 
 ## Disable / Uninstall
 
@@ -96,5 +68,5 @@ Flags: `--keep-history`, `--keep-config`, `--client <name>`.
 
 - **Worktree Discipline**: After claiming a WU, immediately `cd` to the worktree
 - **Main is read-only**: Do not edit files in the main checkout after claiming
-- **Gates before done**: Always run `pnpm gates` before `wu:done`
+- **Brief before prep**: `pnpm wu:brief` is mandatory after `wu:claim`
 - **Never skip hooks**: The `--no-verify` flag is forbidden

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

@@ -11,75 +11,47 @@ This file contains Windsurf-specific overrides only. Do not duplicate workflow r
 2. Run `<command> --help` before first use of any command — do not guess flags or subcommands
 3. **Never truncate** CLI output (`| head`, `| tail`, `| head -n`) — read the full output
 
-## Critical Rules
-
-1. **Always run wu:done** - After gates pass, run `pnpm wu:done --id WU-XXX`
-2. **Work in worktrees** - After `wu:claim`, work only in the worktree
-3. **Never bypass hooks** - No `--no-verify`
-4. **TDD** - Write tests first
-
-## Forbidden Commands
-
-- `git reset --hard`
-- `git push --force`
-- `git stash` (on main)
-- `--no-verify`
-
-## Quick Reference
+## Workflow Summary
 
 ```bash
-# Claim WU
+# Claim the WU from the main checkout
 pnpm wu:claim --id WU-XXX --lane <Lane>
 cd worktrees/<lane>-wu-xxx
 
-# Run gates
-pnpm gates
+# Record the mandatory handoff artifact before coding
+pnpm wu:brief --id WU-XXX --client windsurf
+
+# Work in the claimed worktree, then prep before completion
+pnpm wu:prep --id WU-XXX
 
 # Complete (from main)
 cd {{PROJECT_ROOT}}
 pnpm wu:done --id WU-XXX
 ```
 
-> **Complete CLI reference (100+ commands):** See [quick-ref-commands.md](../../ai/onboarding/quick-ref-commands.md)
-
-## CLI Commands
+Completion is `wu:prep` in the worktree, then `wu:done` from the main checkout.
 
-### WU Lifecycle
+## Shared Memory
 
-| Command                                        | Description                                 |
-| ---------------------------------------------- | ------------------------------------------- |
-| `pnpm wu:status --id WU-XXX`                   | Show WU status, location, valid commands    |
-| `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>`  | **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        |
-| `pnpm wu:verify --id WU-XXX`                   | Verify WU completion (stamp, commit, clean tree) |
-| `pnpm wu:delete --id WU-XXX`                   | Delete WU spec and cleanup                  |
+- Use `pnpm mem:create --type discovery --wu WU-XXXX --title '<note>'` for reusable repo facts
+- Use `pnpm mem:signal '<status>' --wu WU-XXXX` for coordination updates
+- Use `pnpm mem:checkpoint --wu WU-XXXX --note '<progress>' --next-steps '<next>'` before long operations
 
-### Gates & Orchestration
+## Critical Rules
 
-| Command                                    | Description                                        |
-| ------------------------------------------ | -------------------------------------------------- |
-| `pnpm gates`                               | Run all quality gates                              |
-| `pnpm lumenflow:commands`                  | List all public commands (primary + alias + legacy) |
-| `pnpm mem:checkpoint --wu WU-XXX`          | Save progress checkpoint                           |
-| `pnpm mem:recover --wu WU-XXX`             | Generate recovery context                          |
+1. **Work in worktrees** - After `wu:claim`, work only in the worktree
+2. **Never bypass hooks** - No `--no-verify`
+3. **TDD** - Write tests first when policy requires it
+4. **Docs parity matters** - When the public CLI surface changes, update `LUMENFLOW.md` and rerun `pnpm docs:sync`
 
----
+## Forbidden Commands
 
-## Workflow Summary
+- `git reset --hard`
+- `git push --force`
+- `git stash` (on main)
+- `--no-verify`
 
-| Step         | Command                                                          |
-| ------------ | ---------------------------------------------------------------- |
-| 1. Create WU | `pnpm wu:create --lane <Lane> --title "..."` (ID auto-generated) |
-| 2. Claim     | `pnpm wu:claim --id WU-XXX --lane <Lane>`                        |
-| 3. Work      | `cd worktrees/<lane>-wu-xxx`                                     |
-| 4. Gates     | `pnpm gates`                                                     |
-| 5. Prep      | `pnpm wu:prep --id WU-XXX`                                       |
-| 6. Complete  | `pnpm wu:done --id WU-XXX`                                       |
+> **Complete CLI reference (100+ commands):** See [quick-ref-commands.md](../../docs/operations/_frameworks/lumenflow/agent/onboarding/quick-ref-commands.md)
 
 ## Disable / Uninstall
 
@@ -96,5 +68,5 @@ Flags: `--keep-history`, `--keep-config`, `--client <name>`.
 
 - **Worktree Discipline**: After claiming a WU, immediately `cd` to the worktree
 - **Main is read-only**: Do not edit files in the main checkout after claiming
-- **Gates before done**: Always run `pnpm gates` before `wu:done`
+- **Brief before prep**: `pnpm wu:brief` is mandatory after `wu:claim`
 - **Never skip hooks**: The `--no-verify` flag is forbidden