vault backup: 2026-02-24 07:55:02

06_Metadata/WORKFLOWS.md

@@ -6,24 +6,35 @@
 **Status**: Reference Documentation
 
 > This is a detailed reference. For core rules, see `.claude/project-instructions.md`
+> Relationship: `README.md` is the entry point, `QUICK_REFERENCE.md` is the quick reference, and this document is the detailed workflow guide.
 
 ---
 
 ## Table of Contents
 
-1. [Output Templates](#output-templates)
-2. [PARA Method Explained](#para-method-explained)
-3. [Naming Conventions](#naming-conventions)
-4. [Inbox Management](#inbox-management)
-5. [Attachments Management](#attachments-management)
-6. [Web Content Workflow](#web-content-workflow)
-7. [Writing Style Guidelines](#writing-style-guidelines)
-8. [Git Workflow](#git-workflow)
-9. [Daily Workflows](#daily-workflows)
-10. [Available Commands](#available-commands)
-11. [Best Practices](#best-practices)
-12. [Troubleshooting](#troubleshooting)
-13. [Memvid Workflows](#memvid-workflows)
+1. [Command Policy](#command-policy)
+2. [Output Templates](#output-templates)
+3. [PARA Method Explained](#para-method-explained)
+4. [Naming Conventions](#naming-conventions)
+5. [Inbox Management](#inbox-management)
+6. [Attachments Management](#attachments-management)
+7. [Web Content Workflow](#web-content-workflow)
+8. [Writing Style Guidelines](#writing-style-guidelines)
+9. [Git Workflow](#git-workflow)
+10. [Daily Workflows](#daily-workflows)
+11. [Available Commands](#available-commands)
+12. [Best Practices](#best-practices)
+13. [Troubleshooting](#troubleshooting)
+14. [Memvid Workflows](#memvid-workflows)
+
+---
+
+## Command Policy
+
+- Manual commands in documentation use simple, copy-safe commands only
+- Avoid pipes, `grep`, `find`, or other complex shell constructs in manual steps
+- Complex operations belong in `pnpm` scripts
+- If `pnpm` is unavailable, use `npm run <script>` as a fallback
 
 ---
 
@@ -469,7 +480,7 @@ git status                  # Periodically check changes
 ```bash
 git status                  # Review all changes
 git add .                   # Stage all changes
-git commit -m "vault backup: $(date +%Y-%m-%d\ %H:%M:%S)"
+git commit -m "vault backup: YYYY-MM-DD HH:MM:SS"
 git push                    # Sync to remote
 ```
 
@@ -565,7 +576,7 @@ ls 00_Inbox/
 # 3. Commit changes
 git status
 git add .
-git commit -m "vault backup: $(date)"
+git commit -m "vault backup: YYYY-MM-DD HH:MM:SS"
 git push
 ```
 
@@ -613,7 +624,6 @@ git push                       # Sync to remote
 cd D:\tmp\vault\my-vault       # Vault root
 ls 00_Inbox/                   # List inbox
 ls 01_Projects/                # List projects
-find . -type d | sort          # Map all folders
 ```
 
 ---
@@ -717,7 +727,7 @@ find . -type d | sort          # Map all folders
 **Lost Files**:
 - Check git history: `git log --all --full-history -- <path>`
 - Look in Archive folders
-- Search by content: use grep or Obsidian search
+- Search by content: use Obsidian search
 - Check recent commits for moves
 
 ---