How do I orient a new session?

Table of Contents

Part of the Compass recipes collection.

Question

How do I get a full cold-start briefing at the start of a new session?

Answer

Run compass bearings with no arguments:

./projects/ores.compass/compass.sh bearings

This prints five sections in order:

  1. What is ORE Studio? — one-line product identity + how to read the full doc.
  2. Where we are — current version, sprint, and all in-flight stories and tasks (equivalent to compass where).
  3. Last session — most recent journal entry so you know what was last being worked on (equivalent to compass journal where).
  4. Key recipes — the recipes tagged :bearings: with title, description, and the compass show <UUID> command to open each one.
  5. Memories — the project memories tagged :bearings: in the same format.

compass orient is an alias for compass bearings.

Script

compass bearings lives in projects/ores.compass/src/compass.py (cmd_bearings). Recipes and memories appear dynamically — tag any doc with :bearings: to include it; remove the tag to exclude it.

Tested by

Manual: run compass bearings and verify all five sections appear with correct content.

See also

Emacs 29.1 (Org mode 9.6.6)