RogueAgenda/PRESETS.md

# Rogue Agenda presets

Presets create complete example `.agnd` workspaces. They are intended both as
useful starting points and as inspectable examples of how categories, hierarchy,
saved views, sections, columns, rules, notes, dates, numeric values, and macros
fit together.

All bundled records, organizations, people, routes, recipes, and wording are
original fictional demonstration content. The presets reimagine documented
Agenda workflows without copying or requiring legacy `.AG` files.

## Creating a preset document

Pass one preset name when creating a document:

```sh
rogue-agenda sales.agnd --preset accounts
rogue-agenda course-notes.agnd --preset study
rogue-agenda week.agnd --preset planner
rogue-agenda kitchen.agnd --preset recipes
rogue-agenda cycling.agnd --preset rides
rogue-agenda team.agnd --preset people
```

From the source tree, prefix the same arguments with `cargo run --`:

```sh
cargo run -- learning.agnd --preset study
```

A preset deliberately works only when the destination is new. Rogue Agenda
refuses to replace an existing SQLite document, even if that document has no
items. Choose a path that does not exist if you want a fresh copy. `--preset`
and the smaller `--demo` initializer cannot be used together.

Dates in sample records are relative to the day the document is created, so
upcoming, overdue, Datebook, and review views are immediately meaningful. Preset
documents remain ordinary editable `.agnd` files: rename or remove categories,
rewrite rules and macros, delete all sample records, and evolve the workspace as
you would any other Rogue Agenda document.

## `accounts`

Account Desk is a broad relationship and sales-support workspace. It is the most
complete general demonstration of Agenda's single-copy information model: an
issue or activity can appear under an account, workflow stage, status report,
and time-based view without being duplicated.

It provides:

- Account and contact records, with fictional Northstar Labs and Harbor Books
  examples.
- A mutually exclusive opportunity pipeline: Prospect, Qualified, Proposal,
  and Customer.
- Calls, meetings, and follow-ups under an Activities hierarchy.
- Open, waiting, and resolved issue states.
- Numeric expense records with a summed Amount column.
- A sectioned status report divided into urgent and routine material.
- Filing rules that collect priority-one work into the status report and detect
  follow-up wording.
- `captureaccount` and `capturecall` prompt-driven macros.

The principal views are Accounts, Pipeline, Open Issues, Calls and Meetings,
Expenses, and Status Report. This preset is a good foundation for lightweight
CRM, client service, fundraising, vendor management, or case tracking.

## `study`

Study Deck is inspired by the idea of using Agenda items and notes as a learning
system. The item text is a question, its multiline note is the answer, `When` is
the next review date, and the numeric value is a visible learning-cycle number.

It provides:

- Computing, Languages, and History example decks.
- Mutually exclusive New, Learning, and Review stages.
- Due Review, New Cards, All Cards, Deck Browser, and Datebook views.
- A sectioned deck browser that shows the same cards by subject.
- Cycle values and relative review dates on the included cards.
- A `capturecard` macro that asks for a question and answer, creates the card,
  and writes the answer into its note.
- A `revealanswer` macro that presents the selected question and then opens its
  note. Run it from the Macro Manager while a card is selected.

Rogue Agenda does not silently grade a response. Move cards between learning
stages and set their next review dates according to the method you prefer. The
preset intentionally exposes those mechanics so they can be customized.

## `planner`

Activities Planner expands the small default document into a worked example of
personal planning. It demonstrates how users can grow Rogue Agenda gradually
instead of adopting a rigid methodology.

It provides:

- Next Actions with Calls, Meetings, and Errands beneath the activity hierarchy.
- Website Refresh and Studio Move example projects.
- Work, Home, and Personal areas.
- At Computer, On Phone, and Out and About contexts.
- Today, This Week, Next Actions, Projects, Calls and Meetings, Ideas, and
  Datebook views.
- Rules that promote priority-one and priority-two open work to Next Actions and
  recognize dated calls or meetings as scheduled activities.
- A recurring weekly meeting and a completed action to demonstrate lifecycle
  views.
- `quickcapture` and `captureidea` macros.

This is the best preset for learning how the ordinary default setup can be
extended while preserving free-form capture.

## `recipes`

Recipe Box treats each recipe as a single item with ingredients and method in
its note. Categories provide multiple browsing paths without maintaining
separate copies of a recipe.

It provides:

- Course categories for Breakfast, Main Dishes, Desserts, and Drinks.
- Cuisine, dietary, ingredient, Quick, and Favorites classifications.
- A numeric Servings value shown alongside each recipe.
- Recipe Box, Favorites, Main Dishes, Quick Meals, Vegetarian, and sectioned By
  Course views.
- Five small original recipes covering different courses and dietary tags.
- A rule that notices cooking-time wording in notes and files recipes as Quick.
- A `newrecipe` macro that creates a recipe and lays out an Ingredients, Method,
  and Notes template in the note editor.
- A `cookingnote` macro for capturing observations that do not yet belong to a
  formal recipe.

The ingredient categories are intentionally small. Add frequently used
ingredients as children of Ingredients to turn the preset into a deeper index.

## `rides`

Bicycle Log demonstrates numeric reporting and several overlapping category
dimensions. Ride distance is stored as the item's numeric value in kilometres.

It provides:

- Commute, Training, and Leisure ride types.
- Road, Touring, and City bicycles.
- Clear, Cloudy, and Rain conditions plus named Routes.
- Ride Log and Training totals, a Long Rides filter, and a sectioned By Bicycle
  report.
- Past and upcoming rides with original notes, route details, and distances.
- A separate Maintenance view with dated bicycle service tasks.
- Rules that recognize ride and maintenance wording.
- `logride` and `servicereminder` capture macros.

Use `F6` on a newly captured ride to record its numeric distance and date, then
assign bicycle, ride type, route, and weather with `F3`.

## `people`

People Manager is a lightweight development and team-information workspace. It
is meant for supportive planning and review preparation, not confidential HR
records or formal performance scoring.

It provides:

- People profiles organized by Product, Operations, and Community teams.
- Mutually exclusive Active, Candidate, and Alumni states.
- Separate records for goals, reviews, development actions, achievements, and
  hiring activity.
- People Directory, Upcoming Reviews, Goals, Development, Candidates, and
  Achievements views.
- A numeric Progress example on a dated goal.
- Filing rules for `Person:`, `Review:`, and `Goal:` capture conventions.
- `addperson` and `addgoal` prompt-driven macros.

The sample content is deliberately non-sensitive. Before using this preset for
real people, decide what information is appropriate to store and who can access
the `.agnd` file and its backups.

## Presets versus `--demo`

`--demo` adds only a handful of representative items to an otherwise default
document. It remains useful for a quick interface check:

```sh
rogue-agenda scratch.agnd --demo
```

Presets replace the default category and view definitions in a new document with
a coherent domain-specific workspace and include tailored macros, rules, and
sample records. Use a preset when you want to explore how a substantial Agenda
application is assembled.