windows-dev-process-cleanup

Windows Dev Process Cleanup

Audit first and use the narrowest profile. Requires Windows and PowerShell 7; replace <skill-dir> with the loaded skill directory.

Workflow

1. Audit without side effects:

pwsh -NoLogo -NoProfile -File "<skill-dir>/scripts/audit-dev-processes.ps1" -Mode audit -AsJson
pwsh -NoLogo -NoProfile -File "<skill-dir>/scripts/audit-uwp-backgroundtasks.ps1" -Mode audit -AsJson

1. Treat blocked, mixed_tree, unknown, identity-missing, protected members, and audit_status: failed as manual review.

2. Select one profile:

• Dev: safe, playwright-mcp, codex-playwright-safe, safe-plus-codex-playwright, or workspace-dev-server with an existing -WorkspacePath.
• UWP: phone-link-background or dolby-backgroundtask. Dolby cleanup terminates only matching backgroundTaskHost instances.

1. Preview the exact plan before cleanup:

pwsh -NoLogo -NoProfile -File "<skill-dir>/scripts/audit-dev-processes.ps1" -Mode cleanup -Profile codex-playwright-safe -StaleMinutes 45 -WhatIf -AsJson
pwsh -NoLogo -NoProfile -File "<skill-dir>/scripts/audit-uwp-backgroundtasks.ps1" -Mode cleanup -Profile dolby-backgroundtask -WhatIf -AsJson

Run without -WhatIf only after an explicit cleanup request and an unblocked plan. The scripts recheck identity and affected members; drift fails the precondition.

Phone Link 2.0 Change

-DisablePhoneLinkBackground is deprecated and fails closed. It never writes the registry. Microsoft documents the supported per-app control in Windows Settings under System > Power & battery > Battery usage > Manage background activity. See migration-2.0.md.

Output Contract

Report normalized inputs, affected PIDs/fingerprints, roles/protection, blocked reasons, plan_id, target counts, preconditions, command status, and per-member outcomes. A zero taskkill exit code is not proof of termination.

Process termination is irreversible. Report exports are local files. No registry rollback exists because version 2.0 performs no registry mutation.

Boundaries And Resources

Read safety-policy.md for profiles and confirmation, and windows-command-contracts.md for platform evidence. Tests use file-backed fixture inputs and side-effect shims; never validate with real cleanup or registry writes.

Do not use this skill to disable services, uninstall apps, investigate malware, or terminate arbitrary processes. Mark unavailable runtime telemetry, provider benchmarks, and independent human review as missing evidence.