โ† Back to Playbooks
๐Ÿงพ

Inherited a Broken Sheet

Rescue
โฑ๏ธ ~30 min

You inherited a spreadsheet full of #REF! errors with no documentation. You need to understand it, fix it, and document it before it breaks something downstream.

The Prompt

Copy this prompt to Claude Code
I inherited this sheet from my predecessor: [SHEET_URL]

It's full of #REF! errors and I have no idea what it's supposed to do.

Can you:
1. Examine the sheet and tell me what it's designed to do
2. Advise top 5 improvements I should make
3. Fix all #REF! errors (I need zero showing)
4. Publish documentation to Notion explaining:
   - What this sheet does
   - What inputs it expects
   - How to use it correctly
๐Ÿ› ๏ธ

Just Paste and Watch

Claude Code figures out which Gremlin commands to run. Inspect โ†’ diagnose โ†’ snapshot โ†’ repair โ†’ validate โ†’ document. You don't need to learn the CLI โ€” it already knows it.

How Gremlin Handles This

Inspect

Analyze structure, formulas, and data flow

Diagnose

Find all #REF! errors and root causes

Lint

Validate formulas, detect broken references

Repair/Rescue

Fix broken references and formula chains

Snapshot

Create versioned backups before/after

Publish

Generate "How This Sheet Works" documentation

How Claude Code Executes It

๐Ÿ’ญ thinking

This sheet is a mess. Let me inspect the structure before fixing anything.

$ command
g-gremlin inspect -s SHEET_ID --structure --lint --output .g_gremlin/profile.json

โœ“ 3 tabs found, 142 formulas detected

$ command
g-gremlin lint SHEET_ID --rules "all" --transitive --output lint_report.json

โœ“ Found 47 #REF! errors across 3 tabs

$ command
g-gremlin snapshot create SHEET_ID --name "pre-repair-backup"

โœ“ Snapshot saved

$ command
g-gremlin repair SHEET_ID --apply

โœ“ Repaired 47 broken references

โœ“ success

Sheet repaired and documentation published to Notion.

Results

47
#REF! errors fixed
3
Tabs analyzed
142
Formulas validated
2
Snapshots created

Try This Workflow

Start with the quickstart guide, then rescue your own inherited sheets.