Commit 4e029c0305c0

@@ -0,0 +1,388 @@
+# Add TODO Workflow
+
+## Purpose
+Add new TODO items to inbox.org or directly to todos.org sections.
+
+## When to Use
+- User wants to create a new TODO
+- Capturing a task or action item
+- Adding follow-up work
+- Creating project tasks
+
+## Decision: Inbox vs Direct
+
+### Add to Inbox (Recommended for most cases)
+Use inbox.org when:
+- Quick capture during work
+- Not sure which section it belongs to
+- Want to process later
+- Batch capturing multiple items
+
+### Add Directly to Section
+Use todos.org directly when:
+- Clear which section (Work, Systems, Projects, Personal)
+- Part of existing project
+- Well-defined task with all details
+
+## Quick Add to Inbox
+
+### Basic Format
+```org
+* TODO <description>
+```
+
+### With Priority
+```org
+* TODO [#2] <description>
+```
+
+### With Context
+```org
+* TODO <description>
+:PROPERTIES:
+:CREATED:       [<current-date>]
+:END:
+
+<additional context or notes>
+```
+
+## Add Directly to Section
+
+### 1. Identify the Correct Section
+
+**Work Section** (`* Work`):
+- Job-related tasks
+- Upstream work
+- Team collaboration
+- Work meetings prep
+
+**Projects Section** (`* Projects`):
+- New projects or features
+- Multi-step initiatives
+- Both work and personal projects
+
+**Systems Section** (`* Systems`):
+- Homelab tasks
+- Infrastructure changes
+- NixOS configuration
+- Network setup
+
+**Personal Section** (`* Personal`):
+- Life admin
+- Appointments
+- Personal errands
+
+**Routines Section** (`* Routines`):
+- Recurring meetings
+- Regular check-ins
+- Habit tracking
+
+**Health Section** (`* Health`):
+- Health appointments
+- Exercise tracking
+- Medical tasks
+
+### 2. Choose the Right State
+
+- **TODO**: Default for new tasks
+- **NEXT**: If it's the next action to take
+- **WAIT**: If waiting on something/someone
+
+### 3. Set Priority (Optional)
+- `[#1]` - Highest/Most important
+- `[#2]` - High priority
+- `[#3]` - Medium priority
+- `[#4]` - Low priority
+- `[#5]` - Lowest priority
+
+### 4. Add Scheduling (Optional)
+
+**SCHEDULED**: When to start
+```org
+SCHEDULED: <2025-12-05 Fri>
+```
+
+**DEADLINE**: When it must be done
+```org
+DEADLINE: <2025-12-10 Wed>
+```
+
+**Repeating**: For recurring tasks
+```org
+SCHEDULED: <2025-12-08 Mon ++1w>
+```
+
+## Templates
+
+### Simple TODO
+```org
+** TODO <description>
+```
+
+### TODO with Priority
+```org
+** TODO [#2] <description>
+```
+
+### TODO with Scheduling
+```org
+** TODO <description>
+SCHEDULED: <2025-12-05 Fri>
+```
+
+### TODO with Context
+```org
+** TODO [#3] <description>
+:PROPERTIES:
+:CREATED:       [2025-12-04 Thu 15:30]
+:CATEGORY: work
+:END:
+
+<background information>
+<links to relevant resources>
+```
+
+### Project with Subtasks
+```org
+** TODO <project-name> [0/3]
+:PROPERTIES:
+:CREATED:       [2025-12-04 Thu 15:30]
+:END:
+
+*** TODO First subtask
+*** TODO Second subtask
+*** TODO Third subtask
+```
+
+### Recurring Task
+```org
+** TODO <description>
+SCHEDULED: <2025-12-08 Mon ++1w>
+:PROPERTIES:
+:STYLE:    habit
+:LAST_REPEAT: [2025-12-01 Mon 13:40]
+:END:
+```
+
+## Workflow Steps
+
+### Using Inbox (Quick Capture)
+
+1. **Open inbox.org**
+   ```bash
+   # Location: ~/desktop/org/inbox.org
+   ```
+
+2. **Add Entry**
+   ```bash
+   # Append to end
+   echo "* TODO Fix authentication bug" >> ~/desktop/org/inbox.org
+   ```
+
+3. **Refile Later**
+   - During daily review
+   - Use Refile workflow
+   - Move to appropriate section
+
+### Direct Add to Section
+
+1. **Read Current Section**
+   ```bash
+   # Example: Read Work section
+   sed -n '/^\* Work/,/^\* [A-Z]/p' ~/desktop/org/todos.org | tail -20
+   ```
+
+2. **Find Insertion Point**
+   - After section header
+   - Before archived items
+   - Near related TODOs
+
+3. **Format the Entry**
+   - Use ** for level-2 heading
+   - Add state (TODO, NEXT)
+   - Add priority if needed
+   - Add properties if needed
+   - Add scheduling if needed
+
+4. **Insert Entry**
+   Use Edit tool to add at appropriate location
+
+## Examples
+
+### Example 1: Quick Inbox Capture
+User asks: "Add a todo to review the upstream PR #123"
+
+```bash
+# Add to inbox
+echo "* TODO Review upstream PR #123
+
+https://github.com/org/repo/pull/123
+" >> ~/desktop/org/inbox.org
+```
+
+### Example 2: Direct Work TODO
+User asks: "Add a high priority work task to update documentation by Friday"
+
+Find Work section, then insert:
+```org
+** TODO [#2] Update project documentation
+DEADLINE: <2025-12-05 Fri>
+:PROPERTIES:
+:CREATED:       [2025-12-04 Thu 15:30]
+:CATEGORY: work
+:END:
+
+Update getting started guide and API reference
+```
+
+### Example 3: System Configuration Task
+User asks: "Add a todo to configure MQTT on rhea"
+
+Find Systems section, then insert:
+```org
+** TODO [#3] Setup MQTT broker on rhea
+:PROPERTIES:
+:CREATED:       [2025-12-04 Thu 15:30]
+:CATEGORY: systems
+:END:
+
+- Install mosquitto
+- Configure authentication
+- Setup firewall rules
+```
+
+### Example 4: New Project with Subtasks
+User asks: "Create a project for keyboard firmware improvements"
+
+Find Projects section, then insert:
+```org
+** TODO Keyboard firmware improvements [0/3]
+
+*** TODO Implement leader keys
+SCHEDULED: <2025-12-05 Fri>
+
+*** TODO Standardize nav/media/mouse layers
+
+*** TODO Add combos for common symbols
+```
+
+### Example 5: Recurring Meeting
+User asks: "Add weekly 1:1 meeting every Monday at 10am"
+
+Find Routines section, then insert:
+```org
+** STRT Weekly 1:1 with Manager
+SCHEDULED: <2025-12-08 Mon 10:00 ++1w>
+:PROPERTIES:
+:LAST_REPEAT: [2025-12-01 Mon 10:00]
+:CATEGORY: work
+:END:
+
+Meeting notes: <link-to-notes>
+```
+
+## Tips
+
+1. **Default to inbox**: When in doubt, add to inbox and refile later
+2. **Keep it brief**: You can add details when you start working on it
+3. **Link resources**: Add URLs, file links immediately while you remember
+4. **Set realistic dates**: Don't over-schedule
+5. **Use NEXT sparingly**: Only for truly next actions
+6. **Break down large tasks**: Create projects with subtasks
+7. **Add creation date**: Helps track how long tasks sit
+8. **Use categories**: Makes filtering and agenda views easier
+
+## Common Patterns
+
+### From Email/Message
+"Add a todo to follow up with Alice about the deployment"
+```org
+* TODO Follow up with Alice about deployment
+:PROPERTIES:
+:CREATED:       [2025-12-04 Thu 15:30]
+:END:
+
+Context from email: <paste relevant part>
+```
+
+### From Code Review
+"Add a todo to refactor the authentication module"
+```org
+* TODO Refactor authentication module
+:PROPERTIES:
+:CREATED:       [2025-12-04 Thu 15:30]
+:CATEGORY: work
+:END:
+
+See PR comments: https://github.com/org/repo/pull/456
+```
+
+### From Meeting
+"Add a todo to prepare slides for next week's presentation"
+```org
+* TODO Prepare presentation slides
+DEADLINE: <2025-12-10 Wed>
+:PROPERTIES:
+:CREATED:       [2025-12-04 Thu 15:30]
+:CATEGORY: work
+:END:
+
+Topics to cover:
+- Project overview
+- Timeline
+- Next steps
+```
+
+### From Note
+"Add a todo based on this learning note"
+```org
+* TODO Apply learned Rust patterns to auth module
+:PROPERTIES:
+:CREATED:       [2025-12-04 Thu 15:30]
+:END:
+
+From: [[file:~/desktop/org/notes/20251203T160000--learning-rust-ownership__learning_rust.org][Learning Rust Ownership]]
+```
+
+## Integration
+
+### With Git Workflow
+After committing, create follow-up task:
+```bash
+last_commit=$(git log -1 --oneline)
+echo "* TODO Test changes from $last_commit" >> ~/desktop/org/inbox.org
+```
+
+### With Notes
+Reference TODO in note:
+```org
+* Implementation
+
+TODO created: [[file:~/desktop/org/todos.org::*Implement feature X][Implement feature X]]
+```
+
+### With Calendar
+Convert calendar event to TODO:
+```org
+** TODO Prepare for team meeting
+SCHEDULED: <2025-12-05 Fri 09:00>
+```
+
+## Validation
+
+Before adding, check:
+- [ ] Clear, actionable description
+- [ ] Appropriate section (or inbox)
+- [ ] Priority set if urgent
+- [ ] Scheduling if time-sensitive
+- [ ] Links to context/resources
+- [ ] Not a duplicate
+
+## Next Steps
+
+After adding TODO:
+1. If added to inbox → Plan to refile during review
+2. If high priority → Consider marking as NEXT
+3. If urgent → Set SCHEDULED or DEADLINE
+4. If part of project → Link to project heading
+5. If needs research → Link to relevant notes

