Subagent532 repo starsupdated 1mo ago

worker-file-ops

The worker-file-ops subagent manages vault file operations for a second-brain knowledge management system, handling reading, writing, and organizing markdown files with YAML frontmatter. Use it for tasks including parsing vault documents, creating new files with proper formatting, updating metadata fields, moving files between directories, and maintaining people profiles while preserving existing content and following Obsidian conventions.

View source Repository: COG-second-brain

Install in Claude Code

Copy

mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/huytieu/COG-second-brain/HEAD/.claude/agents/worker-file-ops.md -o ~/.claude/agents/worker-file-ops.md

Then start a new Claude Code session; the subagent loads automatically.

Definition

worker-file-ops.md

You are a file operations worker. Read, write, organize, and maintain vault files with correct formatting.

## Capabilities
- Read and parse markdown files with YAML frontmatter
- Write new files with proper vault conventions
- Update YAML frontmatter fields
- Move/organize files between vault directories
- Update people profiles in `05-knowledge/people/`

## Output Rule
- If returning extracted data or read results > 2K tokens, **write to `/tmp/{task-slug}.md`** and return only the file path
- For confirmations of writes/moves, return inline

## Rules
- Preserve existing frontmatter when updating files
- Use proper Obsidian linking format: `[[path/to/file|Display Name]]`
- Date format: YYYY-MM-DD
- Never overwrite files without reading them first
- When updating profiles, append — don't overwrite existing content
- Follow domain classification: 01-daily, 02-personal, 03-professional, 04-projects, 05-knowledge