git:20260902.f449d80 to git:20260909.26f4ceb

---

name: auditing-workspaces

description: Audit a whiteboard workspace's documents to find likely-stale or duplicate spatial canvases before creating new ones. Use when a workspace has been in heavy use and you want to check for clutter, or you want a quick sense of what a document actually contains before opening it.

---

# auditing-workspaces

List a workspace's documents, then use the spatial ones' scene digests to judge which look empty

or abandoned. There is no server-side audit endpoint — this skill is a recipe for composing the

regular document tools toward that end, nothing more.

For the main drawing workflow, see the drawing-visuals skill in `skills/drawing-visuals/SKILL.md`.

---

## When To Use It

- When a workspace has been in heavy use and you want a sense of what is in it before adding more

- When you want to check for a likely-duplicate path before calling `wb_document_create`

- When you want to know whether a spatial document is worth opening without rendering it

---

## Execution Flow

### Step 1: List The Workspace's Documents

```js

wb_document_list({ workspaceId })

```

Returns `{ documents: [{ documentId, path, name?, kind?, updatedAt?, shadowed? }] }` — placement only, no content. An unknown

`workspaceId` is an error here, not an empty list, so a typo reads as a failure rather than "nothing

found."

### Step 2: Classify, Then Sample Each Document

```js

```

**Read the kind before reading the content.** A spatial read refuses a document it knows to be

markdown rather than reporting its containers as empty, so it cannot silently answer "nothing

here" about a document full of prose — but it also cannot tell you the kind of a document you have

Once a document is KNOWN spatial (from `wb_document_get`'s `kind`, or because this session created

it), `wb_canvas_snapshot` is the cheap re-probe for later passes — node text, geometry and lock

state without the untruncated JSON Canvas payload:

```js

wb_canvas_snapshot({ workspaceId, documentId }) // what is on it

wb_canvas_snapshot({ workspaceId, documentId, layout: true }) // ...and whether it is tidy

```

to write to it (a `wb_canvas_edit` call records `spatial`, `wb_document_set` records `markdown`).

### Step 3: Judge Staleness

There is no last-modified or last-accessed timestamp exposed through these tools. Judge staleness

structurally instead:

| Signal | How To Check | Likely Meaning |

| --- | --- | --- |

| empty spatial document | `kind` is `spatial` (Step 2) AND digest reports zero nodes | never drawn, or already redrawn elsewhere — candidate for `wb_document_delete`. A zero-node digest ALONE proves nothing: markdown documents always digest empty |

| near-duplicate path | two `wb_document_list` entries with similar `path`/`name` | probably one abandoned in favor of the other |

| markdown document with an empty body | `content` is blank apart from frontmatter | scaffolded but never written |

### Step 4: Write The Report

Keep the user-facing summary short and structured:

```text

## whiteboard audit report — workspace {workspaceId}

Documents: {N}

Empty or near-empty: {list of path -> documentId}

Likely-duplicate paths: {pairs}

No recorded kind: {list}

### Deletion candidates

- {path} ({documentId}): {reason}

```

Do **not** delete anything automatically. Always confirm with the user before calling

`wb_document_delete`.

---

## Notes

- `wb_document_delete` fails if other documents sit below the target's path — deletion is refused

rather than silently cascading, so report the blocker back to the user instead of retrying

differently.

- Deletion is not recoverable through these tools beyond a document's own saved versions

(`wb_version_list` / `wb_version_restore`) — the same history the History panel shows — and

those do not survive the document itself being deleted.