@@ -0,0 +1,365 @@
+# Archive TODO Workflow
+
+## Purpose
+Move completed (DONE) and cancelled (CANX) TODOs to archive sections to keep the main view clean.
+
+## When to Use
+- After marking tasks as DONE
+- During weekly review
+- When sections get cluttered
+- Before starting new work phases
+
+## Archive Structure
+
+Each main section has its own archive:
+
+| Section | Archive Location |
+|---------|------------------|
+| Work | `archive/work::` |
+| Projects | `archive/projects::` |
+| Systems | `archive/systems::` |
+| Personal | `archive/personal::` |
+| Routines | `archive/routines::` |
+| Health | `archive/health::` |
+| Appointments | `archive/appointments::` |
+
+Archive is defined in the section's PROPERTIES:
+```org
+* Work
+:PROPERTIES:
+:ARCHIVE:  archive/work::
+:CATEGORY: work
+:END:
+```
+
+## What to Archive
+
+### Always Archive
+- ✅ TODOs marked as DONE
+- ✅ TODOs marked as CANX
+- ✅ Completed subtasks of projects
+- ✅ Past recurring events (older than 2 weeks)
+
+### Sometimes Archive
+- ⚠️ Old WAIT tasks (if no longer relevant)
+- ⚠️ Stale TODOs (created >3 months ago, never started)
+
+### Never Archive
+- ❌ Active TODOs (TODO, NEXT, STRT, WAIT)
+- ❌ Recent recurring tasks
+- ❌ Project headers with active subtasks
+
+## Archive Workflow
+
+### Manual Archive (Emacs)
+If using Emacs with org-mode:
+```
+1. Position cursor on DONE/CANX heading
+2. Press C-c C-x C-a (org-archive-subtree)
+3. Item moves to archive file
+```
+
+### Manual Archive (Command Line)
+
+#### Find Completed Items
+```bash
+# Find DONE items in Work section
+sed -n '/^\* Work/,/^\* Projects/p' ~/desktop/org/todos.org | \
+  grep -B5 "^** DONE"
+
+# Find CANX items in Work section
+sed -n '/^\* Work/,/^\* Projects/p' ~/desktop/org/todos.org | \
+  grep -B5 "^** CANX"
+```
+
+#### Archive Process
+1. **Read the item** (with properties and notes)
+2. **Determine archive location** (based on section)
+3. **Copy to archive file** with structure
+4. **Remove from todos.org**
+
+### Batch Archive
+
+#### Weekly Archive Script
+```bash
+#!/bin/bash
+# Archive all DONE and CANX from last 7+ days
+
+# This is a manual process - identify items and archive them
+echo "=== Items to Archive ==="
+echo ""
+echo "DONE items:"
+grep -B2 "^** DONE" ~/desktop/org/todos.org | \
+  grep "CLOSED:" | \
+  grep -v "$(date +%Y-%m-%d)"
+echo ""
+echo "CANX items:"
+grep -B2 "^** CANX" ~/desktop/org/todos.org | \
+  grep "CLOSED:" | \
+  grep -v "$(date +%Y-%m-%d)"
+```
+
+## Archive File Structure
+
+Archive files follow the pattern:
+```
+~/desktop/org/archive/<section>.org
+```
+
+Example: `~/desktop/org/archive/work.org`
+
+### Archive File Format
+```org
+#+title: Work Archive
+#+category: work
+
+* Archived Tasks
+
+** DONE [#2] Review upstream pull request
+CLOSED: [2025-12-04 Thu 15:30]
+:PROPERTIES:
+:CREATED:       [2025-11-15 Mon 10:00]
+:CATEGORY: work
+:ARCHIVE_TIME: 2025-12-05 Fri 09:00
+:ARCHIVE_FILE: ~/desktop/org/todos.org
+:ARCHIVE_OLPATH: Work
+:END:
+:LOGBOOK:
+- State "DONE"       from "NEXT"       [2025-12-04 Thu 15:30]
+:END:
+
+Reviewed and approved upstream PR #123
+
+** CANX Setup alternative CI system
+CLOSED: [2025-12-03 Wed 10:00]
+:PROPERTIES:
+:CREATED:       [2025-10-15 Wed 15:00]
+:CATEGORY: work
+:ARCHIVE_TIME: 2025-12-05 Fri 09:00
+:ARCHIVE_FILE: ~/desktop/org/todos.org
+:ARCHIVE_OLPATH: Work
+:END:
+:LOGBOOK:
+- State "CANX"       from "TODO"       [2025-12-03 Wed 10:00] \\
+  Decided to stick with current CI
+:END:
+```
+
+## Archive Properties
+
+When archiving, preserve and add:
+
+**Original Properties**:
+- CREATED - when TODO was created
+- CATEGORY - section category
+- All LOGBOOK entries
+
+**Archive Properties** (added):
+- ARCHIVE_TIME - when archived
+- ARCHIVE_FILE - source file
+- ARCHIVE_OLPATH - original section path
+
+## Examples
+
+### Example 1: Archive Single DONE Item
+
+**In todos.org** (Work section):
+```org
+** DONE [#2] Fix authentication bug
+CLOSED: [2025-12-04 Thu 15:30]
+:PROPERTIES:
+:CREATED:       [2025-11-20 Thu 10:00]
+:CATEGORY: work
+:END:
+:LOGBOOK:
+- State "DONE"       from "STRT"       [2025-12-04 Thu 15:30]
+:END:
+
+Fixed null pointer in validation
+```
+
+**After archiving**:
+1. Copy entire entry to `~/desktop/org/archive/work.org`
+2. Add ARCHIVE_* properties
+3. Remove from todos.org Work section
+
+### Example 2: Archive Completed Project
+
+**In todos.org** (Projects section):
+```org
+** DONE Keyboard firmware improvements [3/3]
+CLOSED: [2025-12-04 Thu 15:30]
+
+*** DONE Leader key implementation
+CLOSED: [2025-11-25 Tue 10:00]
+
+*** DONE Nav/media layer standardization
+CLOSED: [2025-12-02 Mon 14:00]
+
+*** DONE Symbol combos
+CLOSED: [2025-12-04 Thu 15:30]
+```
+
+**After archiving**:
+- Entire project tree goes to `archive/projects.org`
+- All subtasks preserved
+- Original structure maintained
+
+### Example 3: Weekly Batch Archive
+
+**Process**:
+1. Identify all DONE/CANX from past week
+2. Group by section
+3. Archive each group to appropriate archive file
+4. Verify removal from todos.org
+
+```bash
+# Find this week's completed items
+week_ago=$(date -d "7 days ago" +"%Y-%m-%d")
+grep -B5 "CLOSED: \[$week_ago" ~/desktop/org/todos.org | \
+  grep "^** \(DONE\|CANX\)"
+```
+
+## Searching Archived Items
+
+### Find Archived TODO
+```bash
+# Search in all archives
+grep -r "authentication bug" ~/desktop/org/archive/
+
+# Search in specific archive
+grep "project name" ~/desktop/org/archive/work.org
+```
+
+### Find by Date
+```bash
+# Items archived in December 2025
+grep "ARCHIVE_TIME: 2025-12" ~/desktop/org/archive/work.org
+```
+
+### Find by Completion Date
+```bash
+# Items completed in November
+grep "CLOSED: \[2025-11" ~/desktop/org/archive/work.org
+```
+
+## Archive Maintenance
+
+### Monthly Review
+Once per month:
+1. Review archive files
+2. Check for patterns (what got done?)
+3. Identify what got cancelled (why?)
+4. Extract learnings
+
+### Yearly Cleanup
+Once per year:
+1. Archive old archive files (older than 1 year)
+2. Compress if needed
+3. Keep structure for reference
+
+## Tips
+
+1. **Archive weekly**: Don't let DONE items pile up
+2. **Keep recent**: Archive items >7 days old
+3. **Preserve context**: Keep all properties and notes
+4. **Search later**: Archives are searchable history
+5. **Learn from archives**: Review what you accomplished
+6. **Don't delete**: Archives are valuable record
+7. **Batch process**: Faster than one-by-one
+8. **Verify before removing**: Make sure archived successfully
+
+## Archive vs Delete
+
+### Archive (Recommended)
+- ✅ Completed work
+- ✅ Cancelled with reason
+- ✅ Historical record valuable
+- ✅ May need to reference later
+
+### Delete
+- ❌ Duplicate entries
+- ❌ Test/placeholder TODOs
+- ❌ Accidental captures
+- ❌ Spam/invalid entries
+
+**Rule**: When in doubt, archive (disk space is cheap)
+
+## Integration with Review
+
+### During Weekly Review
+1. **Archive last week's DONE**
+   ```bash
+   # Find week's completions
+   grep -B5 "CLOSED: \[$(date -d '7 days ago' +%Y-%m-%d)" \
+     ~/desktop/org/todos.org
+   ```
+
+2. **Review what got done**
+   - What did you accomplish?
+   - Any patterns?
+   - Celebrate wins!
+
+3. **Clean up todos.org**
+   - Remove archived items
+   - Keeps main file manageable
+
+### During Monthly Review
+1. **Review month's archives**
+   ```bash
+   grep "ARCHIVE_TIME: $(date +%Y-%m)" \
+     ~/desktop/org/archive/*.org
+   ```
+
+2. **Extract insights**
+   - High completion areas?
+   - What got cancelled?
+   - Time estimates accurate?
+
+## Validation Checklist
+
+Before archiving:
+- [ ] Item is DONE or CANX
+- [ ] Has CLOSED timestamp
+- [ ] Closed more than 7 days ago (unless urgent cleanup)
+- [ ] All properties preserved
+- [ ] LOGBOOK entries included
+- [ ] Archive destination correct
+
+After archiving:
+- [ ] Item in correct archive file
+- [ ] ARCHIVE_* properties added
+- [ ] Removed from todos.org
+- [ ] Can find via search
+
+## Common Questions
+
+**Q: How long to keep archives?**
+A: Indefinitely. They're your work history.
+
+**Q: Archive incomplete projects?**
+A: Only if completely abandoned. Usually mark as CANX first.
+
+**Q: Archive recurring tasks?**
+A: Only old completed instances (>2 weeks old).
+
+**Q: Can I restore from archive?**
+A: Yes, copy back to todos.org and remove ARCHIVE_* properties.
+
+**Q: Archive immediately after DONE?**
+A: No, keep recent completions visible for a week.
+
+**Q: Archive file gets huge?**
+A: Normal. Can split by year if needed (archive/work-2024.org).
+
+## Anti-Patterns
+
+❌ **Don't archive active TODOs**: Only DONE/CANX
+❌ **Don't lose context**: Keep all properties and notes
+❌ **Don't archive too quickly**: Keep recent completions visible
+❌ **Don't skip ARCHIVE_* properties**: Important metadata
+❌ **Don't delete instead of archive**: History is valuable
+✅ **Do archive regularly**: Weekly is good rhythm
+✅ **Do preserve structure**: Maintain original hierarchy
+✅ **Do search archives**: They're a knowledge base
+✅ **Do review archives**: Learn from your history

