Workspace Hygiene Skill
Auto-maintains workspace cleanliness. Prevents context bloat that burns tokens on every session boot.
Triggers
- Cron: runs daily at 06:00 Europe/Berlin
- Manual: when Zinou says "clean up", "audit workspace", "hygiene check"
- Auto: after any session that creates 10+ files
Rules
1. BOOT FILE SIZE LIMITS (hard limits, enforce or trim)
- AGENTS.md: max 50 lines
- MEMORY.md: max 80 lines
- STATE.md: max 60 lines
- SOUL.md: no limit (identity, changes rarely)
- USER.md: max 40 lines
- IDENTITY.md: max 30 lines
- TOOLS.md: no limit (reference, not loaded often)
- HEARTBEAT.md: max 20 lines
If any file exceeds its limit:
- Identify bloat (action logs, duplicate info, stale references)
- Move old content to
memory/archive/YYYY-MM-DD-<topic>.md - Leave a 1-line pointer:
See archive/YYYY-MM-DD-<topic>.md - Log the trim in today's daily note
2. ROOT WORKSPACE RULES
- NO image/video files in workspace root →
archive/frames/orarchive/media/ - NO package.json/package-lock.json in root (belongs in subprojects)
- NO temp scripts in root →
/tmp/for those - NO .secrets in root → always in
talonforge/.secrets/ - Only .md files and directories allowed in workspace root
3. MEMORY/ RULES
- Only keep files actively needed this week
- Daily notes older than 3 days → archive (except today's)
- Stale files (not updated in 7+ days, not referenced by STATE.md) → archive
- Fragment daily notes (multiple per day) → consolidate into one
claude-task.md→ archive when >7 days stale, keep latest 500 lines- Never delete, always archive to
memory/archive/
4. AUTO-ARCHIVE PATTERNS
After any session:
- If temp files created in
/tmp/→ leave them (auto-cleaned) - If files created in workspace root → move to proper location
- If memory/ grows past 10 active files → audit for archiving
5. BLOAT SIGNALS (check for these)
- MEMORY.md action log >5 entries → consolidate to archive
- Same info in 2+ files → keep one, archive the other
- Files with "TODO" or "DRAFT" older than 3 days → flag or archive
- Empty files (<10 bytes) → delete
- Duplicate daily notes → merge
6. ARCHIVE STRUCTURE
memory/archive/
action-log-day1-3.md
day3-fragments/
frames/
media/
<date>-<topic>.md7. REPORT FORMAT
After each run, log to today's daily notes:
## Workspace Hygiene (HH:MM)
- Trimmed: X files, Y lines removed
- Archived: Z files
- Boot load: N lines (was M lines)
- Status: CLEAN / NEEDS ATTENTIONCron Setup
Run: 0 6 * * * (daily at 06:00 Europe/Berlin) This is a lightweight check — most days it does nothing. Only acts when bloat exists.