wu:edit

← Back to CLI Commands

wu:edit

Edit WU spec fields

pnpm wu:edit --id <wuId>

Options:

Flag	Description	Required
-i, --id <wuId>	Work Unit ID (e.g., WU-123). If not provided, auto-generates next sequential ID.	Yes
--spec-file <path>	Path to YAML file with updated spec content	No
--title <text>	New title text (replaces existing)	No
--description <text>	New description text (replaces existing)	No
--acceptance <criterion>	Acceptance criterion (repeatable, appends to existing; use —replace-acceptance to overwrite)	No
--notes <text>	Notes text (appends to existing; use —replace-notes to overwrite)	No
--replace-notes	Replace existing notes instead of appending	No
--replace-acceptance	Replace existing acceptance criteria instead of appending	No
--code-paths <path>	Code path (repeatable, appends to existing; use —replace-code-paths to overwrite)	No
--remove-code-paths <path>	Remove specific code_paths entries without replacing the full array	No
--rename-code-paths <old=new>	Rename specific code_paths entries without rewriting the full array	No
--replace-code-paths	Replace existing code_paths instead of appending	No
--spec-refs <path>	Spec/plan reference (repeatable, appends to existing; use —replace-spec-refs to overwrite)	No
--remove-spec-refs <path>	Remove specific spec_refs entries without replacing the full array	No
--rename-spec-refs <old=new>	Rename specific spec_refs entries without rewriting the full array	No
--replace-spec-refs	Replace existing spec_refs instead of appending	No
--risks <risk>	Risk entry (repeatable, appends to existing; use —replace-risks to overwrite)	No
--replace-risks	Replace existing risks instead of appending	No
--append	[DEPRECATED] Arrays now append by default. Use —replace-* flags to replace.	No
--test-paths-manual <tests>	Manual test descriptions (repeatable)	No
--test-paths-unit <paths>	Unit test file paths (repeatable)	No
--test-paths-e2e <paths>	E2E test file paths (repeatable)	No
--remove-test-paths-manual <text>	Remove specific manual test entries without replacing the full array	No
--rename-test-paths-manual <old=new>	Rename specific manual test entries without rewriting the full array	No
--remove-test-paths-unit <path>	Remove specific unit test paths without replacing the full array	No
--rename-test-paths-unit <old=new>	Rename specific unit test paths without rewriting the full array	No
--remove-test-paths-e2e <path>	Remove specific e2e test paths without replacing the full array	No
--rename-test-paths-e2e <old=new>	Rename specific e2e test paths without rewriting the full array	No
--replace-test-paths-unit	Replace existing unit test paths instead of appending	No
--replace-test-paths-e2e	Replace existing e2e test paths instead of appending	No
--replace-test-paths-manual	Replace existing manual test descriptions instead of appending	No
--lane <lane>	New lane assignment (e.g., “Operations: Tooling”)	No
--type <type>	New WU type (feature, bug, refactor, documentation)	No
--priority <priority>	New priority (P0, P1, P2, P3)	No
--initiative <initId>	Initiative ID (e.g., INIT-001). Updates WU and initiative wus: arrays bidirectionally.	No
--blocked-by <wuIds>	Comma-separated WU IDs that block this WU (appends to existing; use —replace-blocked-by to overwrite)	No
--replace-blocked-by	Replace existing blocked_by instead of appending	No
--clear-blocked-by	Empty blocked_by entirely (mutually exclusive with —blocked-by/—replace-blocked-by)	No
--add-dep <wuIds>	Comma-separated WU IDs to add to dependencies array (appends to existing; use —replace-dependencies to overwrite)	No
--replace-dependencies	Replace existing dependencies instead of appending	No
--clear-dependencies	Empty dependencies entirely (mutually exclusive with —add-dep/—replace-dependencies)	No
--plan <uri>	Plan file URI (lumenflow://plans/… or repo-relative path)	No
--estimated-files <count>	Sizing: modified artifacts; files only read are excluded (non-negative integer)	No
--estimated-tool-calls <count>	Sizing: whole-WU calls; per-session checkpoint safety remains separate	No
--sizing-strategy <strategy>	Executable strategy (single-session, checkpoint-resume, orchestrator-worker; decomposition is plan-only)	No
--sizing-exception-type <type>	Optional bounded sizing exception (docs-only, shallow-multi-file, review-audit); WU type, paths, and strategy must qualify	No
--sizing-exception-reason <text>	Required with an exception type; for review-audit, record modified outputs here and read coverage separately	No
--exposure <type>	Exposure level (ui, api, backend-only, documentation)	No
--no-strict	Bypass code_paths/test_paths path existence checks. Reality-phase checks run at wu:prep/wu:done. Logged when used.	No

---

← Back to CLI Commands