Understand Bob¶

Eight nouns carry the whole system. Start with the diagram, then read each idea and the glossary for exact meanings.

The nouns¶

• Vault — one Obsidian folder of Markdown; the authoritative state the tools reconcile.
• Task — a #task checkbox line with block ID and date fields; see Tasks and lanes.
• Lane — Ready, Next, Pending, Blocked, Done, Cancelled; sticky except Blocked, which is derived; see Tasks and lanes.
• Pomodoro — a timed work session in the daily note under ## Pomodoros; see Today and the Pomodoro ledger.
• Capture — one bob capture draft that plans edits then writes all or nothing; see Tasks and lanes.
• Freshness — the local calendar date a human last confirmed a task; see Freshness and the review walk.
• Project — a note whose ^prj task states the outcome; residents follow its blocking; see Projects and dependencies.
• Plugin — an Obsidian extension that renders review and writes gestures into the vault; Mac Capture is a sibling program that submits drafts through the CLI.

System and vocabulary¶

• How Bob fits together — vault, CLI, plugins, and the Mac round trip.
• Tasks and lanes — checkboxes, sticky commitment, and derived blocking.
• Today and the Pomodoro ledger — how the ledger selects today.
• Freshness and the review walk — confirmation dates and the tiered walk.
• Projects and dependencies — residence, parents, and prerequisites.
• The reference library — sources, notes, and reading tasks.
• Why the vault syncs through git — history, conflicts, and recovery.
• Glossary — shared terms for every page.