Initial commit - Claudesidian v0.2.0

Claude Code + Obsidian starter kit for AI-powered knowledge management. Features: - PARA method folder structure - Bootstrap initialization system - Pre-configured Claude Code commands and agents - Gemini Vision MCP server with video support - Helper scripts for vault management - Automated release management See README.md for setup instructions.
2025-09-13 12:20:50 -04:00
commit f609668172
45 changed files with 4776 additions and 0 deletions
@@ -0,0 +1,175 @@
+# 📎 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
+```markdown
+# 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.