Skills

Defrag

Weekly vault defragmentation.

Install

npx skills add gnekt/My-Brain-Is-Full-Crew --skill defrag -g -a claude-code -y
Category
Engineering
Updated
4mo ago
License
See repository
Context cost
Mediumabout 1,949 tokens
Runs scripts
No, instructions only

What it does

Weekly vault defragmentation. Runs a 5-phase structural audit: inbox hygiene, area completeness, project archival, MOC refresh, tag consistency, structure evolution, and generates a report. Triggers: EN: "defragment the vault", "reorganize the vault", "structural maintenance", "vault defrag", "weekly defrag". IT: "deframmenta il vault", "riorganizza il vault", "manutenzione strutturale", "defrag settimanale". FR: "defragmenter le vault", "reorganiser le vault". ES: "desfragmentar el vault", "reorganizar el vault". DE: "Vault defragmentieren", "Vault reorganisieren". PT: "desfragmentar o vault", "reorganizar o vault".

Vault Path Resolution

Read Meta/vault-map.md (always this literal path) to resolve folder paths. Parse the YAML frontmatter: each key is a role, each value is the actual folder path. Substitute only the vault-role tokens listed in the table below, do NOT substitute other {{...}} patterns (like {{date}}, {{Name}}, {{YYYY}}, {{ISO timestamp}}, {{today}}, {{Area Name}}, etc.), which are template placeholders.

If vault-map.md is absent: warn the user once, "No vault-map.md found, using default paths", then use these defaults:

TokenDefault
{{inbox}}00-Inbox
{{projects}}01-Projects
{{areas}}02-Areas
{{resources}}03-Resources
{{archive}}04-Archive
{{templates}}Templates
{{moc}}MOC
{{meta}}Meta

If vault-map.md is present but a role is missing: warn the user, "vault-map.md does not define [role]. What folder should I use?", and wait for their answer before proceeding.


Weekly Vault Defragmentation

You are executing the Architect's weekly vault defragmentation workflow. This is a structural operation, not a quality audit (that is the Librarian's job). You scan the vault's organizational skeleton, fix structural gaps, evolve the layout, and produce a comprehensive report.

Golden Rule: Language

Always respond to the user in their language. Match the language the user writes in. This skill file is written in English for universality, but your output adapts to the user.


Post-it Protocol

At the START of execution

Read {{meta}}/states/architect.md (if it exists). If it contains an active defrag flow, resume from the recorded phase, do NOT restart from Phase 1.

At the END of execution

Write (or overwrite) {{meta}}/states/architect.md with:

---
agent: architect
last-run: "{{ISO timestamp}}"
---

## Post-it
Read the whole SKILL.md on GitHub

More in Engineering