@@ -0,0 +1,568 @@
+# Project TODO Workflow
+
+## Purpose
+Manage multi-step projects with subtasks, progress tracking, and dependencies.
+
+## When to Use
+- Task requires 3+ steps
+- Multi-day or multi-week effort
+- Complex feature or initiative
+- Has clear deliverable
+
+## Project vs Simple TODO
+
+### Use Simple TODO When
+- Single action required
+- Can complete in one session
+- No dependencies
+- Straightforward task
+
+### Use Project When
+- Multiple related tasks
+- Sequential or parallel work
+- Track overall progress
+- Coordinate related efforts
+
+## Project Structure
+
+### Basic Project Format
+```org
+** TODO Project Name [0/3]
+:PROPERTIES:
+:CREATED:       [2025-12-04 Thu 15:30]
+:END:
+
+*** TODO First subtask
+*** TODO Second subtask
+*** TODO Third subtask
+```
+
+### Enhanced Project Format
+```org
+** TODO Project Name [0/3]
+SCHEDULED: <2025-12-05 Fri>
+:PROPERTIES:
+:CREATED:       [2025-12-04 Thu 15:30]
+:CATEGORY: work
+:END:
+
+Brief description of project goal and context.
+
+*** TODO First subtask
+SCHEDULED: <2025-12-05 Fri>
+
+*** TODO Second subtask
+
+*** TODO Third subtask
+```
+
+## Progress Tracking
+
+### Progress Counters
+
+**Format**: `[completed/total]`
+
+**Automatic Updates** (if using Emacs):
+- Updates when subtask marked DONE
+- Reflects current progress
+
+**Manual Updates** (command line):
+```org
+** TODO Keyboard improvements [1/3]
+
+*** DONE Leader keys implementation
+*** TODO Nav/media standardization
+*** TODO Symbol combos
+```
+
+After completing another:
+```org
+** TODO Keyboard improvements [2/3]
+
+*** DONE Leader keys implementation
+*** DONE Nav/media standardization
+*** TODO Symbol combos
+```
+
+### Percentage Tracking
+
+Alternative to counters:
+```org
+** TODO Project Name [33%]
+
+*** DONE First task
+*** TODO Second task
+*** TODO Third task
+```
+
+## Project Types
+
+### Sequential Project
+Tasks must be done in order:
+
+```org
+** TODO Setup Home Assistant [0/5]
+:PROPERTIES:
+:CREATED:       [2025-12-04 Thu 15:30]
+:END:
+
+*** TODO Install Raspberry Pi OS
+SCHEDULED: <2025-12-05 Fri>
+Dependencies must complete first.
+
+*** TODO Install Home Assistant
+Depends on: Raspberry Pi OS installed
+
+*** TODO Configure MQTT broker
+Depends on: Home Assistant running
+
+*** TODO Add first device
+Depends on: MQTT configured
+
+*** TODO Setup automations
+Depends on: Devices connected
+```
+
+### Parallel Project
+Tasks can be done independently:
+
+```org
+** TODO Website Redesign [0/4]
+
+*** TODO Design new homepage
+SCHEDULED: <2025-12-05 Fri>
+
+*** TODO Write new content
+SCHEDULED: <2025-12-05 Fri>
+
+*** TODO Setup new hosting
+SCHEDULED: <2025-12-06 Sat>
+
+*** TODO Migrate DNS
+(Do last, after all others complete)
+```
+
+### Research Project
+Exploratory with evolving scope:
+
+```org
+** TODO Research backup solutions [0/4]
+:PROPERTIES:
+:CREATED:       [2025-12-04 Thu 15:30]
+:END:
+
+*** TODO Evaluate restic
+:LOGBOOK:
+- Note taken on [2025-12-05 Fri 10:00] \\
+  Good: encryption, deduplication, active development
+  Bad: complex setup
+:END:
+
+*** TODO Evaluate borg backup
+
+*** TODO Compare performance
+
+*** DONE Create comparison matrix
+CLOSED: [2025-12-04 Thu 17:00]
+```
+
+## Project Templates
+
+### Feature Implementation
+```org
+** TODO Feature: User Authentication [0/5]
+SCHEDULED: <2025-12-05 Fri>
+:PROPERTIES:
+:CREATED:       [2025-12-04 Thu 15:30]
+:CATEGORY: work
+:END:
+
+Implement secure user authentication with JWT tokens.
+
+*** TODO Design auth flow and API
+SCHEDULED: <2025-12-05 Fri>
+
+*** TODO Implement backend auth endpoints
+
+*** TODO Create login UI components
+
+*** TODO Write tests
+
+*** TODO Update documentation
+```
+
+### Infrastructure Project
+```org
+** TODO Setup Kubernetes Cluster [0/6]
+:PROPERTIES:
+:CREATED:       [2025-12-04 Thu 15:30]
+:CATEGORY: systems
+:END:
+
+*** TODO Provision VMs
+SCHEDULED: <2025-12-06 Sat>
+
+*** TODO Install k3s
+
+*** TODO Configure networking
+
+*** TODO Setup storage
+
+*** TODO Deploy test application
+
+*** TODO Document setup
+```
+
+### Learning Project
+```org
+** TODO Learn Rust Basics [0/8]
+:PROPERTIES:
+:CREATED:       [2025-12-04 Thu 15:30]
+:CATEGORY: personal
+:END:
+
+Work through Rust book and build sample projects.
+
+*** TODO Read chapters 1-5
+SCHEDULED: <2025-12-05 Fri>
+
+*** TODO Complete ownership exercises
+
+*** TODO Build CLI tool
+
+*** TODO Read chapters 6-10
+
+*** TODO Build web service
+
+*** TODO Learn async programming
+
+*** TODO Contribute to open source
+
+*** TODO Write blog post about learning
+```
+
+### Personal Project
+```org
+** TODO Organize Home Office [0/5]
+DEADLINE: <2025-12-15 Mon>
+:PROPERTIES:
+:CREATED:       [2025-12-04 Thu 15:30]
+:CATEGORY: personal
+:END:
+
+*** TODO Declutter desk
+SCHEDULED: <2025-12-07 Sun>
+
+*** TODO Organize cables
+
+*** TODO Setup better lighting
+
+*** TODO Arrange bookshelf
+
+*** TODO Add plants
+```
+
+## Managing Projects
+
+### Starting a Project
+
+1. **Define the goal**
+   - What's the deliverable?
+   - Why are we doing this?
+   - What's the scope?
+
+2. **Break down into subtasks**
+   - 3-7 subtasks ideal
+   - Too many? Create sub-projects
+   - Too few? Might not need project
+
+3. **Identify dependencies**
+   - What must happen first?
+   - What can be parallel?
+   - Any blockers?
+
+4. **Schedule first task**
+   - When to start?
+   - Set SCHEDULED on project and/or first subtask
+
+5. **Add context**
+   - Links to docs, designs, notes
+   - Related issues or PRs
+   - Background information
+
+### Working on a Project
+
+1. **Review project regularly**
+   - Daily if active
+   - Weekly if background
+
+2. **Mark subtasks DONE as completed**
+   - Update progress counter
+   - Add completion notes
+
+3. **Add new subtasks as discovered**
+   - Projects evolve
+   - Increment total counter
+
+4. **Track progress notes**
+   ```org
+   :LOGBOOK:
+   - Note taken on [2025-12-05 Fri 14:00] \\
+     Completed initial setup. Performance better than expected.
+     Next: start on configuration phase.
+   :END:
+   ```
+
+5. **Reschedule if needed**
+   - Be honest about timeline
+   - Adjust SCHEDULED dates
+   - Note reasons for delays
+
+### Completing a Project
+
+1. **Mark all subtasks DONE**
+   ```org
+   *** DONE All subtasks
+   ```
+
+2. **Mark project DONE**
+   ```org
+   ** DONE Project Name [3/3]
+   CLOSED: [2025-12-10 Wed 15:30]
+   ```
+
+3. **Add completion note**
+   ```org
+   :LOGBOOK:
+   - State "DONE"       from "STRT"       [2025-12-10 Wed 15:30] \\
+     Project completed successfully. All features working as expected.
+     Deployed to production.
+   :END:
+   ```
+
+4. **Create follow-up tasks if needed**
+   ```org
+   ** TODO Monitor new feature performance
+   SCHEDULED: <2025-12-17 Wed>
+
+   Follow-up from: [[*Feature: User Authentication][User Authentication Project]]
+   ```
+
+5. **Archive during weekly review**
+
+## Project Lifecycle
+
+### Phase 1: Planning
+```org
+** TODO Project Name [0/0]
+:PROPERTIES:
+:CREATED:       [2025-12-04 Thu 15:30]
+:END:
+
+Planning phase - breaking down into subtasks.
+
+* Planning Notes
+- Goal: ...
+- Approach: ...
+- Resources needed: ...
+```
+
+### Phase 2: Active Work
+```org
+** STRT Project Name [2/5]
+:PROPERTIES:
+:CREATED:       [2025-12-04 Thu 15:30]
+:END:
+
+*** DONE Subtask 1
+*** DONE Subtask 2
+*** STRT Subtask 3
+*** TODO Subtask 4
+*** TODO Subtask 5
+```
+
+### Phase 3: Completion
+```org
+** DONE Project Name [5/5]
+CLOSED: [2025-12-15 Mon 10:30]
+:LOGBOOK:
+- State "DONE"       from "STRT"       [2025-12-15 Mon 10:30]
+:END:
+
+*** DONE Subtask 1-5 (all complete)
+```
+
+## Advanced Patterns
+
+### Nested Projects
+```org
+** TODO Large Initiative [0/3]
+
+*** TODO Phase 1: Research [0/3]
+
+**** TODO Literature review
+**** TODO Prototype evaluation
+**** TODO Decision document
+
+*** TODO Phase 2: Implementation [0/4]
+
+**** TODO Setup infrastructure
+**** TODO Core features
+**** TODO Testing
+**** TODO Documentation
+
+*** TODO Phase 3: Rollout [0/2]
+
+**** TODO Pilot deployment
+**** TODO Full deployment
+```
+
+### Project with External Dependencies
+```org
+** WAIT Website Migration [1/4]
+:PROPERTIES:
+:CREATED:       [2025-12-04 Thu 15:30]
+:END:
+:LOGBOOK:
+- State "WAIT"       from "STRT"       [2025-12-08 Mon 10:00] \\
+  Waiting for DNS propagation (24-48 hours)
+:END:
+
+*** DONE Export content from old site
+*** TODO Setup new hosting (BLOCKED: waiting for DNS)
+*** TODO Import content
+*** TODO Verify and go live
+```
+
+### Milestone Tracking
+```org
+** TODO Product Launch [3/10]
+DEADLINE: <2025-12-31 Wed>
+
+*** DONE Milestone 1: Design Complete [3/3]
+CLOSED: [2025-11-15 Mon]
+
+**** DONE UI mockups
+**** DONE User flow
+**** DONE Design review
+
+*** STRT Milestone 2: MVP Development [2/4]
+
+**** DONE Core features
+**** DONE Basic UI
+**** TODO Testing
+**** TODO Bug fixes
+
+*** TODO Milestone 3: Launch Prep [0/3]
+
+**** TODO Marketing materials
+**** TODO Documentation
+**** TODO Launch plan
+```
+
+## Tips
+
+1. **Right-size projects**: 3-7 subtasks is ideal
+2. **Break down large projects**: Use nested structure
+3. **Update progress regularly**: Keep counters current
+4. **Schedule first task**: Gets momentum going
+5. **Track dependencies**: Note blockers explicitly
+6. **Add context liberally**: Links, notes, decisions
+7. **Review weekly**: Keep projects moving
+8. **Don't abandon**: Either complete or cancel
+9. **Celebrate completion**: Mark milestone reached
+
+## Common Patterns
+
+### From Idea to Project
+```org
+# Start: Simple idea
+* TODO Build personal dashboard
+
+# Evolve: Realize it's bigger
+** TODO Build personal dashboard [0/4]
+
+*** TODO Research frameworks
+*** TODO Design layout
+*** TODO Implement data sources
+*** TODO Deploy to homelab
+```
+
+### Project Spawns Follow-up
+```org
+# Original project completes
+** DONE Setup Home Assistant [5/5]
+
+# Creates new project
+** TODO Home Automation Expansion [0/3]
+Based on learnings from initial Home Assistant setup.
+
+*** TODO Add more sensors
+*** TODO Create advanced automations
+*** TODO Integrate with other services
+```
+
+### Project Gets Cancelled
+```org
+** CANX Migrate to new framework [2/5]
+CLOSED: [2025-12-08 Mon 15:00]
+:LOGBOOK:
+- State "CANX"       from "STRT"       [2025-12-08 Mon 15:00] \\
+  Team decided to stick with current framework after evaluation.
+  Completed research was valuable even though not proceeding.
+:END:
+
+*** DONE Research alternatives
+*** DONE Create comparison matrix
+*** CANX Setup test environment
+*** CANX Migration plan
+*** CANX Execute migration
+```
+
+## Validation Checklist
+
+Good project has:
+- [ ] Clear goal and deliverable
+- [ ] 3-7 subtasks (not too few, not too many)
+- [ ] Progress counter [n/m]
+- [ ] CREATED timestamp
+- [ ] Context and links
+- [ ] First task scheduled (if starting now)
+- [ ] Dependencies noted if sequential
+
+## Integration
+
+### Link to Notes
+```org
+** TODO Project Name [0/3]
+
+Design doc: [[file:~/desktop/org/notes/20251204--project-design__work.org][Project Design Note]]
+```
+
+### Link to Code
+```org
+** TODO Refactor Authentication [1/3]
+
+Codebase: [[file:~/src/myproject/src/auth/][Auth Module]]
+```
+
+### Reference from Other TODOs
+```org
+** TODO Deploy changes
+
+Depends on: [[*Project Name][Project Name]] completion
+```
+
+## Anti-Patterns
+
+❌ **Too many subtasks**: >10 means break into sub-projects
+❌ **Too few subtasks**: <3 might not need project structure
+❌ **Vague subtasks**: "Do the thing" isn't actionable
+❌ **Never update progress**: Counters get stale
+❌ **Abandon without cancelling**: Either finish or mark CANX
+❌ **No scheduling**: Projects drift without dates
+✅ **Right-sized**: 3-7 clear subtasks
+✅ **Regular updates**: Progress tracked weekly
+✅ **Clear dependencies**: Know what blocks what
+✅ **Scheduled start**: First task has date
+✅ **Complete or cancel**: Honest about status

