| name | workspace-delete |
| description | Delete a workspace (with confirmation) |
workspace-delete
Overview
This skill safely deletes a workspace by first showing its status and confirming with the user. It ensures the user is aware of any incomplete work before deletion.
Paths: Use relative paths from project root (see CLAUDE.md for details).
Steps
1. Workspace
Required: User must specify the workspace.
- If workspace is not specified, abort with message:
Please specify a workspace. Example: /workspace-delete workspace/feature-user-auth-20260116
- Workspace format:
workspace/{workspace-name} or just {workspace-name}
2. Check Workspace Status
Run the script to gather workspace status:
.claude/skills/workspace-delete/scripts/check-workspace-status.sh {workspace-name}
The script outputs:
- Last activity date and file
- TODO status (completed/incomplete counts per file)
- List of incomplete items
3. Read Workspace Overview
Read the README.md to understand the workspace context:
cat workspace/{workspace-name}/README.md
4. Display Status to User
Refer to .claude/skills/workspace-delete/templates/workspace-status.md for the format.
Fill in the placeholders with the collected information.
If there are incomplete TODO items, include a warning:
⚠️ **Warning**: This workspace has {count} incomplete TODO items.
Deleting this workspace will lose track of this pending work.
5. Confirm Deletion
Ask the user for confirmation using the AskUserQuestion tool:
- If incomplete items exist: Require explicit confirmation
- If all items complete: Still confirm but with less urgency
6. Delete the Workspace
If the user confirms, run the deletion script:
.claude/skills/workspace-delete/scripts/workspace-delete.sh {workspace-name}
The script:
- Removes git worktrees (to clean up git references)
- Deletes the workspace directory
7. Confirm Deletion
Report the result to the user.
Refer to .claude/skills/workspace-delete/templates/deletion-confirmed.md for the format.
Example Usage
User: Delete workspace feature-user-auth-20260116
Assistant: Let me check the workspace status first...
## Workspace Status
**Workspace**: feature-user-auth-20260116
**Last Activity**: 2026-01-16 15:30:00
### Overview
Task: Implement user authentication
Created: 2026-01-16
### TODO Status
#### TODO-auth-service.md
- Completed: 5
- Incomplete: 2
- [ ] Add rate limiting
- [ ] Write integration tests
⚠️ **Warning**: This workspace has 2 incomplete TODO items.
Are you sure you want to delete this workspace?
User: Yes, delete it
Assistant: [Deletes workspace and confirms]
Notes
- Always remove git worktrees before deleting the directory to avoid orphaned references
- Incomplete TODO items are listed to help the user make an informed decision
- The deletion is irreversible, so confirmation is mandatory