my-vault/05_Attachments/README.md

# Attachments

**Purpose:** Storage for all non-text files (images, PDFs, videos, audio).

## Organization

- **Root (05_Attachments/)** - Unprocessed attachments
- **Organized/** - Files that have been properly named and referenced

## Naming Convention

Use descriptive names that indicate the related note:
- `[RelatedNote]_[Description].[ext]`
- Example: `ProjectAlpha_Architecture_Diagram.png`
- Example: `BookNotes_Thinking_Fast_Slow_Cover.jpg`

## Helper Scripts

```bash
pnpm attachments:list        # List unprocessed files
pnpm attachments:organized   # Count organized files
pnpm attachments:orphans     # Find unreferenced files
pnpm attachments:update-links # Update links after moving
```

## Processing Workflow

1. Files initially land in `05_Attachments/`
2. Rename with descriptive names
3. Reference in notes using `![[filename.ext]]`
4. Move to `Organized/` subfolder
5. Update any links if paths change

## Tips

- Process attachments regularly (don't let them pile up)
- Use consistent naming patterns
- Delete duplicates and unused files
- Consider using Gemini Vision to analyze images