@@ -0,0 +1,518 @@
+# Recurring TODO Workflow
+
+## Purpose
+Manage repeating tasks, habits, meetings, and maintenance routines.
+
+## When to Use
+- Regular meetings (weekly 1:1s, stand-ups)
+- Maintenance tasks (backups, updates, reviews)
+- Habits (exercise, journaling, reading)
+- Periodic reviews (daily, weekly, monthly)
+- Scheduled events (appointments, classes)
+
+## Recurring Task Types
+
+### 1. Fixed Schedule
+Same time, same day, always:
+```org
+** STRT Weekly team meeting
+SCHEDULED: <2025-12-05 Fri 14:00 ++1w>
+:PROPERTIES:
+:LAST_REPEAT: [2025-11-28 Fri 14:00]
+:CATEGORY: work
+:END:
+```
+
+### 2. Flexible Schedule
+After completion, schedule next occurrence:
+```org
+** TODO Weekly review
+SCHEDULED: <2025-12-08 Mon ++1w>
+:PROPERTIES:
+:STYLE:    habit
+:LAST_REPEAT: [2025-12-01 Mon 13:40]
+:END:
+```
+
+### 3. Deadline-Based
+Must be done by certain interval:
+```org
+** TODO Monthly backup check
+DEADLINE: <2025-12-31 Wed +1m>
+:PROPERTIES:
+:LAST_REPEAT: [2025-11-30 Sat 15:30]
+:END:
+```
+
+## Repeater Syntax
+
+### `+` Repeater (Strict)
+Repeats from **original date**, even if late:
+
+```org
+SCHEDULED: <2025-12-05 Fri +1w>
+```
+
+- If you complete on Dec 5 → next is Dec 12
+- If you complete on Dec 8 → next is still Dec 12
+- **Use for**: Time-sensitive events, meetings
+
+### `++` Repeater (Shift from today)
+Repeats from **completion date**:
+
+```org
+SCHEDULED: <2025-12-05 Fri ++1w>
+```
+
+- If you complete on Dec 5 → next is Dec 12
+- If you complete on Dec 8 → next is Dec 15
+- **Use for**: Flexible tasks, maintenance, habits
+
+### `.+` Repeater (Shift and skip)
+Like `++` but doesn't nag if you skip:
+
+```org
+SCHEDULED: <2025-12-05 Fri .+1w>
+```
+
+- If you complete on Dec 5 → next is Dec 12
+- If you complete on Dec 15 → next is Dec 22 (skips Dec 12)
+- **Use for**: Habits you want to do but can skip
+
+## Time Intervals
+
+### Common Intervals
+```org
++1d    Daily
++1w    Weekly
++2w    Bi-weekly
++1m    Monthly
++3m    Quarterly
++1y    Yearly
+```
+
+### Specific Days
+```org
++1w Mon        Every Monday
++2w Fri        Every other Friday
++1m 1          First of each month
++1m -1         Last day of each month
+```
+
+### Complex Patterns
+```org
+++1w Mon Wed Fri    Mon/Wed/Fri after completion
++1m 1 15            1st and 15th of each month
+```
+
+## Habit Tracking
+
+### Basic Habit
+```org
+** TODO Daily exercise
+SCHEDULED: <2025-12-05 Fri ++1d>
+:PROPERTIES:
+:STYLE:    habit
+:LAST_REPEAT: [2025-12-04 Thu 07:00]
+:END:
+```
+
+### Habit with Consistency Goal
+```org
+** TODO Morning journaling
+SCHEDULED: <2025-12-05 Fri .+1d>
+:PROPERTIES:
+:STYLE:    habit
+:LAST_REPEAT: [2025-12-04 Thu 06:30]
+:HABIT_CONSISTENCY: 5d
+:END:
+
+Goal: Journal at least 5 days per week
+```
+
+## Common Recurring Patterns
+
+### Weekly Meeting
+```org
+** STRT 1:1 with Manager
+SCHEDULED: <2025-12-05 Fri 10:00 +1w>
+:PROPERTIES:
+:LAST_REPEAT: [2025-11-28 Fri 10:18]
+:CATEGORY: work
+:END:
+
+Meeting notes: [[file:~/notes/meeting-notes.org][Meeting Notes]]
+```
+
+### Daily Standup
+```org
+** STRT Daily standup
+SCHEDULED: <2025-12-05 Fri 09:00 +1d Mon Tue Wed Thu Fri>
+:PROPERTIES:
+:LAST_REPEAT: [2025-12-04 Thu 09:00]
+:CATEGORY: work
+:END:
+
+Team sync - what did I do, what am I doing, any blockers
+```
+
+### Weekly Review
+```org
+** TODO Weekly planning and review
+SCHEDULED: <2025-12-08 Mon 09:00 ++1w>
+:PROPERTIES:
+:STYLE:    habit
+:LAST_REPEAT: [2025-12-01 Mon 09:15]
+:END:
+
+- Review last week
+- Plan this week
+- Archive completed items
+```
+
+### Monthly Maintenance
+```org
+** TODO Server maintenance and updates
+SCHEDULED: <2025-12-15 Mon ++1m>
+:PROPERTIES:
+:LAST_REPEAT: [2025-11-15 Sun 14:30]
+:CATEGORY: systems
+:END:
+
+- Update packages
+- Check backups
+- Review logs
+- Security patches
+```
+
+### Quarterly Review
+```org
+** TODO Quarterly goal review
+DEADLINE: <2025-12-31 Wed +3m>
+:PROPERTIES:
+:LAST_REPEAT: [2025-09-30 Mon 15:00]
+:END:
+
+Review progress on yearly goals and adjust
+```
+
+### Annual Tasks
+```org
+** TODO Annual tax preparation
+DEADLINE: <2025-04-15 Wed +1y>
+:PROPERTIES:
+:LAST_REPEAT: [2024-04-10 Mon 20:00]
+:END:
+
+Gather documents and file taxes
+```
+
+## Managing Recurring Tasks
+
+### Completing a Recurring Task
+
+When you mark DONE:
+```org
+# Before completion
+** TODO Weekly review
+SCHEDULED: <2025-12-08 Mon ++1w>
+:PROPERTIES:
+:LAST_REPEAT: [2025-12-01 Mon 13:40]
+:END:
+
+# After marking DONE on Dec 8
+** TODO Weekly review
+SCHEDULED: <2025-12-15 Mon ++1w>
+:PROPERTIES:
+:LAST_REPEAT: [2025-12-08 Mon 14:15]
+:END:
+:LOGBOOK:
+- State "DONE"       from "TODO"       [2025-12-08 Mon 14:15]
+:END:
+```
+
+**What happens**:
+- State returns to TODO (or original state)
+- SCHEDULED advances by interval
+- LAST_REPEAT updated to completion time
+- LOGBOOK entry added
+
+### Skipping an Occurrence
+
+**Option 1**: Mark DONE anyway
+- Advances schedule
+- Records you acknowledged it
+
+**Option 2**: Reschedule to next occurrence
+```org
+# Manually update SCHEDULED to next date
+SCHEDULED: <2025-12-15 Mon ++1w>
+```
+
+**Option 3**: Add note explaining skip
+```org
+:LOGBOOK:
+- Note taken on [2025-12-08 Mon 10:00] \\
+  Skipped this week due to holiday
+:END:
+```
+
+### Stopping a Recurring Task
+
+**Mark as CANX**:
+```org
+** CANX Weekly team sync (team disbanded)
+CLOSED: [2025-12-08 Mon 10:00]
+:LOGBOOK:
+- State "CANX"       from "STRT"       [2025-12-08 Mon 10:00] \\
+  Team disbanded, meeting no longer needed
+:END:
+```
+
+**Remove repeater** (make one-time):
+```org
+# Before
+SCHEDULED: <2025-12-08 Mon ++1w>
+
+# After
+SCHEDULED: <2025-12-08 Mon>
+```
+
+### Changing Frequency
+
+**Update repeater interval**:
+```org
+# Was weekly
+SCHEDULED: <2025-12-08 Mon ++1w>
+
+# Now bi-weekly
+SCHEDULED: <2025-12-08 Mon ++2w>
+```
+
+**Update day/time**:
+```org
+# Was Friday 14:00
+SCHEDULED: <2025-12-05 Fri 14:00 +1w>
+
+# Now Monday 10:00
+SCHEDULED: <2025-12-08 Mon 10:00 +1w>
+```
+
+## Recurring Task Templates
+
+### Daily Habit
+```org
+** TODO [Habit name]
+SCHEDULED: <YYYY-MM-DD Day .+1d>
+:PROPERTIES:
+:STYLE:    habit
+:LAST_REPEAT: [previous-completion]
+:END:
+
+[Description and notes]
+```
+
+### Weekly Task
+```org
+** TODO [Task name]
+SCHEDULED: <YYYY-MM-DD Day ++1w>
+:PROPERTIES:
+:LAST_REPEAT: [previous-completion]
+:CATEGORY: [category]
+:END:
+
+[Context and links]
+```
+
+### Monthly Maintenance
+```org
+** TODO [Maintenance task]
+SCHEDULED: <YYYY-MM-DD Day ++1m>
+:PROPERTIES:
+:LAST_REPEAT: [previous-completion]
+:CATEGORY: systems
+:END:
+
+Checklist:
+- [ ] Item 1
+- [ ] Item 2
+- [ ] Item 3
+```
+
+### Meeting with Notes
+```org
+** STRT [Meeting name]
+SCHEDULED: <YYYY-MM-DD Day HH:MM +1w>
+:PROPERTIES:
+:LAST_REPEAT: [previous-occurrence]
+:CATEGORY: work
+:END:
+
+Agenda:
+- Topic 1
+- Topic 2
+
+Notes: [[file:~/notes/meeting-notes.org::*Meeting Name][Meeting Notes]]
+```
+
+## Tracking Habits
+
+### Simple Habit Tracking
+Just mark DONE each time:
+```org
+** TODO Morning exercise
+SCHEDULED: <2025-12-05 Fri .+1d>
+:PROPERTIES:
+:STYLE:    habit
+:LAST_REPEAT: [2025-12-04 Thu 07:15]
+:END:
+```
+
+Check LOGBOOK for consistency.
+
+### Habit with Notes
+Track details:
+```org
+** TODO Meditation
+SCHEDULED: <2025-12-05 Fri .+1d>
+:PROPERTIES:
+:STYLE:    habit
+:LAST_REPEAT: [2025-12-04 Thu 06:30]
+:END:
+:LOGBOOK:
+- State "DONE"       from "TODO"       [2025-12-04 Thu 06:30] \\
+  15 minutes, felt focused
+- State "DONE"       from "TODO"       [2025-12-03 Wed 06:45] \\
+  10 minutes, distracted
+:END:
+```
+
+### Habit Streaks
+Check consistency:
+```bash
+# See completion pattern
+grep "State \"DONE\"" todos.org | \
+  grep "Morning exercise" | \
+  tail -14
+```
+
+## Tips
+
+1. **Choose right repeater**:
+   - Fixed schedule? Use `+`
+   - Flexible? Use `++`
+   - Can skip? Use `.+`
+
+2. **Start with STRT or TODO**:
+   - STRT for ongoing (meetings)
+   - TODO for tasks (reviews, maintenance)
+
+3. **Track in LOGBOOK**: Notes about each occurrence
+
+4. **Use LAST_REPEAT**: See when last completed
+
+5. **Keep in Routines section**: Unless specific to other section
+
+6. **Link to resources**: Meeting notes, checklists, docs
+
+7. **Review regularly**: Are these still needed?
+
+8. **Adjust frequency**: If consistently late, maybe less frequent
+
+## Viewing Recurring Tasks
+
+### All Recurring Tasks
+```bash
+grep -B2 "SCHEDULED:.*+\|DEADLINE:.*+" ~/desktop/org/todos.org | \
+  grep "^\*\*"
+```
+
+### Today's Recurring Items
+```bash
+today=$(date +"%Y-%m-%d")
+grep -B2 "SCHEDULED: <$today.*+" ~/desktop/org/todos.org | \
+  grep "^\*\*"
+```
+
+### Habit Consistency
+```bash
+# Check last 10 completions of a habit
+grep -A3 "^\*\* TODO Morning exercise" ~/desktop/org/todos.org | \
+  grep "State \"DONE\"" | \
+  tail -10
+```
+
+## Common Issues
+
+### Missed Several Occurrences
+```org
+# Task scheduled for Dec 1, today is Dec 15
+SCHEDULED: <2025-12-01 Mon ++1w>
+```
+
+**Solution**: Mark DONE to advance to next
+- If `++1w`: advances to Dec 22 (week from completion)
+- If `+1w`: would go to next scheduled (Dec 8, 15, 22...)
+
+### Wrong Interval
+```org
+# Was daily but should be weekly
+SCHEDULED: <2025-12-05 Fri ++1d>
+```
+
+**Solution**: Update interval
+```org
+SCHEDULED: <2025-12-05 Fri ++1w>
+```
+
+### No Longer Needed
+```org
+** STRT Old recurring meeting
+SCHEDULED: <2025-12-05 Fri +1w>
+```
+
+**Solution**: Mark as CANX with reason
+```org
+** CANX Old recurring meeting
+CLOSED: [2025-12-05 Fri 10:00]
+:LOGBOOK:
+- State "CANX"       from "STRT"       [2025-12-05 Fri 10:00] \\
+  Project completed, meeting no longer needed
+:END:
+```
+
+## Integration
+
+### With Calendar
+Recurring tasks show up on schedule in org-agenda.
+
+### With Notes
+Link to meeting notes or habit journal:
+```org
+** STRT Weekly 1:1
+SCHEDULED: <2025-12-05 Fri 10:00 +1w>
+
+Notes: [[file:~/desktop/org/notes/20251204--1on1-notes__work.org][1:1 Meeting Notes]]
+```
+
+### With Projects
+Track recurring reviews of projects:
+```org
+** TODO Review project X progress
+SCHEDULED: <2025-12-08 Mon ++1w>
+
+Project: [[*Project X][Project X Details]]
+```
+
+## Anti-Patterns
+
+❌ **Too many recurring tasks**: Overwhelming, won't complete
+❌ **Wrong repeater type**: Using `+` when should use `++`
+❌ **Never completing**: If consistently skip, maybe not needed
+❌ **No notes**: Can't remember what happened each time
+❌ **Outdated tasks**: Keep running things no longer relevant
+✅ **Right amount**: Only essential recurring tasks
+✅ **Appropriate interval**: Matches actual need
+✅ **Complete regularly**: Build the habit
+✅ **Track progress**: Add notes each completion
+✅ **Review periodically**: Cancel what's no longer needed

