Vault Taxonomy & Dead-Link Knowledge Audit

Template Overview

Even the most meticulously designed personal knowledge vault accumulates entropy over time: abandoned project scratchpads linger in root folders, dead wikilinks point to deleted notes, tags proliferate without consistent naming conventions, and orphaned atomic notes sit disconnected from any Map of Content.

An annual knowledge audit is a digital spring cleaning for your second brain. Rather than letting entropy degrade your vault into a digital hoarder’s attic, a disciplined audit restores speed, structural integrity, and cognitive clarity.

This template provides an end-to-end vault audit protocol: vault health metrics scorecard, link integrity verification, PARA directory reorganization, tag taxonomy pruning, and orphan note triage checklists.

Markdown Template Structure

Copy the block below or click Download .md File to add this template directly to your personal vault:

---
title: "Vault Audit: [Year] Annual Second Brain Maintenance"
date: [YYYY-MM-DD]
type: "vault-audit"
audit_lead: "[Your Name]"
vault_root_path: "[e.g., ~/Documents/Vault]"
total_files_audited: [Number]
audit_status: "Complete"
tags: [pkm, zettelkasten, vault-audit, maintenance, second-brain]
---

# Vault Audit: [Year] Annual Second Brain Maintenance

## 1. Vault Health Scorecard & Metric Snapshot
| Metric | Pre-Audit Baseline | Post-Audit Final | Health Target |
| :--- | :--- | :--- | :--- |
| **Total Markdown Notes** | 1,420 files | 1,280 files | Consolidated |
| **Orphaned Notes (0 links)** | 84 notes | 0 notes | 0 orphans |
| **Broken / Dead Wikilinks** | 38 links | 0 broken | 100% valid |
| **Total Distinct Tags** | 142 tags | 36 tags | $<40$ tags |
| **Disk Size (Vault Root)** | 42 MB (incl assets) | 38 MB | Optimized |

## 2. PARA Directory Maintenance & Archival
### 1-Projects
- [ ] Moved all completed or abandoned projects into `4-Archives/YYYY-[Project]`.
- [ ] Verified that remaining active projects have clear deadlines and next actions.

### 2-Areas of Responsibility
- [ ] Reviewed standards sheets for all active Areas.
- [ ] Archived inactive areas or merged redundant responsibility domains.

### 3-Resources
- [ ] Consolidated fragmented tool snippets into thematic resource libraries.
- [ ] Purged outdated documentation links and superseded RFC specs.

### 4-Archives
- [ ] Verified that archived folders are read-only and organized by year.

## 3. Zettelkasten Link & Graph Maintenance
- **Broken Link Sweep:** Run local vault link scanner to detect non-existent target files.
  ```bash
  # Check for dead wikilinks using local ripgrep
  rg -o '\[\[(.*?)\]\]' -r '$1' | sort -u

• Orphan Note Triage:
  • Option A: Link to an existing Map of Content (MOC).
  • Option B: Merge into a broader sibling atomic note.
  • Option C: Delete if it was an unrefined fleeting note with zero lasting value.

4. Tag Taxonomy Pruning & Consolidation

Deprecated Tag	Replacement Standard Tag	Notes Affected
#booknotes	#reading	24 notes updated
#todo-urgent	Replaced by Task Checklist [ ]	12 notes updated
#ideas	Replaced by fleeting-note status	18 notes updated

5. Attachment & Asset Sanitization

• Scanned ./attachments folder for unreferenced orphan images and PDFs.
• Compressed oversized PNG screenshots to optimized WebP format.

6. Executive Synthesis & Next Year Goals

• Key Reflection: What area of the vault experienced the highest intellectual velocity this year?
• Next Year’s Vault Focus: [e.g., Deepening systems architecture MOCs and drafting the book manuscript].

## Filled Real-World Example

Here is a realistic example demonstrating how this template captures actual deliberations:

```markdown
---
title: "Vault Audit: 2026 Annual Second Brain Maintenance"
date: [YYYY-MM-DD]
type: "vault-audit"
audit_lead: "Julian Thorne"
vault_root_path: "~/Documents/Personal-Vault"
total_files_audited: 1250
audit_status: "Complete"
tags: [pkm, zettelkasten, vault-audit, maintenance, second-brain]
---

# Vault Audit: 2026 Annual Second Brain Maintenance

## 1. Vault Health Scorecard & Metric Snapshot
| Metric | Pre-Audit Baseline | Post-Audit Final | Health Target |
| :--- | :--- | :--- | :--- |
| **Total Markdown Notes** | 1,250 files | 1,118 files | Consolidated |
| **Orphaned Notes (0 links)** | 62 notes | 0 notes | 0 orphans |
| **Broken / Dead Wikilinks** | 24 links | 0 broken | 100% valid |
| **Total Distinct Tags** | 118 tags | 28 tags | $<35$ tags |
| **Disk Size (Vault Root)** | 34 MB | 29 MB | Optimized |

## 2. PARA Directory Maintenance & Archival
- [x] Moved 6 completed projects (including `Launch-Templates-v1`) into `4-Archives/2026/`.
- [x] Updated standards for 4 Areas: Health, Infrastructure, Writing, and Finance.
- [x] Merged 14 scattered Rust snippets into `Resource: Modern CommonMark Engines`.

## 3. Zettelkasten Link & Graph Maintenance
- [x] Identified 24 broken wikilinks caused by renamed notes; repaired all link targets.
- [x] Triaged 62 orphaned notes: 38 connected to Maps of Content, 14 merged into atomic permanent notes, 10 empty fleeting notes permanently deleted.

## 4. Tag Taxonomy Pruning & Consolidation
| Deprecated Tag | Replacement Standard Tag | Notes Affected |
| :--- | :--- | :--- |
| `#article-idea` | `#writing` | 19 notes updated |
| `#tech-stuff` | `#engineering` | 31 notes updated |
| `#urgent` | Handled via task checklists | 8 notes updated |

## 5. Attachment & Asset Sanitization
- [x] Purged 14 MB of unused screenshot files from `./attachments/`.
- [x] Verified all local PDF attachments open correctly.

## 6. Executive Synthesis & Next Year Goals
- **Key Reflection:** The Zettelkasten slip-box generated three high-converting long-form essays this year with zero writer's block because research was pre-linked.
- **Next Year's Vault Focus:** Expand the Local-First Architecture MOC into a full technical book outline.

When to Use and When to Avoid

When to Use

• Conducting an annual or bi-annual health checkup on your personal knowledge vault.
• Repairing broken internal wikilinks and identifying disconnected orphan notes.
• Cleaning up bloated tag taxonomies and reorganizing PARA folder structures.
• Purging unused media attachments and optimizing disk storage.

When to Avoid

• Conducting daily or hourly note updates during active writing sessions.
• Managing short-term software sprint tasks.
• Writing spontaneous personal reflections or raw journal entries.
• Tracking financial invoices or receipts.

On-Device AI Integration

Audit knowledge vault health with Oyma on macOS:

Analyze the vault audit log and structural metrics:
1. Synthesize the before-and-after vault health scorecard table.
2. Outline the PARA reorganization steps and project archival actions.
3. Formulate the tag taxonomy consolidation mapping and broken link remediation.
4. Draft the executive reflection and establish structural goals for the coming year.
Output in clean, structured CommonMark.

Your private vault structure, audit data, and notes remain completely local on your Mac.