2504 Design Eba3b6a5

# Technical Design: finish-rename

## Metadata
- **Feature**: finish-rename
- **Status**: DRAFT
- **Created**: 2026-01-30

## 1. Overview

Finish the troubleshoot→debug rename. Previous work completed all `zerg/` package renames (commands, diagnostics, CLI, tests). Remaining: `.zerg/` runtime scripts, installed commands, documentation.

## 2. Scope

### Already Completed
- `zerg/commands/debug.py` (renamed from troubleshoot.py)
- `zerg/commands/__init__.py`, `zerg/cli.py` (imports updated)
- `zerg/data/commands/zerg:debug.md` (slash command renamed)
- `zerg/diagnostics/` (all refs cleaned)
- `tests/unit/test_debug_cmd.py`, `tests/integration/test_debug.py` (renamed)
- `install_commands.py` (z: shortcut support added)

### Remaining Work (3 levels, 5 tasks)

| Level | Tasks | Parallel |
|-------|-------|----------|
| L1 - Code | 2 tasks: .zerg/ scripts + command reinstall | Yes |
| L2 - Docs | 2 tasks: backlog/coverage docs + .gsd task docs | Yes |
| L3 - Quality | 1 task: gates | No |

## 3. File Ownership

| File | Task | Operation |
|------|------|-----------|
| `.zerg/debug.py` | FR-L1-001 | create (from rename) |
| `.zerg/troubleshoot.py` | FR-L1-001 | delete |
| `.zerg/tests/test_debug.py` | FR-L1-001 | create (from rename) |
| `.zerg/tests/test_troubleshoot.py` | FR-L1-001 | delete |
| `.claude/commands/` | FR-L1-002 | reinstall |
| `zerg/data/commands/zerg:debug.md` | FR-L1-002 | modify (1 line) |
| `tasks/COVERAGE-100-BACKLOG.md` | FR-L2-001 | modify |
| `claudedocs/backlog.md` | FR-L2-001 | modify |
| `.gsd/tasks/prompts/L3-quality-commands.md` | FR-L2-002 | modify |
| `.gsd/tasks/prompts/README.md` | FR-L2-002 | modify |
| `.gsd/tasks/documentation/BACKLOG.md` | FR-L2-002 | modify |
| `.gsd/tasks/cli-commands-tests/BACKLOG.md` | FR-L2-002 | modify |

## 4. Dependency Graph

```
L1: FR-L1-001 (rename .zerg/ scripts) ──┐
    FR-L1-002 (reinstall + fix cmd)   ──┤
                                         │
L2: FR-L2-001 (user docs)             ──┤─ depends on L1
    FR-L2-002 (.gsd task docs)        ──┘
                                         │
L3: FR-L3-001 (quality gates)         ──── depends on L2
```

## 5. Recommended Workers
- Optimal: 2 workers (widest level is 2 tasks)
- Maximum: 2 workers

## 6. Approval

| Role | Name | Date | Signature |
|------|------|------|-----------|
| Architecture | | | PENDING |