Workspace Heal

Workspace Heal checks file-based workspaces for broken links, stale indexes, unfinished setup, and instruction drift. It starts with a read-only report, follows the rules already present in the folder, and separates safe repairs from changes that need your judgment.

What does Workspace Heal check?

your-workspace/                     # The folder Workspace Heal reviews├── **/*.md                         # Local links and stale paths├── **/README.md                    # Indexes compared with files on disk├── AGENTS.md                       # Instructions checked for drift├── SETUP.md                        # Active setup markers checked├── generated files                 # Rebuild guidance checked when declared└── other folders                   # Reviewed against the workspace's own rules

• A clear health report groups findings by impact and includes exact file paths.
• Workspace-aware checks follow the folder's own guidance instead of imposing a new structure.
• A safe-fix split shows what can be repaired conservatively and what needs review.
• Coverage notes explain what was checked, excluded, or left incomplete.

What does Workspace Heal look like in practice?

Check a workspace before making changes

• You ask: "Check this workspace's health."
• The agent works from: The workspace README, agent instructions, local documentation indexes, links, setup markers, and any conventions the folder declares.
• You get: A health summary, the review scope, findings grouped by impact, and a clear split between safe fixes and decisions that need you.

Repair the safe structural issues

• You ask: "Fix the safe structural issues."
• The agent works from: The health report and the workspace's own rules for links, indexes, generated files, and instructions.
• You get: Confirmed repairs followed by a fresh check. Nothing is moved, renamed, or deleted without your approval.

How do you start a Workspace Heal check?

1. Install Workspace Heal from Marketplace in Palette Desktop.
2. Open the folder you want to review. No special setup or folder structure is required.
3. Ask your agent to check the workspace's health.

Palette Desktop creates a checkpoint before installation, so you can restore the folder if you want to start over.

What can you ask after installing Workspace Heal?

Check this workspace's health.             # start with a read-only report
Find broken links and stale indexes.       # focus the review
Fix the safe structural issues.            # apply conservative repairs
Why is this folder hard to navigate?       # find structural friction

company-os/├── accounts/       # customers, relationship health├── gtm/            # brand, playbooks, active work├── product/        # strategy, specs, feedback├── engineering/    # architecture, decisions, runbooks├── ops/            # finance, hiring, admin└── people/         # teammate context

project-os/├── overview.html   # generated status dashboard├── context/        # brief, goals, stakeholders├── meetings/       # notes and follow-ups├── decisions/      # numbered decision records├── deliverables/   # milestones, project outputs└── team/           # onboarding, ways of working

product-os/├── user-feedback/  # feedback, requests, pain points├── discovery/      # questions and learning plans├── strategy/       # durable product theses├── specs/          # paste-ready product briefs├── competitors/    # capability-focused profiles└── team-input/     # roadmap input and sync recaps