filing
π―Skillfrom spm1001/claude-suite
Processes files by extracting actions and context before moving, ensuring no important information or tasks are lost during file organization.
Part of
spm1001/claude-suite(4 items)
Installation
git clone https://github.com/spm1001/claude-suite ~/Repos/claude-suite./install.sh./install.sh --verify./install.sh --uninstallSkill Details
Orchestrates file cleanup with mandatory processing β reads content and extracts actions BEFORE moving files. Prevents lost waiting-fors and buried actions. MANDATORY during weekly review filing phase. Triggers on 'where should this go', 'help me tidy', 'clean up downloads', 'triage inbox'. (user)
Overview
# Filing
Help with file organization: where things belong and keeping inboxes clear.
When to Use
- "Where should this file go?"
- Weekly review (filing portion)
- Moving files between zones
- Deciding Projects vs Areas vs Resources
When NOT to Use
- Pattern reflection (use todoist-gtd)
- Todoist organization (use todoist-gtd)
- Code/repo organization (different rules apply)
Core Principle: Filing = Processing + Organizing
You can't file what you haven't processed.
Moving files without reading them isn't filing β it's relocating the problem. Proper filing means:
- Processing β Read content, extract what matters (actions, waiting-fors, calendar items)
- Organizing β Move to the right location with the right name
If you skip processing, actions get lost, waiting-fors vanish, and meeting notes become information graves.
The test: Before moving a file, can you answer: "What's in this and does anything need to happen?"
Work Folder Structure
Location: ~/Library/CloudStorage/GoogleDrive-*/My Drive/Work
To find exact path: ls -d ~/Library/CloudStorage/GoogleDrive-*/My\ Drive/Work
```
Work/
βββ Projects/ # Active outcome folders
βββ Areas/ # Ongoing responsibilities
βββ Resources/ # Reference material (Larder, GTD Resources)
βββ Archive/ # Completed/dormant
βββ Meeting Notes/ # By year (2015-2025)
```
Projects/
Active work with defined end states. Folders named: {Area} - {Outcome statement}
Examples:
Industry Influencing - Marketing Week ArticlesProduct Development - Launched new dashboard...
When complete: Move to Archive/
Areas/
Ongoing responsibilities (no completion date):
- Budget and Finance
- Cross-Broadcaster Measurement
- Desired Outcomes Planning
- Industry Advisory Roles
- Industry Influencing
- Internal Stakeholders
- Managing Myself
- Processes and Systems
- Team Development
Resources/
Reference material that supports work:
- Larder/ - 100+ research PDFs
- GTD Resources (Common)/ - GTD reference docs
Archive/
Completed projects and dormant materials. Preserves history.
Meeting Notes/
Organized by year:
```
Meeting Notes/
βββ 2024/
βββ 2025/
βββ 2025-12-11 Alex Maguire (Netflix) - EMEA measurement landscape.md
```
Naming: {date} {Person/Topic} - {Brief description}.md
PARA Quick Reference
| Category | Definition | Completion |
|----------|------------|------------|
| Projects | Active work with end state | Finite - move to Archive when done |
| Areas | Ongoing responsibilities | Infinite - never "done" |
| Resources | Reference material | Supports work, isn't the work |
| Archive | Inactive items | Superseded or completed |
Key distinction: Areas β Projects. "Team Development" is an Area (infinite). "Hire data scientist" is a Project (finite).
How This Differs from Strict PARA
Strict PARA has 4 equal categories (Projects, Areas, Resources, Archive).
This structure adds:
- Meeting Notes/ - Chronological organization by year (not in PARA)
- Areas are predefined (not emergent as in strict PARA)
Core PARA principle remains: Projects complete, Areas don't.
Why the additions: Meeting notes benefit from chronological access. Areas reflect actual work responsibilities.
Weekly Cleanup Zones
Nine locations where clutter accumulates:
1. Local Downloads
Path: ~/Downloads
Typical contents: PDFs, screenshots, installers, random files from web.
Action: File to Work/ or delete.
2. iCloud Downloads
Path: ~/Library/Mobile Documents/com~apple~CloudDocs/Downloads
Typical contents: Screenshots (iOS sync), files from iOS apps.
Action: File to Work/ or delete. Check for screenshots that should go to projects.
3. iA Writer Strays
Path: ~/Library/Mobile Documents/27N4MQEA55~pro~writer/Documents
Structure:
```
Documents/
βββ Diary/ # Structured diary entries (leave alone)
βββ [stray files] # Waifs outside Diary folder
```
Action: Anything outside Diary/ is a stray. File or delete.
4. Desktop (iCloud-synced)
Path: ~/Desktop
iCloud Desktop & Documents sync enabled. Files may be cloud-only (evicted from local storage).
Typical contents: Screenshots, drag-dropped files, temporary staging.
Action: File to Work/ or delete. Most Desktop items are transient.
iCloud voodoo: Files can appear as stubs (cloud-only, download on access). When bulk processing, may trigger downloads. The .localized file is system-managed - leave it.
5. Work Folder Root
Path: ~/Library/CloudStorage/GoogleDrive-*/My Drive/Work
Should only contain CLAUDE.md (project instructions) - nothing else belongs at root level.
Typical contents: Stray files that missed proper subfolder, CLAUDE.md.
Action: CLAUDE.md stays. Everything else gets filed into Projects/, Areas/, Resources/, or Archive/.
6. My Drive Root (Inbox)
Path: ~/Library/CloudStorage/GoogleDrive-*/My Drive
True inbox per PARA. Where doc.new creates files, where shared docs land, where quick-captured items accumulate.
Typical contents: New Google Docs, shared files, unsorted captures.
Action: Triage into Work/ subfolders or delete. This is the primary inbox to keep clear.
7. My Drive Temp (Claude Staging)
Path: ~/Library/CloudStorage/GoogleDrive-*/My Drive/Temp
Nominated temp folder for Claude operations β file uploads, MCP staging, transient outputs.
Typical contents: PDFs uploaded for analysis, intermediate files, staged outputs.
Action: Delete everything. If something needs keeping, it should have been filed properly after the session that created it. This folder should be empty between sessions.
8. Work Inbox (iCloud)
Path: ~/Library/Mobile Documents/com~apple~CloudDocs/Work Inbox/
Quick capture landing zone from iOS Shortcuts. Subfolders organize by type:
```
Work Inbox/
βββ Voice Transcripts/ β Whisper output from JPR recordings
βββ Meeting Notes/ β iOS Shortcut meeting captures
βββ Quick Notes/ β General quick capture
```
Naming: YYYY-MM-DD [HH-MM] Title.md
Action per subfolder:
| Subfolder | Triage |
|-----------|--------|
| Voice Transcripts/ | Review, extract actions, file to Meeting Notes/ or delete |
| Meeting Notes/ | Copy to Google Drive Meeting Notes/{year}/, keep original |
| Quick Notes/ | File to PARA, extract to Todoist, or delete |
9. JPR Voice Recordings
Path: ~/Library/Mobile Documents/iCloud~com~openplanetsoftware~just-press-record/Documents/
Just Press Record voice memos (m4a/mp3). Organized by date: YYYY-MM-DD/HH-MM-SS.m4a
Action:
- Transcribe with
~/.claude/scripts/transcribe-jpr.sh --new - Review transcript in Work Inbox/Voice Transcripts/
- Audio moves to
Processed/subfolder automatically
When Filing Signals Deeper Patterns
File organization chaos often symptoms deeper behavioral patterns. Surface these signals during weekly review:
| Signal | Pattern | Response |
|--------|---------|----------|
| Downloads >100 files OR >2 weeks neglect | Execution-Without-Reflection | "This backlog suggests rushing through tasks without processing. Want to check patterns?" |
| Multiple "temporary" folders >1 month old | Scope Creep | "These temp folders suggest projects expanding beyond original scope." |
Coordination pattern: Filing is Phase 1 of weekly review. After tidying, todoist-gtd skill handles pattern reflection (Phase 3).
Don't skip the pattern check just because you tidied the files.
Processing (Before You File)
Processing means reading and extracting β not just moving.
Processing Checklist (Meeting Notes)
Before filing ANY meeting note:
- [ ] Read the content β Don't just look at the title
- [ ] Extract actions (mine) β Concrete next steps I need to take
- [ ] Extract waiting-fors β
NAME: What they owe meformat - [ ] Note calendar items β Dates to add to calendar
- [ ] Quality check: empty? β Delete (with confirmation)
- [ ] Quality check: misnamed? β Rename to match content
- [ ] THEN move to destination
Mandatory extraction: Cannot file meeting notes until actions are extracted. This is not optional.
Processing Other File Types
| File Type | Processing Required |
|-----------|---------------------|
| Meeting notes | Full checklist above |
| Quick notes | Check for actions, then file or delete |
| Voice transcripts | Read transcript, extract actions, then file or delete |
| PDFs/docs | Understand content for proper filing location |
| Screenshots | Determine project context, file or delete |
Action Extraction Workflow (Sublime Loop)
When processing multiple meeting notes with actions:
1. Extract to Temp File
Create structured sections:
```markdown
Waiting For
NAME: What they owe me
Ping
Quick actions for me to do
Calendar
Date - Event to add
```
2. Open for Review
```bash
open -a "Sublime Text" /tmp/meeting-actions.md
```
3. Tell User
"Edit, save, let me know when ready"
User fixes:
- Names (Susie β Susan)
- Stale/irrelevant items (delete)
- Vague actions (clarify)
4. After Save
Read file, add to Todoist via todoist-gtd skill.
Why this works:
- User sees all actions at once
- Catches errors before they hit Todoist
- Disambiguation happens in familiar editor
- Claude processes clean, user-approved list
Meeting Source Discovery
At weekly review start, check beyond the 9 zones.
Standing Docs (Always Check)
Prompt first: "Any changes to this standing docs list? (Add/remove as your meetings evolve)"
| Doc | ID |
|-----|-----|
| MIT: Start the Week | 19NqCEPMSOdIdouFqVaHZVA-GyJmkmPjLGyNknTJpU3M |
| Client Reference | 1owM77DjcTwHjrTfHs9zEfQfNyeFfmtheokBGvkPD8II |
| Supplier Reference | 1b2vaWpGx-fUj48vuQ0KmIirDu5loodC7F4j3XGV4_DU |
| Notes β WEEKLY senior team catch up | 1B5X-MrSzldgFElppNlk4s_PDgpIJ0H5Sul74uqQnTs8 |
| TVA/MP/ITV Status | 1tCuph3QWiObYImjb-7nfPPI2Q-D2RjAtou-dceHa45c |
Calendar-Linked Docs
Prompt: "What recurring meetings had sessions this week? Any have running docs I should check?"
(Future: mise calendar integration to auto-discover β see mise-en-space backlog)
Filing Decisions
"Where does this go?"
| If it's... | Put it in... |
|------------|--------------|
| Active project artifact | Projects/{relevant project}/ |
| Meeting notes | Meeting Notes/{year}/ |
| Reference PDF/doc | Resources/Larder/ or relevant Resources subfolder |
| Completed project | Archive/ |
| Ongoing area doc | Areas/{relevant area}/ |
| Screenshot for project | Projects/{project}/ or delete |
| Random download | Delete or file if valuable |
Personal Documents Zone
Path: ~/Documents/Personal/
Personal documents with PARA structure (no numbering, aligned with Work folder):
```
Personal/
βββ Projects/ # Active personal projects
βββ Areas/ # Ongoing personal responsibilities (e.g., Ash)
βββ Archive/ # Completed/dormant
βββ CLAUDE.md # Project instructions
```
Note: No Resources folder - personal "resources" live in Areas as active things.
Action: Personal admin docs (scanned letters, etc.) go to appropriate Area.
Team Shared Drives
Detection: ls "$GDRIVE/Shared drives/"
Team shared content lives in Shared Drives (not personal My Drive):
```
Team Shared Drive/
βββ Team Reference/ # Team-specific reference material
βββ Shared Reference/ # Cross-team reference material
βββ External Reference/ # External/industry reference
```
Action: Team reference materials (shared tools, analytics) go here, not personal Drive.
Filing Workflow
Zone Check (Do This First)
At session start, explicitly check ALL zones - don't skip any:
```bash
GDRIVE=$(ls -d ~/Library/CloudStorage/GoogleDrive-* 2>/dev/null | head -1)
echo "=== 1. Downloads ===" && ls ~/Downloads | head -5
echo "=== 2. iCloud Downloads ===" && ls ~/Library/Mobile\ Documents/com~apple~CloudDocs/Downloads 2>/dev/null | head -5
echo "=== 3. iA Writer ===" && ls ~/Library/Mobile\ Documents/27N4MQEA55~pro~writer/Documents 2>/dev/null | grep -v Diary | head -5
echo "=== 4. Desktop ===" && ls ~/Desktop 2>/dev/null | head -5
echo "=== 5. Work root ===" && ls "$GDRIVE/My Drive/Work" 2>/dev/null | grep -v "^CLAUDE.md$" | head -5
echo "=== 6. My Drive root ===" && find "$GDRIVE/My Drive" -maxdepth 1 -type f ! -name ".DS_Store" 2>/dev/null | head -5
echo "=== 7. My Drive Temp ===" && ls "$GDRIVE/My Drive/Temp" 2>/dev/null | head -5
echo "=== 8. Work Inbox ===" && find ~/Library/Mobile\ Documents/com~apple~CloudDocs/Work\ Inbox -type f ! -name ".DS_Store" 2>/dev/null | head -5
echo "=== 9. JPR Voice ===" && find ~/Library/Mobile\ Documents/iCloud~com~openplanetsoftware~just-press-record/Documents -name ".m4a" -o -name ".mp3" 2>/dev/null | grep -v "/Processed/" | head -5
```
Report which zones have content before starting. Don't skip zones that look empty - verify each one.
Per-File Process (5 Steps)
When triaging files, follow this 5-step process:
- Process - Read content, extract what matters
- For meeting notes: extract actions, waiting-fors, calendar items (see Processing section)
- For other files: understand content for proper filing
- Use Sublime Loop for batch processing multiple notes
- For text files: Claude reads directly
- For binary/GUI files: open -a "Sublime Text" file.md or open file.pdf
- Office files in Google Drive (.docx, .xlsx, .pptx): These open in native apps (Word, Excel, PowerPoint), not browser. To open in Google Docs instead, fetch the Drive URL via mise and open that:
```bash
# Don't do this (opens in Word):
open "My Drive/document.docx"
# Do this instead (opens in browser):
# 1. Get file ID via mise search
# 2. open "https://docs.google.com/document/d/FILE_ID"
```
Or flag to user: "These .docx files will open in Word β want Drive URLs instead?"
- Rename - Adjust filename to match actual content
- Generic names like "Untitled" or "Copy of..." need proper names
- Use descriptive names: Simon McCarthy - Pricing Power Proposal
- Split - If multiple topics in one file, separate them
- Open in GUI for user review
- Create new files for distinct topics
- Capture - Outstanding actions β Todoist
- Before adding: Search for existing/completed tasks to avoid duplicates
- Use todoist-gtd skill (invoke with Skill(todoist-gtd)) for Todoist operations
- Link description to filed document
- File - Move to correct location (or delete)
- See "Filing Decisions" section for where things go
- After filing Meeting Notes: Extract to memory for searchability
```bash
# Re-scan to pick up the filed document
cd ~/Repos/claude-mem && uv run mem scan --source local_md
# Extract entities from the filed document
SOURCE_ID="local_md:$(basename "$DEST_PATH")"
cd ~/Repos/claude-mem && uv run mem extract "$SOURCE_ID" 2>/dev/null || true
```
Archive vs Reference
The test: "Will I search for this to USE it, or just to REMEMBER it?"
| Answer | Location | Examples |
|--------|----------|----------|
| USE it | Resources/ | Methodology docs, templates, how-to guides |
| REMEMBER it | Archive/ | Completed project artifacts, old meeting notes |
Reference = I'll need this again to do work
- Research PDFs that inform decisions
- Templates I reuse
- Product specs, methodology docs
Archive = This was a thing, now it's done
- Completed project artifacts
- Superseded versions
- Historical records
Common Filing Patterns
External doc β Google Doc β Project folder
When filing a document that needs to live in a Project:
- Read content (use docx skill for Word docs)
- Create Project folder if needed:
{Area} - {Outcome statement} - Convert to Google Doc:
mcp__mise__create - Delete original file
- Update any Todoist task that references it with new link
Todoist task linking
When a filed document relates to a Todoist task, use the todoist-gtd skill to search and link. Canonical document location should be in Todoist task description.
Weekly Review Integration
Note: Weekly review is a three-phase workflow orchestrated by todoist-gtd skill:
- Filing (this skill) β Clear cleanup zones
- Outcomes Review (todoist-gtd) β Check outcome health
- Pattern Reflection (todoist-gtd) β Freedom score, pattern interrupts
During weekly review, check all 9 cleanup zones:
- ~/Downloads - File or delete
- iCloud Downloads - File or delete
- iA Writer strays - File or delete
- ~/Desktop - File or delete (mind iCloud stubs)
- Work/ root - Only CLAUDE.md should remain
- My Drive root - Triage into Work/ or delete
- My Drive Temp - Delete everything (Claude staging folder)
- Work Inbox - Triage subfolders (Voice Transcripts, Meeting Notes, Quick Notes)
- JPR Voice - Transcribe new recordings, review transcripts
Anti-Patterns
| Pattern | Problem | Fix |
|---------|---------|-----|
| File without reading | Actions lost | Mandatory processing first |
| Bulk move meeting notes | Waiting-fors vanish | Use Sublime Loop, extract first |
| Skip running docs | Miss recurring meeting actions | Check standing docs + calendar prompt |
| Skip zones during weekly review | Clutter accumulates | Check ALL 9 zones explicitly |
| Keep "just in case" | Folders bloat | Delete liberally, most things don't need keeping |
| File without renaming | Untitled docs pile up | Rename to content-descriptive name first |
| Skip Todoist search before adding | Duplicate tasks | Always search for existing task first |
Remember
File promptly, delete liberally. Most downloads don't need keeping. Screenshots are usually transient. When in doubt, delete.
Projects complete, Areas don't. If you're wondering "is this done?", it's probably a Project. If you're wondering "is this still my responsibility?", it's an Area.
~/Repos Naming Convention
Development tools live in ~/Repos/ with prefix conventions:
| Prefix | Contains | Example |
|--------|----------|---------|
| claude-suite | Core session skills | session-opening, beads, filing |
| skill-* | Specialized skills | skill-itv-styling |
| mcp-* | MCP servers | mcp-workspace |
| infra-* | Infrastructure | infra-openwrt |
| claude-* | Claude experiments | claude-memory |
Skills: Symlinked to ~/.claude/skills/. Core skills in claude-suite/skills/, specialized skills in individual repos, skills with tooling co-located with their infrastructure.
More from this repository3
Generates professional diagrams and visual explanations using SVG, rendering to PNG with iterative self-critique and brand-aware styling.
Installs behavioral skills from claude-suite via symlinks, creating essential directories and offering optional tool repositories.
I apologize, but I cannot generate a description without seeing the actual code or having more context about the "skill-check" skill from the repository. Could you provide me with more details abou...