my-vault/05_Attachments/README.md

📎 Attachments

Storage for images, PDFs, and other non-text files.

Purpose

Centralized location for:

• Images and screenshots
• PDFs and documents
• Spreadsheets and data files
• Audio and video files
• Any binary files referenced in notes

Organization

05_Attachments/
├── Organized/          # Processed files with good names
│   ├── Images/
│   ├── PDFs/
│   └── Data/
├── IMG_*.png          # Unprocessed phone images
├── Screenshot*.png    # Unprocessed screenshots
├── CleanShot*.png    # Unprocessed CleanShot files
└── *.pdf             # Various PDFs

Naming Conventions

Before Processing

• IMG_1234.png (from phone)
• Screenshot 2024-03-15 at 2.30.45 PM.png
• CleanShot 2024-03-15 at 14.30.45.png
• document(1).pdf

After Processing

• 2024-03-15_Project_Architecture_Diagram.png
• 2024-03-15_Meeting_Whiteboard.jpg
• API_Documentation_v2.pdf
• Customer_Interview_Transcript.pdf

Helper Scripts

Run these with pnpm:

Viewing Status

• attachments:list - List unprocessed files
• attachments:count - Count unprocessed files
• attachments:organized - Count organized files
• attachments:sizes - Show largest files
• attachments:recent - Files added in last 7 days

Finding Issues

• attachments:orphans - Files not referenced anywhere
• attachments:refs [filename] - Find references to file

Organization

• attachments:create-organized - Create Organized folder

Claude Code Workflows

Process Screenshots

Look at recent screenshots in 05_Attachments.
Based on their content, suggest better names.
Help me organize them.

Find Orphans

Find all attachments not referenced in any notes.
Should any be deleted?

Rename Batch

Review unprocessed images in Attachments.
Suggest descriptive names based on content.

Clean Up

Find duplicate images in Attachments.
Find files over 10MB.
What can be compressed or removed?

Best Practices

File Sizes

• Keep images under 2MB for Git
• Compress large PDFs
• Use external storage for video
• Optimize images before committing

Naming

• Include date: YYYY-MM-DD
• Be descriptive but concise
• Use underscores not spaces
• Include version numbers if relevant

Linking

# Embedding images
![[05_Attachments/Organized/diagram.png]]

# Linking PDFs
[[05_Attachments/Organized/document.pdf]]

# With descriptions
![[05_Attachments/Organized/chart.png|Sales Chart Q1]]

Processing Workflow

1. Capture: Save files to 05_Attachments/
2. Review: Look at content, determine purpose
3. Rename: Give descriptive, dated name
4. Organize: Move to Organized/ subfolder
5. Link: Update references in notes
6. Clean: Remove orphaned files

Claude Code Prompts

Vision Analysis

Analyze the images in Attachments.
What do they contain?
Suggest appropriate names and organization.

Bulk Processing

Process all CleanShot files from this week.
Rename based on content.
Move to Organized.

Storage Audit

Analyze attachment storage:
- Total size
- Largest files
- File type distribution
- Orphaned files

Tips

• Process weekly - Don't let files pile up
• Name immediately - Context fades fast
• Link purposefully - Only embed what adds value
• Compress aggressively - Storage adds up
• Delete liberally - Not every screenshot matters

Git Considerations

.gitignore suggestions

*.mp4
*.mov
*.zip
.DS_Store
files_over_10mb/

For Large Files

• Use Git LFS for files over 10MB
• Consider external storage
• Link to cloud storage instead
• Keep local but gitignore

Remember

Attachments support your notes, they don't replace them. A well-named, well-organized attachment is worth a thousand random screenshots. Use Claude Code's vision capabilities to help process and organize visual content efficiently.