# 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](<https://bobs-org.github.io/concepts/tasks-and-lanes/index.md>).
- **Lane** — Ready, Next, Pending, Blocked, Done, Cancelled; sticky except Blocked, which is derived; see [Tasks and lanes](<https://bobs-org.github.io/concepts/tasks-and-lanes/index.md>).
- **Pomodoro** — a timed work session in the daily note under `## Pomodoros`; see [Today and the Pomodoro ledger](<https://bobs-org.github.io/concepts/today-and-the-pomodoro-ledger/index.md>).
- **Capture** — one `bob capture` draft that plans edits then writes all or nothing; see [Tasks and lanes](<https://bobs-org.github.io/concepts/tasks-and-lanes/#capture-makes-a-task>).
- **Freshness** — the local calendar date a human last confirmed a task; see [Freshness and the review walk](<https://bobs-org.github.io/concepts/freshness-and-the-review-walk/index.md>).
- **Project** — a note whose `^prj` task states the outcome; residents follow its blocking; see [Projects and dependencies](<https://bobs-org.github.io/concepts/projects-and-dependencies/index.md>).
- **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](<https://bobs-org.github.io/concepts/how-bob-fits-together/index.md>) — vault, CLI, plugins, and the Mac round trip.
- [Tasks and lanes](<https://bobs-org.github.io/concepts/tasks-and-lanes/index.md>) — checkboxes, sticky commitment, and derived blocking.
- [Today and the Pomodoro ledger](<https://bobs-org.github.io/concepts/today-and-the-pomodoro-ledger/index.md>) — how the ledger selects today.
- [Freshness and the review walk](<https://bobs-org.github.io/concepts/freshness-and-the-review-walk/index.md>) — confirmation dates and the tiered walk.
- [Projects and dependencies](<https://bobs-org.github.io/concepts/projects-and-dependencies/index.md>) — residence, parents, and prerequisites.
- [The reference library](<https://bobs-org.github.io/concepts/reference-library/index.md>) — sources, notes, and reading tasks.
- [Why the vault syncs through git](<https://bobs-org.github.io/concepts/why-the-vault-syncs-through-git/index.md>) — history, conflicts, and recovery.
- [Glossary](<https://bobs-org.github.io/reference/glossary/index.md>) — shared terms for every page.