Log State

Step 2: Read Current State

1. Acquire lock: flock ~/.research-log/.locks/{slug}.lock
2. Read ~/.research-log/{slug}.md
3. Parse the current ## State section
4. Note the current Session timestamp as the new Last session value

Step 3: Generate New State

From the current session context, generate:

• Session: current timestamp (YYYY-MM-DDTHH:MM)
• Last session: previous Session timestamp (from Step 2)
• Location: identify which Compass sub-goal the recent work relates to (read Compass section)
• Working on: summarize the main task from this session
• Current status: current status of that task (completed, in progress, blocked, etc.)
• Blocker: any blockers, or "None"
• Next step: the most logical next step
• Compass link: explain how the current work connects to the identified sub-goal

Keep each field to 1-2 sentences max. This is meant to be read in 2 minutes.

Step 4: Write State

1. Replace the ## State section in {slug}.md with the new State
   • Preserve everything before ## State (Compass) and after the State section (Decision Log)
   • The State section starts at ## State and ends at the next --- separator before ## Decision Log
2. Release lock

Step 5: Silent Completion

Do NOT produce any output to the user when called from a hook. When called manually, briefly confirm: "State updated for {slug}."