@@ -0,0 +1,414 @@
+# Refile TODO Workflow
+
+## Purpose
+Move TODOs from inbox to proper sections in todos.org, or reorganize between sections.
+
+## When to Use
+- Processing inbox.org items
+- Moving TODOs to correct section
+- Reorganizing as priorities change
+- Converting quick captures to structured TODOs
+
+## Refile Process
+
+### 1. Review Inbox Items
+```bash
+# Show current inbox
+cat ~/desktop/org/inbox.org
+
+# Count items
+grep -c "^\* TODO" ~/desktop/org/inbox.org
+```
+
+### 2. For Each Item, Determine Section
+
+**Work Section**: Job-related, upstream, team collaboration
+**Projects Section**: Multi-step initiatives, features
+**Systems Section**: Homelab, infrastructure, NixOS
+**Personal Section**: Life admin, errands, appointments
+**Routines Section**: Recurring meetings, habits
+**Health Section**: Health appointments, tracking
+
+### 3. Add Appropriate Properties
+
+When refiling, enhance the TODO:
+- Add CREATED timestamp if missing
+- Set CATEGORY property
+- Add priority if important
+- Set SCHEDULED or DEADLINE if time-sensitive
+- Add context notes
+
+### 4. Remove from Inbox
+
+After successfully refiling to todos.org, remove from inbox.org.
+
+## Refile Templates
+
+### From Simple Inbox Entry
+**Inbox**:
+```org
+* TODO Review PR #123
+```
+
+**Refiled to Work**:
+```org
+** TODO Review PR #123
+:PROPERTIES:
+:CREATED:       [2025-12-04 Thu 15:30]
+:CATEGORY: work
+:END:
+
+https://github.com/tektoncd/pipeline/pull/123
+```
+
+### From Quick Capture to Scheduled Task
+**Inbox**:
+```org
+* TODO Setup MQTT broker
+```
+
+**Refiled to Systems**:
+```org
+** TODO [#3] Setup MQTT broker on rhea
+SCHEDULED: <2025-12-06 Fri>
+:PROPERTIES:
+:CREATED:       [2025-12-04 Thu 15:30]
+:CATEGORY: systems
+:END:
+
+- Install mosquitto
+- Configure authentication
+- Setup firewall rules
+```
+
+### From Note to Project
+**Inbox**:
+```org
+* TODO Improve keyboard firmware
+```
+
+**Refiled to Projects**:
+```org
+** TODO Keyboard firmware improvements [0/3]
+:PROPERTIES:
+:CREATED:       [2025-12-04 Thu 15:30]
+:END:
+
+*** TODO Implement leader keys
+SCHEDULED: <2025-12-05 Fri>
+
+*** TODO Standardize nav/media layers
+
+*** TODO Add symbol combos
+```
+
+## Decision Matrix
+
+### Which Section?
+
+| Content | Section | Example |
+|---------|---------|---------|
+| Upstream work, team tasks | Work | "Review CLI roadmap" |
+| Multi-step feature/goal | Projects | "Setup home automation" |
+| Infrastructure, configs | Systems | "Configure wireguard VPN" |
+| Life admin, personal | Personal | "Schedule dentist" |
+| Recurring events | Routines | "Weekly team meeting" |
+| Health-related | Health | "Exercise tracking" |
+
+### Priority Assignment
+
+| Urgency | Priority | When |
+|---------|----------|------|
+| Critical/Urgent | [#1] | Must do today/tomorrow |
+| Important | [#2] | Should do this week |
+| Normal | [#3] | Regular work |
+| Low | [#4] | Nice to have |
+| Someday | [#5] | Future consideration |
+
+### Scheduling Guidelines
+
+**Set SCHEDULED when**:
+- You know when to start
+- Depends on specific date
+- Part of time-blocked plan
+
+**Set DEADLINE when**:
+- Hard due date exists
+- External commitment
+- Time-sensitive
+
+**Leave unscheduled when**:
+- Flexible timing
+- Backlog item
+- Waiting for dependencies
+
+## Workflow Steps
+
+### Daily Inbox Processing (5 minutes)
+
+1. **Open inbox**
+   ```bash
+   cat ~/desktop/org/inbox.org
+   ```
+
+2. **For each item**:
+   - Decide section
+   - Add properties
+   - Set priority/schedule if needed
+   - Find insertion point in todos.org
+   - Insert using Edit tool
+   - Remove from inbox
+
+3. **Clear processed items**
+   Update inbox.org to remove refiled items
+
+### Weekly Inbox Cleanup (10 minutes)
+
+1. **Review all inbox items**
+2. **Batch process by section**:
+   - All work items → Work section
+   - All systems items → Systems section
+   - etc.
+3. **Archive or delete**:
+   - Old items no longer relevant
+   - Duplicates
+   - Already done
+
+## Examples
+
+### Example 1: Simple Work Task
+**Inbox item**:
+```org
+* TODO Fix bug in authentication
+```
+
+**Process**:
+1. Identify: Work section (job-related)
+2. Enhance: Add priority, properties
+3. Insert after Work header:
+```org
+** TODO [#2] Fix bug in authentication
+:PROPERTIES:
+:CREATED:       [2025-12-04 Thu 15:30]
+:CATEGORY: work
+:END:
+
+Reported issue with null pointer in validation
+```
+4. Remove from inbox
+
+### Example 2: Multi-Part Project
+**Inbox item**:
+```org
+* TODO Setup backup system
+```
+
+**Process**:
+1. Identify: Systems section (infrastructure)
+2. Break down into project with subtasks
+3. Insert in Systems:
+```org
+** TODO Setup automated backups [0/4]
+:PROPERTIES:
+:CREATED:       [2025-12-04 Thu 15:30]
+:CATEGORY: systems
+:END:
+
+*** TODO Choose backup tool (restic vs borg)
+*** TODO Configure backup schedules
+*** TODO Setup remote storage
+*** TODO Test restore procedure
+```
+4. Remove from inbox
+
+### Example 3: Time-Sensitive Personal Task
+**Inbox item**:
+```org
+* TODO Renew car insurance
+```
+
+**Process**:
+1. Identify: Personal section
+2. Add deadline (expires Dec 15)
+3. Set priority (important)
+4. Insert in Personal:
+```org
+** TODO [#2] Renew car insurance
+DEADLINE: <2025-12-15 Mon>
+:PROPERTIES:
+:CREATED:       [2025-12-04 Thu 15:30]
+:CATEGORY: personal
+:END:
+
+Policy expires Dec 15
+Compare quotes before renewing
+```
+5. Remove from inbox
+
+### Example 4: Recurring Event
+**Inbox item**:
+```org
+* TODO Weekly team sync
+```
+
+**Process**:
+1. Identify: Routines section
+2. Set recurring schedule
+3. Insert in Routines:
+```org
+** STRT Weekly team sync
+SCHEDULED: <2025-12-05 Fri 14:00 ++1w>
+:PROPERTIES:
+:LAST_REPEAT: [2025-11-28 Fri 14:00]
+:CATEGORY: work
+:END:
+
+Meeting link: https://meet.google.com/...
+```
+5. Remove from inbox
+
+### Example 5: Reorganize Between Sections
+**Current location** (in Work):
+```org
+** TODO Setup home automation system
+```
+
+**Should be in Projects**:
+1. Read current TODO from Work section
+2. Decide it's actually a project
+3. Expand into project with subtasks
+4. Insert in Projects section:
+```org
+** TODO Home automation with Home Assistant [0/5]
+:PROPERTIES:
+:CREATED:       [2025-11-15 Mon 10:00]
+:END:
+
+*** TODO Setup Home Assistant on Raspberry Pi
+*** TODO Configure MQTT broker
+*** TODO Add temperature sensors
+*** TODO Setup automations
+*** TODO Mobile app configuration
+```
+5. Remove from Work section
+
+## Batch Refiling
+
+### Process Multiple Work Items
+```bash
+# Show all work-related in inbox
+grep -A2 "TODO.*\(PR\|review\|upstream\|team\)" ~/desktop/org/inbox.org
+
+# Refile each to Work section
+# Then clear from inbox
+```
+
+### Process Multiple System Items
+```bash
+# Show all system-related in inbox
+grep -A2 "TODO.*\(setup\|configure\|deploy\|nixos\)" ~/desktop/org/inbox.org
+
+# Refile each to Systems section
+```
+
+## Tips
+
+1. **Process inbox regularly**: Daily keeps it manageable
+2. **Don't overthink**: When unsure, pick best guess and move on
+3. **Enhance while refiling**: Add context, links, notes
+4. **Break down large items**: Convert to projects
+5. **Delete ruthlessly**: Old captures may no longer be relevant
+6. **Link to source**: Add links to emails, notes, issues
+7. **Set realistic dates**: Don't over-schedule
+8. **Use categories**: Helps with filtering later
+
+## Common Patterns
+
+### Email to TODO
+Capture from email → inbox → refile to Work with context:
+```org
+** TODO Follow up on deployment discussion
+:PROPERTIES:
+:CREATED:       [2025-12-04 Thu 15:30]
+:CATEGORY: work
+:END:
+
+From email thread with Alice
+Need to schedule deployment for staging environment
+```
+
+### Meeting Action Item
+Capture in meeting → inbox → refile with deadline:
+```org
+** TODO Prepare architecture presentation
+DEADLINE: <2025-12-10 Wed>
+:PROPERTIES:
+:CREATED:       [2025-12-04 Thu 15:30]
+:CATEGORY: work
+:END:
+
+Action item from team meeting
+Present new architecture proposal
+```
+
+### Idea to Project
+Random idea → inbox → refile as project:
+```org
+** TODO Build personal dashboard [0/4]
+:PROPERTIES:
+:CREATED:       [2025-12-04 Thu 15:30]
+:END:
+
+*** TODO Research dashboard frameworks
+*** TODO Design layout and widgets
+*** TODO Implement data sources
+*** TODO Deploy to homelab
+```
+
+## Validation Checklist
+
+Before marking as refiled:
+- [ ] Inserted in correct section
+- [ ] Added CREATED timestamp
+- [ ] Set CATEGORY property
+- [ ] Priority set if important
+- [ ] Scheduled/deadline if time-sensitive
+- [ ] Context and links added
+- [ ] Removed from inbox
+
+## Integration
+
+### With Email
+```bash
+# Create inbox entry from email
+echo "* TODO Follow up with $NAME
+From: $EMAIL_SUBJECT
+" >> ~/desktop/org/inbox.org
+```
+
+### With Git
+```bash
+# Create inbox entry after finding issue
+echo "* TODO Fix issue #$ISSUE_NUM
+$(git log --oneline | head -1)
+" >> ~/desktop/org/inbox.org
+```
+
+### With Notes
+Link refiled TODO to note:
+```org
+** TODO Implement new feature
+From: [[file:~/desktop/org/notes/20251204--feature-design__work.org][Feature Design]]
+```
+
+## Avoiding Common Mistakes
+
+❌ **Don't leave in inbox forever**: Process regularly
+❌ **Don't create duplicates**: Check if already exists in todos.org
+❌ **Don't lose context**: Add links and notes while refiling
+❌ **Don't over-elaborate**: Can add details later when working on it
+❌ **Don't skip properties**: At least add CREATED and CATEGORY
+✅ **Do process in batches**: Faster than one-by-one
+✅ **Do enhance while refiling**: Better than bare TODO
+✅ **Do delete old items**: Inbox is not a graveyard
+✅ **Do link sources**: Email, notes, issues, PRs