Janitor

Janitor Skill

Clean the vault. Remove what's done. Keep it lean.

When to Run

• User says "clean", "janitor", "sweep", "tidy", or "clean up the vault"
• After a large ingest batch
• Periodically as maintenance

Procedure

Step 1 — Scan Tasks

Read every file in tasks/. Collect files where:

status: done
deletable: true

Step 2 — Verify Before Delete

For each candidate:

1. Read the task content
2. Check: does the useful information from this task already exist in a wiki/ page? Search only real pages — exclude index.md, hot.md and log.md.
   • YES → safe to delete
   • NO → extract the useful info, add it to the correct wiki page via the intake skill, THEN delete
   • UNCLEAR → flag it for user review, do not delete

🔴 The exclusion is the whole safety of this step. log.md records the filename of every file ingest creates, so a task called move-docs-site.md puts the words "move", "docs" and "site" into wiki/ the moment it is created. Match against the log and every task looks preserved, including ones whose content was never written down anywhere. index.md and hot.md fail the same way — they name pages, they do not contain them.

A filename is not information. Confirm the task's actual content — its objective and details — is readable in a real page. If the only hit is the page title or the log line, the answer is NO.

Step 3 — Orphan Sweep

Scan wiki/ for orphan pages:

• No inbound wikilinks from any other page
• No outbound wikilinks to any other page
• Not index.md, hot.md, or log.md

For each orphan:

• If content is still valuable → link it from a relevant page or index
• If content is stale/empty → flag for user review
• Never auto-delete wiki pages without explicit user approval

Step 4 — Inbox Check

If inbox/ has files that look already processed (duplicates of wiki content):

• Flag them, don't delete — user decides

Step 5 — Consolidation Pass

Look for wiki pages that cover the same topic:

• If two pages overlap significantly → flag for merge, suggest which to keep
• Do not auto-merge without approval

Step 6 — Report

After every run, output a summary:

JANITOR REPORT
--------------
Tasks deleted: X
Tasks flagged for review: X
Orphan pages found: X
Duplicates flagged: X
Inbox items flagged: X

Append a one-line summary to wiki/log.md. Update wiki/hot.md if anything changed.

Rules

• NEVER delete index.md, hot.md, log.md, any skill, or any template
• NEVER delete without verifying info is preserved elsewhere
• When verifying, NEVER count a hit in index.md, hot.md or log.md - those name pages, they do not contain them. A filename match is not preservation.
• When uncertain, FLAG — don't delete
• User can override with "delete all flagged" after reviewing
• Log every deletion to wiki/log.md